From 42e5b8b073c79af338fcbd0845cfc26df0a8b5c9 Mon Sep 17 00:00:00 2001
From: gyuhochoime <cjg1999@naver.com>
Date: Sat, 29 Aug 2026 13:17:53 +0900
Subject: [PATCH 1/6] =?UTF-8?q?MSG-489=20feat:=20[=EC=9B=B9]=20AI=20?=
 =?UTF-8?q?=EA=B2=BD=EB=A1=9C=EC=B6=94=EC=B2=9C=20=E2=80=94=20mentionedAre?=
 =?UTF-8?q?a=20=EC=9E=90=EB=8F=99=20=EC=9D=B4=EB=8F=99=C2=B71km=20?=
 =?UTF-8?q?=EA=B3=A0=EC=A0=95=C2=B72=EC=B0=A8=20=EC=9E=90=EB=8F=99=20?=
 =?UTF-8?q?=EC=9E=AC=EC=9A=94=EC=B2=AD=C2=B7=EC=B6=9C=EB=B0=9C=EC=A7=80=20?=
 =?UTF-8?q?=EC=9E=90=EB=8F=99=20=ED=8C=90=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../ai-route/api/use-route-recommend.ts       |  33 +-
 .../ai-route/model/ai-route-store.test.ts     |  46 +
 .../features/ai-route/model/ai-route-store.ts |  54 +-
 .../model/route-mentioned-area.test.ts        |  74 ++
 .../ai-route/model/route-mentioned-area.ts    |  61 ++
 .../ai-route/model/route-origin.test.ts       |  52 ++
 .../features/ai-route/model/route-origin.ts   |  32 +
 .../ai-route/model/route-request.test.ts      | 106 +++
 .../features/ai-route/model/route-request.ts  |  61 +-
 apps/web/src/pages/ai-route/AiRoutePage.tsx   | 124 +--
 .../ai-route/ai-route-panel.smoke.test.tsx    |  63 ++
 .../src/pages/ai-route/ui/RouteInputCard.tsx  |  15 +-
 .../src/pages/ai-route/ui/RouteToastHost.tsx  |  44 +
 .../ui/use-ai-route-auto-move.test.tsx        | 234 +++++
 .../ai-route/ui/use-ai-route-auto-move.ts     | 145 +++
 apps/web/src/shared/geolocation.test.ts       |  56 +-
 apps/web/src/shared/geolocation.ts            |  21 +-
 apps/web/src/test/geolocation.ts              |  32 +
 docs/STATUS.md                                |  13 +-
 docs/decisions/DECISIONS.md                   |   4 +
 docs/spec/MSG-489.md                          | 270 ++++++
 nose.baseline.json                            | 844 +++++++++++-------
 22 files changed, 1958 insertions(+), 426 deletions(-)
 create mode 100644 apps/web/src/features/ai-route/model/route-mentioned-area.test.ts
 create mode 100644 apps/web/src/features/ai-route/model/route-mentioned-area.ts
 create mode 100644 apps/web/src/features/ai-route/model/route-origin.test.ts
 create mode 100644 apps/web/src/features/ai-route/model/route-origin.ts
 create mode 100644 apps/web/src/pages/ai-route/ui/RouteToastHost.tsx
 create mode 100644 apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx
 create mode 100644 apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts
 create mode 100644 apps/web/src/test/geolocation.ts
 create mode 100644 docs/spec/MSG-489.md

diff --git a/apps/web/src/features/ai-route/api/use-route-recommend.ts b/apps/web/src/features/ai-route/api/use-route-recommend.ts
index 86c7a4e7..b575d4e1 100644
--- a/apps/web/src/features/ai-route/api/use-route-recommend.ts
+++ b/apps/web/src/features/ai-route/api/use-route-recommend.ts
@@ -5,6 +5,10 @@ import type { RouteRecommendRequestDto } from "@/shared/api/generated";
 import { unwrapEnvelope } from "@/shared/api/envelope";
 import { useAiRouteStore } from "../model/ai-route-store";
 import { routeErrorNotice } from "../model/route-error";
+import {
+  type RouteAutoMove,
+  resolveAutoMove,
+} from "../model/route-mentioned-area";
 
 /**
  * AI 경로 추천 요청 (MSG-488 §4-3) — `POST /api/routes/recommend`를 1회 쏜다.
@@ -14,7 +18,9 @@ import { routeErrorNotice } from "../model/route-error";
  * mutation은 TanStack 기본 `retry: 0`이라 14429(10초 제한)가 자동 재시도로 악화되지 않는다.
  * 콜백은 훅 레벨 옵션으로 받는다 — mutate per-call 콜백은 관찰자 언마운트 시 유실된다(MSG-325 선례).
  *
- * [MSG-489 확장점] 2차 자동 재요청 트리거가 이 훅에 얹힌다.
+ * MSG-489: 응답에 `mentionedArea`가 실리면 **결과를 게시하지 않고**(D5) 2차 요청을 예약한다.
+ * 2차 인스턴스(`secondary: true`)는 예약 플래그를 보존한 채 로딩만 이어 간다 —
+ * `startRequest`를 쓰면 `autoMoved`가 초기화돼 2차 응답에서 또 이동하는 무한 루프가 된다.
  */
 // 생성 팩토리는 mutationFn을 항상 채운다 — UseMutationOptions 타입만 optional이라 !로 좁힌다
 const recommendFn = recommendMutation().mutationFn!;
@@ -22,8 +28,14 @@ const recommendFn = recommendMutation().mutationFn!;
 export const useRouteRecommend = (callbacks?: {
   /** 401(2403) — 패널은 입력을 유지한 채 입력 대기로 돌아가고 로그인 모달만 연다 (§1-3) */
   onLoginRequired?: () => void;
+  /** 언급 지역 신호 도착 — 지도 이동·2차 발사는 뷰-레이어 오케스트레이터가 맡는다 (D2·D4) */
+  onAutoMove?: (move: RouteAutoMove) => void;
+  /** 2차 자동 재요청 인스턴스인가 — 요청 시작 처리가 갈린다 */
+  secondary?: boolean;
 }) => {
   const startRequest = useAiRouteStore((s) => s.startRequest);
+  const startSecondaryRequest = useAiRouteStore((s) => s.startSecondaryRequest);
+  const markSecondarySent = useAiRouteStore((s) => s.markSecondarySent);
   const succeed = useAiRouteStore((s) => s.succeed);
   const fail = useAiRouteStore((s) => s.fail);
 
@@ -31,10 +43,25 @@ export const useRouteRecommend = (callbacks?: {
     mutationFn: (body: RouteRecommendRequestDto, context) =>
       recommendFn({ body }, context),
     // 이전 결과·선택은 요청 시작 시점에 비운다 — 로딩 화면에 잔상이 남지 않는다 (L7)
-    onMutate: () => startRequest(),
+    onMutate: (body) => {
+      const originSent = body.origin !== undefined;
+      if (callbacks?.secondary) markSecondarySent(originSent);
+      else startRequest(originSent);
+    },
     onSuccess: (response) => {
       const data = unwrapEnvelope(response);
-      succeed(data.points, data.notice);
+      // 이동 여부는 스토어 현재값으로 판정한다 — 2차 응답은 alreadyMoved라 항상 null (L9·L17)
+      const move = resolveAutoMove({
+        mentionedArea: data.mentionedArea,
+        alreadyMoved: useAiRouteStore.getState().autoMoved,
+      });
+      if (move === null) {
+        succeed(data.points, data.notice);
+        return;
+      }
+      // 1차 결과는 스토어에도 오버레이에도 게시하지 않고 로딩을 유지한다 (D5)
+      startSecondaryRequest(move.areaName);
+      callbacks?.onAutoMove?.(move);
     },
     onError: (error) => {
       const notice = routeErrorNotice(error);
diff --git a/apps/web/src/features/ai-route/model/ai-route-store.test.ts b/apps/web/src/features/ai-route/model/ai-route-store.test.ts
index 011860ad..45015a4b 100644
--- a/apps/web/src/features/ai-route/model/ai-route-store.test.ts
+++ b/apps/web/src/features/ai-route/model/ai-route-store.test.ts
@@ -113,3 +113,49 @@ describe("useAiRouteStore — 요청·결과 상태 전이 (L7)", () => {
     expect(store().selectedOrder).toBeNull();
   });
 });
+
+describe("2차 자동 재요청 사이클 (L14·L15)", () => {
+  beforeEach(() => {
+    useAiRouteStore.setState(useAiRouteStore.getInitialState(), true);
+  });
+
+  it("2차 요청을 시작하면 로딩을 유지한 채 1차 결과를 게시하지 않고 자동 이동을 기록한다 (L14)", () => {
+    store().startRequest();
+
+    store().startSecondaryRequest("부산 서면");
+
+    expect(store().status).toBe("loading");
+    expect(store().points).toHaveLength(0);
+    expect(store().autoMoved).toBe(true);
+    expect(store().movedAreaName).toBe("부산 서면");
+    expect(store().secondaryPending).toBe(true);
+  });
+
+  it("새 1차 요청은 자동 이동·출발지·이동 지역명을 초기화한다 (L15)", () => {
+    store().startRequest(true);
+    store().startSecondaryRequest("부산 서면");
+    store().markSecondarySent(true);
+
+    store().startRequest();
+
+    expect(store().autoMoved).toBe(false);
+    expect(store().originSent).toBe(false);
+    expect(store().movedAreaName).toBeNull();
+    expect(store().secondaryPending).toBe(false);
+  });
+
+  it("요청 시작 시각을 기록한다 — 2차 발사가 서버 10초 창을 계산하는 기준 (Q2 안 B)", () => {
+    const before = Date.now();
+
+    store().startRequest();
+
+    expect(store().requestedAt).not.toBeNull();
+    expect(store().requestedAt!).toBeGreaterThanOrEqual(before);
+  });
+
+  it("출발지를 실어 보낸 요청은 originSent를 켠다 — 결과 화면 버튼 문구의 근거 (L13 배선)", () => {
+    store().startRequest(true);
+
+    expect(store().originSent).toBe(true);
+  });
+});
diff --git a/apps/web/src/features/ai-route/model/ai-route-store.ts b/apps/web/src/features/ai-route/model/ai-route-store.ts
index 90a02e00..c4735a51 100644
--- a/apps/web/src/features/ai-route/model/ai-route-store.ts
+++ b/apps/web/src/features/ai-route/model/ai-route-store.ts
@@ -7,7 +7,8 @@ import type { RouteErrorNotice } from "./route-error";
  * 플랫폼 중립 — 지도 SDK·라우터·웹 API를 import하지 않는다(RN 경계).
  * 스토어가 정본이라 다른 섹션에 갔다 돌아와도 입력·결과·지도 표시가 복원된다 (S11).
  *
- * [MSG-489 확장점] 출발지(origin)·mentionedArea·2차 자동 재요청 플래그가 이 스토어에 얹힌다.
+ * MSG-489가 출발지·자동 이동·2차 자동 재요청 플래그를 얹었다 — 전부 **요청 사이클** 단위라
+ * 새 1차 요청이 한꺼번에 초기화한다 (L15).
  */
 export type AiRouteStatus = "idle" | "loading" | "result" | "error";
 
@@ -23,14 +24,40 @@ interface AiRouteState {
   errorNotice: RouteErrorNotice | null;
   /** 14503(기능 꺼짐) — 세션 동안 제출을 막는다 (§1-4) */
   featureDisabled: boolean;
+  /** 이번 사이클에서 자동 이동을 이미 했는가 — 2차 응답의 mentionedArea를 무시한다 (L9·L14) */
+  autoMoved: boolean;
+  /** 직전 요청이 origin을 실어 보냈는가 — 결과 화면 버튼 문구의 근거 (L13) */
+  originSent: boolean;
+  /** 자동 이동한 지역명 — 안내 토스트가 읽는다. 이동이 없었으면 null (D3) */
+  movedAreaName: string | null;
+  /** 2차 요청이 예약됐지만 아직 발사되지 않았는가 — 섹션 이탈·재진입에도 예약이 살아남는다 */
+  secondaryPending: boolean;
+  /** 1차 요청을 쏜 시각(ms) — 2차 발사가 서버 10초 창을 계산하는 기준 (Q2 안 B) */
+  requestedAt: number | null;
   setText: (text: string) => void;
-  startRequest: () => void;
+  /** 1차 요청 시작 — 사이클 플래그를 전부 초기화한다 (L15) */
+  startRequest: (originSent?: boolean) => void;
+  /** 자동 이동 확정 + 2차 요청 예약 — 1차 결과는 게시하지 않고 로딩을 유지한다 (D5·L14) */
+  startSecondaryRequest: (areaName: string) => void;
+  /** 예약된 2차를 실제로 발사한 시점 — 재발사를 막고 출발지 재판정 결과를 반영한다 */
+  markSecondarySent: (originSent: boolean) => void;
   succeed: (points: RoutePointDto[], notice: string | null) => void;
   fail: (notice: RouteErrorNotice) => void;
   selectOrder: (order: number | null) => void;
   reset: () => void;
 }
 
+/** 요청 사이클 플래그 초기값 — startRequest와 reset이 공유한다 (L15) */
+const clearedCycle = (): Pick<
+  AiRouteState,
+  "autoMoved" | "originSent" | "movedAreaName" | "secondaryPending"
+> => ({
+  autoMoved: false,
+  originSent: false,
+  movedAreaName: null,
+  secondaryPending: false,
+});
+
 /** 결과·선택·에러가 비워진 상태 — 새 요청 시작과 reset이 공유한다 (매번 새 배열) */
 const cleared = (): Pick<
   AiRouteState,
@@ -46,10 +73,28 @@ const cleared = (): Pick<
 export const useAiRouteStore = create<AiRouteState>((set) => ({
   text: "",
   featureDisabled: false,
+  requestedAt: null,
   ...cleared(),
+  ...clearedCycle(),
   setText: (text) => set({ text }),
   // 새 요청은 이전 결과를 **먼저** 비운다 — 잔상(이전 카드·지도 표시)이 로딩 중에 남지 않는다
-  startRequest: () => set({ ...cleared(), status: "loading" }),
+  startRequest: (originSent = false) =>
+    set({
+      ...cleared(),
+      ...clearedCycle(),
+      status: "loading",
+      originSent,
+      requestedAt: Date.now(),
+    }),
+  startSecondaryRequest: (areaName) =>
+    set({
+      status: "loading",
+      autoMoved: true,
+      movedAreaName: areaName,
+      secondaryPending: true,
+    }),
+  markSecondarySent: (originSent) =>
+    set({ secondaryPending: false, originSent }),
   succeed: (points, notice) =>
     set({ status: "result", points, notice, errorNotice: null }),
   fail: (notice) =>
@@ -61,5 +106,6 @@ export const useAiRouteStore = create<AiRouteState>((set) => ({
     })),
   selectOrder: (order) => set({ selectedOrder: order }),
   // 레일 재클릭 2단의 초기화 — 입력까지 비운다. featureDisabled는 세션 플래그라 남긴다
-  reset: () => set({ ...cleared(), text: "" }),
+  reset: () =>
+    set({ ...cleared(), ...clearedCycle(), text: "", requestedAt: null }),
 }));
diff --git a/apps/web/src/features/ai-route/model/route-mentioned-area.test.ts b/apps/web/src/features/ai-route/model/route-mentioned-area.test.ts
new file mode 100644
index 00000000..b1d78779
--- /dev/null
+++ b/apps/web/src/features/ai-route/model/route-mentioned-area.test.ts
@@ -0,0 +1,74 @@
+import { describe, expect, it } from "vitest";
+import { MAP_SCALE_1KM_ZOOM } from "@/features/map-home/model/map-scale";
+import type { MentionedAreaDto } from "@/shared/api/generated";
+import {
+  MOVED_TOAST_DESCRIPTION,
+  movedToastTitle,
+  resolveAutoMove,
+} from "./route-mentioned-area";
+
+const area = (kind: string): MentionedAreaDto => ({
+  name: "부산 서면",
+  centerLat: 35.1579,
+  centerLng: 129.0594,
+  minLat: 35.1521,
+  minLng: 129.0537,
+  maxLat: 35.1662,
+  maxLng: 129.0712,
+  kind,
+});
+
+describe("resolveAutoMove — 언급 지역 자동 이동 판정 (L6~L9)", () => {
+  it("MOVE 신호는 지역 중심과 1km 축척 줌·지역명을 낸다 (L6)", () => {
+    expect(
+      resolveAutoMove({ mentionedArea: area("MOVE"), alreadyMoved: false }),
+    ).toEqual({
+      center: { lat: 35.1579, lng: 129.0594 },
+      zoom: MAP_SCALE_1KM_ZOOM,
+      areaName: "부산 서면",
+      kind: "MOVE",
+    });
+  });
+
+  it("ZOOM_OUT 신호도 MOVE와 같은 이동으로 처리한다 (L7)", () => {
+    const moved = resolveAutoMove({
+      mentionedArea: area("MOVE"),
+      alreadyMoved: false,
+    });
+    const zoomedOut = resolveAutoMove({
+      mentionedArea: area("ZOOM_OUT"),
+      alreadyMoved: false,
+    });
+
+    expect({ ...zoomedOut, kind: "MOVE" }).toEqual(moved);
+    expect(zoomedOut?.center).toEqual(moved?.center);
+    expect(zoomedOut?.zoom).toBe(moved?.zoom);
+  });
+
+  it("언급 지역 신호가 없으면 이동하지 않는다 (L8)", () => {
+    expect(
+      resolveAutoMove({ mentionedArea: null, alreadyMoved: false }),
+    ).toBeNull();
+  });
+
+  it("이미 자동 이동한 사이클이면 신호가 또 와도 이동하지 않는다 — 무한 루프 차단 (L9)", () => {
+    expect(
+      resolveAutoMove({ mentionedArea: area("MOVE"), alreadyMoved: true }),
+    ).toBeNull();
+  });
+});
+
+describe("토스트 문구 파생 (L10)", () => {
+  it("제목은 지역명에 조사를 붙이고, 본문은 1km 기준을 알린다 — '2km'는 쓰지 않는다 (L10)", () => {
+    expect(movedToastTitle("부산 서면")).toBe("부산 서면으로 이동했어요");
+    expect(MOVED_TOAST_DESCRIPTION).toBe(
+      "지도 범위 약 1km 기준으로 동선을 짜요",
+    );
+    expect(MOVED_TOAST_DESCRIPTION).not.toContain("2km");
+  });
+
+  it("받침 없는 지역명은 '로', ㄹ 받침도 '로'를 쓴다 (L10, 조사)", () => {
+    expect(movedToastTitle("해운대")).toBe("해운대로 이동했어요");
+    expect(movedToastTitle("물만골")).toBe("물만골로 이동했어요");
+  });
+});
diff --git a/apps/web/src/features/ai-route/model/route-mentioned-area.ts b/apps/web/src/features/ai-route/model/route-mentioned-area.ts
new file mode 100644
index 00000000..5e20d944
--- /dev/null
+++ b/apps/web/src/features/ai-route/model/route-mentioned-area.ts
@@ -0,0 +1,61 @@
+import type { LatLng } from "@/entities/cell";
+import { MAP_SCALE_1KM_ZOOM } from "@/features/map-home/model/map-scale";
+import type { MentionedAreaDto } from "@/shared/api/generated";
+
+/**
+ * 언급 지역 자동 이동 판정 + 안내 토스트 문구 (MSG-489 L6~L10).
+ * 순수 함수 — 지도 SDK를 모른다(RN 재사용 대상). 명령 실행은 뷰-레이어 훅이 한다.
+ *
+ * `kind`는 생성 타입상 유니언이 아니라 raw `string`이라 분기하지 않는다(A3):
+ * MOVE·ZOOM_OUT을 같은 처리로 통일한 이상(D6), 서버가 신호를 보냈다는 사실 자체가 판정 근거다.
+ */
+export interface RouteAutoMove {
+  center: LatLng;
+  /** 축척 1km 단 고정 (D2) — 지역 외접 사각형 fitBounds는 채택하지 않는다 (D6) */
+  zoom: number;
+  areaName: string;
+  /** 서버 신호 종류 — 기록만 하고 분기하지 않는다 (A3) */
+  kind: string;
+}
+
+export const resolveAutoMove = ({
+  mentionedArea,
+  alreadyMoved,
+}: {
+  mentionedArea: MentionedAreaDto | null;
+  /** 이번 요청 사이클에서 이미 자동 이동했는가 — 2차 응답 무시 = 무한 루프 차단 (D4) */
+  alreadyMoved: boolean;
+}): RouteAutoMove | null => {
+  if (mentionedArea === null || alreadyMoved) return null;
+  return {
+    center: { lat: mentionedArea.centerLat, lng: mentionedArea.centerLng },
+    zoom: MAP_SCALE_1KM_ZOOM,
+    areaName: mentionedArea.name,
+    kind: mentionedArea.kind,
+  };
+};
+
+/** Figma 15675:3267의 "약 2km"는 축척 고정 결정에 따라 1km로 정정해 구현한다 (D7) */
+export const MOVED_TOAST_DESCRIPTION = "지도 범위 약 1km 기준으로 동선을 짜요";
+
+const HANGUL_BASE = 0xac00;
+const HANGUL_LAST = 0xd7a3;
+/** 종성 ㄹ의 인덱스 — 받침이 ㄹ이면 "으로"가 아니라 "로"를 쓴다 */
+const JONGSEONG_RIEUL = 8;
+
+/**
+ * 조사 "(으)로" 확정 — 받침 없음·ㄹ 받침은 "로", 나머지 받침은 "으로".
+ * 한글 음절이 아닌 끝 글자는 받침 없음으로 본다(지역명은 한글이 정본이라 폴백 경로다).
+ */
+const euroJosa = (name: string): string => {
+  const code = name.charCodeAt(name.length - 1);
+  if (Number.isNaN(code) || code < HANGUL_BASE || code > HANGUL_LAST) {
+    return "로";
+  }
+  const jongseong = (code - HANGUL_BASE) % 28;
+  return jongseong === 0 || jongseong === JONGSEONG_RIEUL ? "로" : "으로";
+};
+
+/** 이동 안내 토스트 제목 — "{지역명}(으)로 이동했어요" (D3) */
+export const movedToastTitle = (areaName: string): string =>
+  `${areaName}${euroJosa(areaName)} 이동했어요`;
diff --git a/apps/web/src/features/ai-route/model/route-origin.test.ts b/apps/web/src/features/ai-route/model/route-origin.test.ts
new file mode 100644
index 00000000..8cf40594
--- /dev/null
+++ b/apps/web/src/features/ai-route/model/route-origin.test.ts
@@ -0,0 +1,52 @@
+import { describe, expect, it } from "vitest";
+import type { Bounds } from "@/entities/cell";
+import { resolveRouteOrigin } from "./route-origin";
+
+/** 부산 서면 일대 — MVP 지역 (route-points 픽스처와 같은 기준) */
+const BOUNDS: Bounds = {
+  sw: { lat: 35.1521, lng: 129.0537 },
+  ne: { lat: 35.1662, lng: 129.0712 },
+};
+
+const INSIDE = { lat: 35.1579, lng: 129.0594 };
+
+describe("resolveRouteOrigin — 출발지 자동 판정 (L1~L5)", () => {
+  it("현위치가 뷰포트 안이면 그 좌표를 출발지로 싣는다 (L1)", () => {
+    expect(resolveRouteOrigin({ coords: INSIDE, bounds: BOUNDS })).toEqual({
+      lat: 35.1579,
+      lng: 129.0594,
+    });
+  });
+
+  it("현위치가 뷰포트 밖이면 출발지를 싣지 않는다 (L2, 경도·위도 각각)", () => {
+    expect(
+      resolveRouteOrigin({
+        coords: { lat: 35.1579, lng: 129.1204 },
+        bounds: BOUNDS,
+      }),
+    ).toBeNull();
+    expect(
+      resolveRouteOrigin({
+        coords: { lat: 35.2204, lng: 129.0594 },
+        bounds: BOUNDS,
+      }),
+    ).toBeNull();
+  });
+
+  it("현위치를 못 얻었으면(권한 거부·미확보) 출발지를 싣지 않는다 (L3)", () => {
+    expect(resolveRouteOrigin({ coords: null, bounds: BOUNDS })).toBeNull();
+  });
+
+  it("지도가 준비되기 전(bounds null)이면 출발지를 싣지 않는다 (L4)", () => {
+    expect(resolveRouteOrigin({ coords: INSIDE, bounds: null })).toBeNull();
+  });
+
+  it("경계선 위 좌표는 뷰포트 안으로 판정한다 (L5, 포함 경계)", () => {
+    expect(resolveRouteOrigin({ coords: BOUNDS.sw, bounds: BOUNDS })).toEqual(
+      BOUNDS.sw,
+    );
+    expect(resolveRouteOrigin({ coords: BOUNDS.ne, bounds: BOUNDS })).toEqual(
+      BOUNDS.ne,
+    );
+  });
+});
diff --git a/apps/web/src/features/ai-route/model/route-origin.ts b/apps/web/src/features/ai-route/model/route-origin.ts
new file mode 100644
index 00000000..b3ea4b0b
--- /dev/null
+++ b/apps/web/src/features/ai-route/model/route-origin.ts
@@ -0,0 +1,32 @@
+import type { Bounds, LatLng } from "@/entities/cell";
+import type { OriginDto } from "@/shared/api/generated";
+
+/**
+ * 출발지 자동 판정 (MSG-489 L1~L5).
+ * 순수 함수 — 지도 SDK도 `navigator`도 모른다(RN 재사용 대상). 현위치 조회는
+ * `shared/geolocation` 어댑터가, 뷰포트는 `viewport-store`가 공급한다.
+ *
+ * 토글이 아니다: 현위치가 지금 보이는 지도 범위 안에 있을 때만 출발지를 싣고,
+ * 밖이거나 권한 거부·미확보면 조용히 생략한다(기능은 그대로 동작한다 — D8).
+ */
+
+/** 뷰포트 포함 판정 — 경계선 위는 안으로 본다 (L5). 2차 발사의 새 bounds 확인도 이 판정을 쓴다 */
+export const isWithinBounds = (coords: LatLng, { sw, ne }: Bounds): boolean =>
+  coords.lat >= sw.lat &&
+  coords.lat <= ne.lat &&
+  coords.lng >= sw.lng &&
+  coords.lng <= ne.lng;
+
+export const resolveRouteOrigin = ({
+  coords,
+  bounds,
+}: {
+  /** 현위치 — 권한 거부·미확보·조회 전은 null */
+  coords: LatLng | null;
+  /** 지금 보이는 지도 범위 — 지도 준비 전은 null */
+  bounds: Bounds | null;
+}): OriginDto | null => {
+  if (coords === null || bounds === null) return null;
+  if (!isWithinBounds(coords, bounds)) return null;
+  return { lat: coords.lat, lng: coords.lng };
+};
diff --git a/apps/web/src/features/ai-route/model/route-request.test.ts b/apps/web/src/features/ai-route/model/route-request.test.ts
index b35f0587..2321b354 100644
--- a/apps/web/src/features/ai-route/model/route-request.test.ts
+++ b/apps/web/src/features/ai-route/model/route-request.test.ts
@@ -2,8 +2,12 @@ import { describe, expect, it } from "vitest";
 import type { Bounds } from "@/entities/cell";
 import {
   MAX_ROUTE_TEXT_LENGTH,
+  SECONDARY_MIN_INTERVAL_MS,
   buildRecommendBody,
   canSubmit,
+  needsSpanNormalize,
+  secondaryDelayMs,
+  submitLabel,
   toViewportDto,
 } from "./route-request";
 
@@ -92,3 +96,105 @@ describe("canSubmit — 제출 가능 판정 (L8)", () => {
     ).toBeNull();
   });
 });
+
+describe("buildRecommendBody — 출발지 병합 (L11)", () => {
+  it("출발지를 주면 body에 origin이 실린다 (L11)", () => {
+    expect(
+      buildRecommendBody({
+        text: "서면 동선",
+        bounds: BOUNDS,
+        origin: { lat: 35.1579, lng: 129.0594 },
+      }),
+    ).toEqual({
+      text: "서면 동선",
+      viewport: toViewportDto(BOUNDS),
+      origin: { lat: 35.1579, lng: 129.0594 },
+    });
+  });
+
+  it("출발지를 주지 않으면 origin 키 자체가 없다 (L11)", () => {
+    const body = buildRecommendBody({ text: "서면 동선", bounds: BOUNDS });
+
+    expect(body).not.toHaveProperty("origin");
+    expect(
+      buildRecommendBody({ text: "서면 동선", bounds: BOUNDS, origin: null }),
+    ).not.toHaveProperty("origin");
+  });
+});
+
+describe("needsSpanNormalize — 0.5도 초과 뷰포트 예방 판정 (L12)", () => {
+  it("위·경도 어느 한 변이라도 0.5도를 넘으면 정규화가 필요하다 (L12)", () => {
+    expect(
+      needsSpanNormalize({
+        sw: { lat: 35.0, lng: 129.0 },
+        ne: { lat: 35.6, lng: 129.1 },
+      }),
+    ).toBe(true);
+    expect(
+      needsSpanNormalize({
+        sw: { lat: 35.0, lng: 129.0 },
+        ne: { lat: 35.1, lng: 129.6 },
+      }),
+    ).toBe(true);
+  });
+
+  it("두 변 모두 0.5도 이하면 정규화가 필요 없다 (L12, 경계 포함)", () => {
+    expect(needsSpanNormalize(BOUNDS)).toBe(false);
+    expect(
+      needsSpanNormalize({
+        sw: { lat: 35.0, lng: 129.0 },
+        ne: { lat: 35.5, lng: 129.5 },
+      }),
+    ).toBe(false);
+  });
+
+  it("지도가 준비되기 전(bounds null)에는 정규화를 시도하지 않는다 (L12)", () => {
+    expect(needsSpanNormalize(null)).toBe(false);
+  });
+});
+
+describe("submitLabel — 제출 버튼 문구 (L13)", () => {
+  it("최초 입력 대기는 '동선 짜기'다 (L13)", () => {
+    expect(submitLabel({ status: "idle", originSent: false })).toBe(
+      "동선 짜기",
+    );
+    expect(submitLabel({ status: "idle", originSent: true })).toBe("동선 짜기");
+  });
+
+  it("출발지를 실어 보낸 결과 화면은 '현재 위치에서 다시 짜기'다 (L13)", () => {
+    expect(submitLabel({ status: "result", originSent: true })).toBe(
+      "현재 위치에서 다시 짜기",
+    );
+  });
+
+  it("출발지 없이 보낸 결과·실패 화면은 '다시 짜기'다 (L13)", () => {
+    expect(submitLabel({ status: "result", originSent: false })).toBe(
+      "다시 짜기",
+    );
+    expect(submitLabel({ status: "error", originSent: false })).toBe(
+      "다시 짜기",
+    );
+  });
+});
+
+describe("secondaryDelayMs — 2차 자동 재요청 대기 (Q2 안 B)", () => {
+  it("1차 요청 시작으로부터 10초 창이 남아 있으면 남은 만큼 기다린다", () => {
+    expect(secondaryDelayMs({ requestedAt: 1_000, now: 4_000 })).toBe(
+      SECONDARY_MIN_INTERVAL_MS - 3_000,
+    );
+  });
+
+  it("창이 이미 지났으면 기다리지 않는다 (경계 — 음수 바닥)", () => {
+    expect(
+      secondaryDelayMs({
+        requestedAt: 1_000,
+        now: 1_000 + SECONDARY_MIN_INTERVAL_MS,
+      }),
+    ).toBe(0);
+    expect(secondaryDelayMs({ requestedAt: 1_000, now: 60_000 })).toBe(0);
+  });
+
+  it("1차 요청 시각을 모르면 기다리지 않는다", () => {
+    expect(secondaryDelayMs({ requestedAt: null, now: 4_000 })).toBe(0);
+  });
+});
diff --git a/apps/web/src/features/ai-route/model/route-request.ts b/apps/web/src/features/ai-route/model/route-request.ts
index d5db21e1..ca952007 100644
--- a/apps/web/src/features/ai-route/model/route-request.ts
+++ b/apps/web/src/features/ai-route/model/route-request.ts
@@ -1,5 +1,6 @@
 import type { Bounds } from "@/entities/cell";
 import type {
+  OriginDto,
   RouteRecommendRequestDto,
   ViewportDto,
 } from "@/shared/api/generated";
@@ -9,7 +10,7 @@ import type { AiRouteStatus } from "./ai-route-store";
  * 추천 요청 조립·제출 판정 (MSG-488 L8·L9).
  * 순수 함수 — 지도 SDK를 모르고 뷰포트를 플랫폼 중립 `Bounds`로 받는다(RN 경계).
  *
- * [MSG-489 확장점] `origin` 병합과 2차 재요청 뷰포트 규칙이 여기에 얹힌다.
+ * MSG-489가 출발지 병합(L11)·0.5도 예방 판정(L12)·버튼 문구(L13)·2차 대기(Q2)를 얹었다.
  */
 
 /** 서버 계약 상한 (RouteRecommendRequestDto.text: trim 후 1~500자) */
@@ -30,13 +31,69 @@ export const toViewportDto = ({ sw, ne }: Bounds): ViewportDto => ({
 export const buildRecommendBody = ({
   text,
   bounds,
+  origin,
 }: {
   text: string;
   bounds: Bounds | null;
+  /** 출발지 — 판정은 route-origin 소유. 없으면 키 자체를 싣지 않는다 (L11) */
+  origin?: OriginDto | null;
 }): RouteRecommendRequestDto | null => {
   const trimmed = text.trim();
   if (bounds === null || trimmed.length === 0) return null;
-  return { text: trimmed, viewport: toViewportDto(bounds) };
+  const body: RouteRecommendRequestDto = {
+    text: trimmed,
+    viewport: toViewportDto(bounds),
+  };
+  return origin ? { ...body, origin } : body;
+};
+
+/** 서버 뷰포트 상한 (14401) — 위·경도 한 변이 이 값을 넘으면 요청이 거절된다 */
+const MAX_VIEWPORT_SPAN_DEG = 0.5;
+
+/**
+ * 요청 전 축척 정규화가 필요한가 (L12, A2).
+ * 참이면 호출부가 1km 단으로 줌을 맞추고 새 뷰포트가 반영된 뒤 보낸다 —
+ * bounds를 잘라 보내지 않는다(사용자가 보는 화면과 요청 범위를 어긋나게 두지 않는다).
+ */
+export const needsSpanNormalize = (bounds: Bounds | null): boolean => {
+  if (bounds === null) return false;
+  return (
+    bounds.ne.lat - bounds.sw.lat > MAX_VIEWPORT_SPAN_DEG ||
+    bounds.ne.lng - bounds.sw.lng > MAX_VIEWPORT_SPAN_DEG
+  );
+};
+
+/** 제출 버튼 문구 (L13·D9) — 출발지를 실어 보낸 결과 화면만 "현재 위치에서" 접두가 붙는다 */
+export const submitLabel = ({
+  status,
+  originSent,
+}: {
+  status: AiRouteStatus;
+  /** 직전 요청이 origin을 실어 보냈는가 */
+  originSent: boolean;
+}): string => {
+  if (status === "idle") return "동선 짜기";
+  return originSent ? "현재 위치에서 다시 짜기" : "다시 짜기";
+};
+
+/**
+ * 2차 자동 재요청 대기 시간 (Q2 안 B).
+ * 서버 재요청 제한(14429)은 **요청 시작 기준 10초 창**이고 자동 재요청도 예외가 아니다
+ * (2026-08-28 실측: 1차 응답 직후 재호출 = 14429, 1차 시작 +11s = 200).
+ * 여유 500ms를 얹어 창을 확실히 넘긴 뒤 발사한다.
+ */
+export const SECONDARY_MIN_INTERVAL_MS = 10_500;
+
+export const secondaryDelayMs = ({
+  requestedAt,
+  now,
+}: {
+  /** 1차 요청을 쏜 시각 — 모르면 기다리지 않는다 */
+  requestedAt: number | null;
+  now: number;
+}): number => {
+  if (requestedAt === null) return 0;
+  return Math.max(0, requestedAt + SECONDARY_MIN_INTERVAL_MS - now);
 };
 
 /**
diff --git a/apps/web/src/pages/ai-route/AiRoutePage.tsx b/apps/web/src/pages/ai-route/AiRoutePage.tsx
index 03fe4a09..d8871cd7 100644
--- a/apps/web/src/pages/ai-route/AiRoutePage.tsx
+++ b/apps/web/src/pages/ai-route/AiRoutePage.tsx
@@ -1,10 +1,9 @@
 import { useCallback, useMemo } from "react";
-import { useRouteRecommend } from "@/features/ai-route/api/use-route-recommend";
 import { useAiRouteStore } from "@/features/ai-route/model/ai-route-store";
 import { partialBannerText } from "@/features/ai-route/model/route-point-view";
 import {
-  buildRecommendBody,
   canSubmit,
+  submitLabel,
 } from "@/features/ai-route/model/route-request";
 import { useLoginModalStore } from "@/features/auth/model/login-modal-store";
 import { useOccupiedGridsQuery } from "@/features/map-home/model/use-occupied-grids-query";
@@ -21,6 +20,8 @@ import { RoutePartialBanner } from "./ui/RoutePartialBanner";
 import { RouteResultHeader } from "./ui/RouteResultHeader";
 import { RouteResultList } from "./ui/RouteResultList";
 import { RouteSuggestionChips } from "./ui/RouteSuggestionChips";
+import { RouteToastHost } from "./ui/RouteToastHost";
+import { useAiRouteAutoMove } from "./ui/use-ai-route-auto-move";
 import { useAiRouteOverlayPublish } from "./ui/use-ai-route-overlay-publish";
 
 /**
@@ -48,6 +49,7 @@ export const AiRoutePage = () => {
   const selectedOrder = useAiRouteStore((s) => s.selectedOrder);
   const errorNotice = useAiRouteStore((s) => s.errorNotice);
   const featureDisabled = useAiRouteStore((s) => s.featureDisabled);
+  const originSent = useAiRouteStore((s) => s.originSent);
   const setText = useAiRouteStore((s) => s.setText);
   const selectOrder = useAiRouteStore((s) => s.selectOrder);
 
@@ -61,13 +63,10 @@ export const AiRoutePage = () => {
     [grids],
   );
 
-  const { mutate } = useRouteRecommend({ onLoginRequired: openLoginModal });
-  const submit = useCallback(() => {
-    // 지도 준비 전(bounds null)이거나 빈 문장이면 요청을 만들지 않는다 (L9)
-    const body = buildRecommendBody({ text, bounds });
-    if (body === null) return;
-    mutate(body);
-  }, [text, bounds, mutate]);
+  // 제출·출발지 자동 판정·지역 자동 이동·2차 재요청은 자동 동작 훅이 소유한다 (MSG-489)
+  const { submit, originActive } = useAiRouteAutoMove({
+    onLoginRequired: openLoginModal,
+  });
 
   // 카드 클릭 — 선택 강조 + 그 지점으로 지도 이동(줌은 그대로). fitBounds·zoomTo는 489 몫
   const selectFromCard = useCallback(
@@ -91,62 +90,65 @@ export const AiRoutePage = () => {
     onWaypointSelect: selectFromMarker,
   });
 
-  // [MSG-489 확장점] mentionedArea 자동 이동 훅을 여기서 마운트한다.
-
   const loading = status === "loading";
   const bannerText = partialBannerText(notice, points.length);
 
   return (
-    <aside className="pointer-events-auto absolute inset-y-0 left-0 z-10 flex w-97 shrink-0 flex-col bg-background shadow-raised">
-      <h1 className="sr-only">AI 경로추천</h1>
-      <div className="flex min-h-0 flex-1 flex-col gap-md overflow-y-auto p-5">
-        {status === "idle" && <RouteEmptyState />}
-        {status === "error" && errorNotice && (
-          <RouteErrorNotice notice={errorNotice} onRetry={submit} />
-        )}
-        {loading && (
-          <>
-            <RouteResultHeader loading count={0} />
-            <RouteLoadingList />
-          </>
-        )}
-        {status === "result" && (
-          <>
-            <RouteResultHeader loading={false} count={points.length} />
-            {bannerText && <RoutePartialBanner text={bannerText} />}
-            {points.length > 0 && (
-              <RouteResultList
-                points={points}
-                selectedOrder={selectedOrder}
-                onSelect={selectFromCard}
-              />
-            )}
-          </>
-        )}
-        {/* 각주는 로딩·결과 공통 (Figma 15666:12621·12855) — 두 블록 끝에 같은 위치로 붙는다 */}
-        {(loading || status === "result") && (
-          <p className="text-fm-caption text-foreground-muted">
-            {RESULT_FOOTNOTE}
-          </p>
-        )}
-      </div>
+    <>
+      <RouteToastHost />
+      <aside className="pointer-events-auto absolute inset-y-0 left-0 z-10 flex w-97 shrink-0 flex-col bg-background shadow-raised">
+        <h1 className="sr-only">AI 경로추천</h1>
+        <div className="flex min-h-0 flex-1 flex-col gap-md overflow-y-auto p-5">
+          {status === "idle" && <RouteEmptyState />}
+          {status === "error" && errorNotice && (
+            <RouteErrorNotice notice={errorNotice} onRetry={submit} />
+          )}
+          {loading && (
+            <>
+              <RouteResultHeader loading count={0} />
+              <RouteLoadingList />
+            </>
+          )}
+          {status === "result" && (
+            <>
+              <RouteResultHeader loading={false} count={points.length} />
+              {bannerText && <RoutePartialBanner text={bannerText} />}
+              {points.length > 0 && (
+                <RouteResultList
+                  points={points}
+                  selectedOrder={selectedOrder}
+                  onSelect={selectFromCard}
+                />
+              )}
+            </>
+          )}
+          {/* 각주는 로딩·결과 공통 (Figma 15666:12621·12855) — 두 블록 끝에 같은 위치로 붙는다 */}
+          {(loading || status === "result") && (
+            <p className="text-fm-caption text-foreground-muted">
+              {RESULT_FOOTNOTE}
+            </p>
+          )}
+        </div>
 
-      <div className="flex flex-col gap-md p-5 pt-0">
-        {status === "idle" && <RouteSuggestionChips onSelect={setText} />}
-        <RouteInputCard
-          text={text}
-          onChange={setText}
-          onSubmit={submit}
-          canSubmit={canSubmit({
-            text,
-            status,
-            featureDisabled,
-            mapReady: bounds !== null,
-          })}
-          submitLabel={status === "idle" ? "동선 짜기" : "다시 짜기"}
-          loading={loading}
-        />
-      </div>
-    </aside>
+        <div className="flex flex-col gap-md p-5 pt-0">
+          {status === "idle" && <RouteSuggestionChips onSelect={setText} />}
+          <RouteInputCard
+            text={text}
+            onChange={setText}
+            onSubmit={submit}
+            canSubmit={canSubmit({
+              text,
+              status,
+              featureDisabled,
+              mapReady: bounds !== null,
+            })}
+            submitLabel={submitLabel({ status, originSent })}
+            // 결과 화면은 버튼 문구로만 출발지를 알린다 — 표시 행은 사라진다 (Figma 15666:13139)
+            originActive={originActive && status !== "result"}
+            loading={loading}
+          />
+        </div>
+      </aside>
+    </>
   );
 };
diff --git a/apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx b/apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx
index 6e421135..46a5d95f 100644
--- a/apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx
+++ b/apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx
@@ -9,6 +9,11 @@ import { useViewportStore } from "@/features/map-home/model/viewport-store";
 import { useMapOverlayStore } from "@/widgets/map-shell/map-overlay-store";
 import type { MapShellContext } from "@/widgets/map-shell/use-map-shell";
 import { envelopeResponse, errorEnvelope } from "@/test/envelope-response";
+import {
+  allowPositionAt,
+  denyPosition,
+  setGeolocation,
+} from "@/test/geolocation";
 import { signInForTest, signOutForTest } from "@/test/auth-session";
 import { ROUTE_POINTS } from "@/test/route-points";
 import { stubFetch } from "@/test/stub-fetch";
@@ -64,6 +69,11 @@ const submitButton = () =>
 const textarea = () =>
   screen.getByLabelText("하고 싶은 일 한 문장") as HTMLTextAreaElement;
 
+/** 현위치 어댑터 스텁 (MSG-489) — jsdom 기본은 geolocation 부재라 "미확보"가 기본값이다 */
+const originalGeolocation = navigator.geolocation;
+
+const originRow = () => screen.queryByText("현재 위치에서 출발");
+
 /** 문장 입력 → 제출 — 결과·실패 케이스가 공유하는 진입 동작 */
 const submitText = (value: string) => {
   fireEvent.change(textarea(), { target: { value } });
@@ -86,6 +96,7 @@ beforeEach(() => {
 });
 
 afterEach(() => {
+  setGeolocation(originalGeolocation);
   vi.unstubAllGlobals();
 });
 
@@ -267,3 +278,55 @@ describe("실패 경로 (S10)", () => {
     ).toBe(false);
   });
 });
+
+describe("출발지 자동 판정 (S1·S2·S7)", () => {
+  it("현위치가 뷰포트 안이면 입력 카드에 '현재 위치에서 출발' 표시가 뜬다 (S1)", async () => {
+    allowPositionAt({ lat: 35.1579, lng: 129.0594 });
+
+    renderPanel();
+
+    await waitFor(() => expect(originRow()).toBeTruthy());
+  });
+
+  it("현위치가 뷰포트 밖이면 표시가 없고 제출은 그대로 동작한다 (S2)", async () => {
+    // 뷰포트(서면) 밖 — 같은 부산 안의 해운대 일대
+    allowPositionAt({ lat: 35.1631, lng: 129.1635 });
+    stubFetch(() => recommendResponse());
+    renderPanel();
+
+    submitText("서면 동선");
+
+    await waitFor(() => expect(screen.getByText("· 3곳")).toBeTruthy());
+    expect(originRow()).toBeNull();
+  });
+
+  it("권한을 거부하면 표시가 없다 — 서면 폴백 좌표로 오판정하지 않는다 (S2·A1)", async () => {
+    denyPosition();
+    renderPanel();
+
+    await waitFor(() =>
+      expect(screen.getByRole("button", { name: "동선 짜기" })).toBeTruthy(),
+    );
+    expect(originRow()).toBeNull();
+  });
+
+  it("출발지를 실어 보낸 결과 화면의 버튼은 '현재 위치에서 다시 짜기'다 (S7)", async () => {
+    allowPositionAt({ lat: 35.1579, lng: 129.0594 });
+    const received = stubFetch(() => recommendResponse());
+    renderPanel();
+    await waitFor(() => expect(originRow()).toBeTruthy());
+
+    submitText("서면 동선");
+
+    await waitFor(() =>
+      expect(
+        screen.getByRole("button", { name: "현재 위치에서 다시 짜기" }),
+      ).toBeTruthy(),
+    );
+    expect(received[0].body).toMatchObject({
+      origin: { lat: 35.1579, lng: 129.0594 },
+    });
+    // 결과 화면에서는 표시 행이 사라지고 버튼 문구만 출발지를 알린다 (Figma 15666:13139)
+    expect(originRow()).toBeNull();
+  });
+});
diff --git a/apps/web/src/pages/ai-route/ui/RouteInputCard.tsx b/apps/web/src/pages/ai-route/ui/RouteInputCard.tsx
index 57ddde4e..724ce9ef 100644
--- a/apps/web/src/pages/ai-route/ui/RouteInputCard.tsx
+++ b/apps/web/src/pages/ai-route/ui/RouteInputCard.tsx
@@ -1,4 +1,5 @@
 import { Button } from "@fillmap/ui-web";
+import { Navigation } from "lucide-react";
 import { MAX_ROUTE_TEXT_LENGTH } from "@/features/ai-route/model/route-request";
 
 /**
@@ -14,6 +15,8 @@ interface RouteInputCardProps {
   canSubmit: boolean;
   /** 버튼 문구 — 입력 대기 "동선 짜기" / 결과·실패 "다시 짜기" (로딩은 아래에서 덮는다) */
   submitLabel: string;
+  /** 현위치가 뷰포트 안이라 출발지가 실리는가 — 상태 표시일 뿐 누르는 컨트롤이 아니다 (D8) */
+  originActive: boolean;
   loading: boolean;
 }
 
@@ -23,6 +26,7 @@ export const RouteInputCard = ({
   onSubmit,
   canSubmit,
   submitLabel,
+  originActive,
   loading,
 }: RouteInputCardProps) => (
   <div className="flex flex-col gap-sm rounded-md border border-border bg-surface-soft p-3.5">
@@ -42,8 +46,15 @@ export const RouteInputCard = ({
       className="resize-none bg-transparent text-fm-base text-foreground outline-none placeholder:text-foreground-muted"
     />
     <div className="flex items-center justify-between gap-sm">
-      {/* [MSG-489 확장점] 출발지 상태 행이 이 슬롯에 들어온다 — 지금은 null. */}
-      <span />
+      {/* 좌측 슬롯 — 출발지가 실릴 때만 상태 행이 뜬다 (Figma 15666:12571). 없으면 자리만 (S2) */}
+      {originActive ? (
+        <span className="flex items-center gap-1.25 text-fm-label text-foreground-muted">
+          <Navigation aria-hidden className="size-3.25" />
+          현재 위치에서 출발
+        </span>
+      ) : (
+        <span />
+      )}
       <Button
         text={loading ? "짜는 중…" : submitLabel}
         variant="primary"
diff --git a/apps/web/src/pages/ai-route/ui/RouteToastHost.tsx b/apps/web/src/pages/ai-route/ui/RouteToastHost.tsx
new file mode 100644
index 00000000..e3d6fcde
--- /dev/null
+++ b/apps/web/src/pages/ai-route/ui/RouteToastHost.tsx
@@ -0,0 +1,44 @@
+import { Toast } from "@fillmap/ui-web";
+import { useState } from "react";
+import { useAiRouteStore } from "@/features/ai-route/model/ai-route-store";
+import {
+  MOVED_TOAST_DESCRIPTION,
+  movedToastTitle,
+} from "@/features/ai-route/model/route-mentioned-area";
+import { useAutoDismissToast } from "@/features/video-actions/model/use-auto-dismiss-toast";
+
+/**
+ * 언급 지역 자동 이동 안내 토스트 (Figma 15675:3267 — MSG-489 D3).
+ * 지도 상단 중앙(패널 오른쪽 영역의 가운데)에 뜨고 3초 뒤 사라진다.
+ * ui-web `Toast`(dark)를 무수정 재사용하고, 소멸 타이머는 기존 `useAutoDismissToast`가 맡는다.
+ *
+ * 이동 사실의 정본은 스토어(`movedAreaName`)이고 이 호스트는 그 **전이**에만 반응한다 —
+ * 섹션을 나갔다 돌아왔다고 이미 지나간 토스트를 다시 띄우지 않는다 (A7).
+ */
+export const RouteToastHost = () => {
+  const movedAreaName = useAiRouteStore((s) => s.movedAreaName);
+  const [message, setMessage] = useAutoDismissToast();
+  // 마운트 시점의 값은 이미 소비된 이동으로 본다
+  const [seen, setSeen] = useState<string | null>(
+    () => useAiRouteStore.getState().movedAreaName,
+  );
+
+  // 렌더 중 파생 동기화(React 공식 "props가 바뀔 때 state 조정" 패턴) — 이펙트로 쓰면
+  // `setMessage`가 매 렌더 새 참조라 의존성에 넣는 순간 소멸 타이머가 계속 재시작된다.
+  if (movedAreaName !== seen) {
+    setSeen(movedAreaName);
+    if (movedAreaName !== null) setMessage(movedToastTitle(movedAreaName));
+  }
+
+  if (message === null) return null;
+
+  return (
+    <div className="pointer-events-none absolute left-97 right-0 top-21 z-20 flex justify-center px-5">
+      <Toast
+        className="w-85.5"
+        title={message}
+        description={MOVED_TOAST_DESCRIPTION}
+      />
+    </div>
+  );
+};
diff --git a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx
new file mode 100644
index 00000000..93a6825f
--- /dev/null
+++ b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx
@@ -0,0 +1,234 @@
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { act, renderHook, waitFor } from "@testing-library/react";
+import { StrictMode, type ReactNode } from "react";
+import { MemoryRouter, Outlet, Route, Routes } from "react-router-dom";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import type { Bounds } from "@/entities/cell";
+import { useAiRouteStore } from "@/features/ai-route/model/ai-route-store";
+import {
+  SECONDARY_MIN_INTERVAL_MS,
+  toViewportDto,
+} from "@/features/ai-route/model/route-request";
+import { MAP_SCALE_1KM_ZOOM } from "@/features/map-home/model/map-scale";
+import { useViewportStore } from "@/features/map-home/model/viewport-store";
+import type { MentionedAreaDto } from "@/shared/api/generated";
+import { envelopeResponse } from "@/test/envelope-response";
+import { allowPositionAt, setGeolocation } from "@/test/geolocation";
+import { ROUTE_POINTS } from "@/test/route-points";
+import { stubFetch } from "@/test/stub-fetch";
+import type { MapShellContext } from "@/widgets/map-shell/use-map-shell";
+import { useAiRouteAutoMove } from "./use-ai-route-auto-move";
+
+/**
+ * 자동 이동 오케스트레이션 (MSG-489 L16~L19).
+ * 지도 명령(moveTo·zoomTo)은 Outlet context로 주입되는 `MapShellContext` 스텁으로 관찰하고,
+ * 요청 계약은 네트워크 경계 스텁(stub-fetch)이 받은 body로만 확인한다.
+ */
+const moveTo = vi.fn();
+const zoomTo = vi.fn();
+
+const mapShellContext = {
+  moveTo,
+  zoomIn: vi.fn(),
+  zoomOut: vi.fn(),
+  zoomTo,
+  fitBounds: vi.fn(),
+  locate: vi.fn(),
+} satisfies MapShellContext;
+
+/** 요청 시점 뷰포트 — 부산 서면. 현위치를 품고 있어 1차 요청에 origin이 실린다 */
+const BOUNDS_BEFORE: Bounds = {
+  sw: { lat: 35.1521, lng: 129.0537 },
+  ne: { lat: 35.1662, lng: 129.0712 },
+};
+/** 자동 이동 후 뷰포트 — 현위치를 품지 않는다(L19: 2차는 origin 없이 나간다) */
+const BOUNDS_AFTER: Bounds = {
+  sw: { lat: 35.1523, lng: 129.1521 },
+  ne: { lat: 35.1712, lng: 129.1712 },
+};
+const CURRENT_POSITION = { lat: 35.1579, lng: 129.0594 };
+
+const MENTIONED_AREA: MentionedAreaDto = {
+  name: "부산 해운대",
+  centerLat: 35.1618,
+  centerLng: 129.1618,
+  minLat: 35.1523,
+  minLng: 129.1521,
+  maxLat: 35.1712,
+  maxLng: 129.1712,
+  kind: "MOVE",
+};
+
+const originalGeolocation = navigator.geolocation;
+
+// StrictMode로 감싼다 — dev의 이펙트 2회 실행에서 자동 이동·2차 발사가 중복되지 않아야 한다
+const wrapper = ({ children }: { children: ReactNode }) => (
+  <StrictMode>
+    <QueryClientProvider
+      client={
+        new QueryClient({ defaultOptions: { queries: { retry: false } } })
+      }
+    >
+      <MemoryRouter initialEntries={["/ai-route"]}>
+        <Routes>
+          <Route element={<Outlet context={mapShellContext} />}>
+            <Route path="/ai-route" element={children} />
+          </Route>
+        </Routes>
+      </MemoryRouter>
+    </QueryClientProvider>
+  </StrictMode>
+);
+
+/** 1·2차 응답 모두 mentionedArea를 실어 준다 — 2차 무시(L17)를 같은 스텁으로 확인한다 */
+const stubBothWithMentionedArea = () =>
+  stubFetch(() =>
+    envelopeResponse({
+      points: ROUTE_POINTS,
+      notice: null,
+      mentionedArea: MENTIONED_AREA,
+    }),
+  );
+
+/** 현위치 확보 대기 → 1차 제출 → 자동 이동 명령 도착까지 */
+const submitAndAwaitMove = async () => {
+  const rendered = renderHook(
+    () => useAiRouteAutoMove({ onLoginRequired: vi.fn() }),
+    { wrapper },
+  );
+
+  await waitFor(() => expect(rendered.result.current.originActive).toBe(true));
+  act(() => rendered.result.current.submit());
+  await waitFor(() => expect(moveTo).toHaveBeenCalledTimes(1));
+
+  return rendered;
+};
+
+/** 지도 이동이 반영돼 새 bounds가 들어오고, 서버 10초 창도 지난 상태를 만든다 */
+const settleNewViewport = () => {
+  act(() => {
+    useAiRouteStore.setState({
+      requestedAt: Date.now() - SECONDARY_MIN_INTERVAL_MS,
+    });
+    useViewportStore.setState({ bounds: BOUNDS_AFTER });
+  });
+};
+
+beforeEach(() => {
+  useAiRouteStore.setState(useAiRouteStore.getInitialState(), true);
+  useAiRouteStore.getState().setText("해운대에서 저녁 먹고 산책");
+  useViewportStore.setState({ bounds: BOUNDS_BEFORE });
+  allowPositionAt(CURRENT_POSITION);
+  moveTo.mockClear();
+  zoomTo.mockClear();
+});
+
+afterEach(() => {
+  setGeolocation(originalGeolocation);
+  vi.unstubAllGlobals();
+});
+
+describe("useAiRouteAutoMove — 언급 지역 자동 이동과 2차 재요청 (L16~L19)", () => {
+  it("mentionedArea가 실린 1차 응답에서 지도를 옮기고 1km 축척으로 고정한 뒤 2차를 1회 쏜다 (L16)", async () => {
+    const received = stubBothWithMentionedArea();
+
+    await submitAndAwaitMove();
+    settleNewViewport();
+
+    await waitFor(() => expect(received).toHaveLength(2));
+    expect(moveTo).toHaveBeenCalledWith({
+      lat: MENTIONED_AREA.centerLat,
+      lng: MENTIONED_AREA.centerLng,
+    });
+    expect(zoomTo).toHaveBeenCalledTimes(1);
+    expect(zoomTo).toHaveBeenCalledWith(MAP_SCALE_1KM_ZOOM);
+  });
+
+  it("2차 응답에 mentionedArea가 또 실려도 추가 이동·재요청이 없다 (L17)", async () => {
+    const received = stubBothWithMentionedArea();
+
+    await submitAndAwaitMove();
+    settleNewViewport();
+    await waitFor(() => expect(received).toHaveLength(2));
+    await waitFor(() =>
+      expect(useAiRouteStore.getState().status).toBe("result"),
+    );
+    // 2차 응답 뒤 뷰포트가 또 갱신돼도 예약이 남아 있지 않다
+    act(() =>
+      useViewportStore.setState({
+        bounds: {
+          sw: { lat: 35.15, lng: 129.15 },
+          ne: { lat: 35.18, lng: 129.18 },
+        },
+      }),
+    );
+
+    expect(received).toHaveLength(2);
+    expect(moveTo).toHaveBeenCalledTimes(1);
+    expect(zoomTo).toHaveBeenCalledTimes(1);
+  });
+
+  it("2차 요청 뷰포트는 이동 후 새 bounds로 만들어진다 (L18)", async () => {
+    const received = stubBothWithMentionedArea();
+
+    await submitAndAwaitMove();
+    settleNewViewport();
+
+    await waitFor(() => expect(received).toHaveLength(2));
+    expect(received[0].body).toMatchObject({
+      viewport: toViewportDto(BOUNDS_BEFORE),
+    });
+    expect(received[1].body).toMatchObject({
+      viewport: toViewportDto(BOUNDS_AFTER),
+    });
+  });
+
+  it("2차 요청의 출발지는 새 뷰포트로 재판정된다 — 이동 후 현위치가 밖이면 싣지 않는다 (L19)", async () => {
+    const received = stubBothWithMentionedArea();
+
+    await submitAndAwaitMove();
+    settleNewViewport();
+
+    await waitFor(() => expect(received).toHaveLength(2));
+    expect(received[0].body).toMatchObject({ origin: CURRENT_POSITION });
+    expect(received[1].body).not.toHaveProperty("origin");
+  });
+
+  it("섹션을 나갔다 돌아와도 예약된 2차는 1회만 나간다 (A7 — 마운트 시 재개)", async () => {
+    const received = stubBothWithMentionedArea();
+    act(() => {
+      useAiRouteStore.setState({
+        status: "loading",
+        autoMoved: true,
+        movedAreaName: "부산 해운대",
+        secondaryPending: true,
+        requestedAt: Date.now() - SECONDARY_MIN_INTERVAL_MS,
+      });
+      useViewportStore.setState({ bounds: BOUNDS_AFTER });
+    });
+
+    renderHook(() => useAiRouteAutoMove({ onLoginRequired: vi.fn() }), {
+      wrapper,
+    });
+
+    await waitFor(() =>
+      expect(useAiRouteStore.getState().status).toBe("result"),
+    );
+    expect(received).toHaveLength(1);
+    expect(moveTo).not.toHaveBeenCalled();
+  });
+
+  it("서버 10초 창이 남아 있으면 새 bounds가 와도 2차를 즉시 쏘지 않는다 (Q2 안 B)", async () => {
+    const received = stubBothWithMentionedArea();
+
+    await submitAndAwaitMove();
+    act(() => useViewportStore.setState({ bounds: BOUNDS_AFTER }));
+    await act(async () => {
+      await Promise.resolve();
+    });
+
+    expect(received).toHaveLength(1);
+    expect(useAiRouteStore.getState().status).toBe("loading");
+    expect(useAiRouteStore.getState().points).toHaveLength(0);
+  });
+});
diff --git a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts
new file mode 100644
index 00000000..71cc4311
--- /dev/null
+++ b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts
@@ -0,0 +1,145 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import type { Bounds, LatLng } from "@/entities/cell";
+import { useRouteRecommend } from "@/features/ai-route/api/use-route-recommend";
+import { useAiRouteStore } from "@/features/ai-route/model/ai-route-store";
+import type { RouteAutoMove } from "@/features/ai-route/model/route-mentioned-area";
+import { resolveRouteOrigin } from "@/features/ai-route/model/route-origin";
+import {
+  buildRecommendBody,
+  needsSpanNormalize,
+  secondaryDelayMs,
+} from "@/features/ai-route/model/route-request";
+import { MAP_SCALE_1KM_ZOOM } from "@/features/map-home/model/map-scale";
+import { useViewportStore } from "@/features/map-home/model/viewport-store";
+import type { RouteRecommendRequestDto } from "@/shared/api/generated";
+import { getCurrentPositionOrNull } from "@/shared/geolocation";
+import { useMapShell } from "@/widgets/map-shell/use-map-shell";
+
+/**
+ * AI 경로추천 자동 동작 오케스트레이션 (MSG-489 L16~L19).
+ * **뷰-레이어 훅** — 지도 명령(`use-map-shell`)에 직접 배선하므로 RN 재사용 대상이 아니다.
+ * 판정은 전부 순수 함수(`route-origin`·`route-mentioned-area`·`route-request`)가 소유하고,
+ * 여기에는 "언제 무엇을 호출하는가"만 남는다.
+ *
+ * 세 가지 자동 동작을 한 훅에 모은 이유: 셋 다 같은 재료(현위치·뷰포트 bounds·요청 시각)를
+ * 공유하고 한 요청 사이클 안에서 순서로 얽혀 있다 — 나누면 재료를 이중으로 들고 있게 된다.
+ *  ① 제출 시 출발지 자동 판정(D8)과 0.5도 예방 정규화(A2)
+ *  ② 응답 mentionedArea → 지도 이동 + 1km 축척 고정(D2)
+ *  ③ 새 뷰포트가 반영된 뒤 2차 자동 재요청 1회(D4·Q2 안 B)
+ */
+
+/** 진입 시 1회 측위 — 거부·미확보는 null 그대로 둔다(서면 폴백을 쓰면 오판정된다, A1) */
+const useCurrentCoords = (): LatLng | null => {
+  const [coords, setCoords] = useState<LatLng | null>(null);
+
+  useEffect(() => {
+    let active = true;
+    void getCurrentPositionOrNull().then((next) => {
+      if (active) setCoords(next);
+    });
+    return () => {
+      active = false;
+    };
+  }, []);
+
+  return coords;
+};
+
+interface AiRouteAutoMove {
+  /** 제출 — 축척 정규화가 필요하면 줌을 먼저 맞추고 새 뷰포트가 반영된 뒤 보낸다 */
+  submit: () => void;
+  /** 이번 뷰포트 기준으로 출발지가 실리는가 — 입력 카드의 "현재 위치에서 출발" 표시 (S1) */
+  originActive: boolean;
+}
+
+export const useAiRouteAutoMove = ({
+  onLoginRequired,
+}: {
+  onLoginRequired: () => void;
+}): AiRouteAutoMove => {
+  const { moveTo, zoomTo } = useMapShell();
+  const bounds = useViewportStore((s) => s.bounds);
+  const text = useAiRouteStore((s) => s.text);
+  const secondaryPending = useAiRouteStore((s) => s.secondaryPending);
+  const requestedAt = useAiRouteStore((s) => s.requestedAt);
+
+  const coords = useCurrentCoords();
+  const origin = useMemo(
+    () => resolveRouteOrigin({ coords, bounds }),
+    [coords, bounds],
+  );
+
+  // 이동 명령 직후의 bounds — 2차는 이 값이 **바뀐 뒤**에만 나간다.
+  // moveTo·zoomTo는 명령일 뿐이고 새 bounds는 MapCanvas idle을 거쳐 스토어에 들어온다(R3).
+  const boundsAtMoveRef = useRef<Bounds | null>(null);
+  // 0.5도 초과 뷰포트 정규화 대기 — 줌을 맞춘 뒤 새 bounds로 1차를 보낸다 (A2).
+  // state가 아니라 ref인 이유: 대기 여부는 화면에 안 보이고, 발사 시점은 bounds 갱신이
+  // 정한다. state로 두면 StrictMode(dev)의 이펙트 2회 실행에서 같은 요청이 두 번 나간다.
+  const normalizingRef = useRef(false);
+
+  const onAutoMove = useCallback(
+    (move: RouteAutoMove) => {
+      boundsAtMoveRef.current = useViewportStore.getState().bounds;
+      moveTo(move.center);
+      zoomTo(move.zoom);
+    },
+    [moveTo, zoomTo],
+  );
+
+  const { mutate: sendPrimary } = useRouteRecommend({
+    onLoginRequired,
+    onAutoMove,
+  });
+  const { mutate: sendSecondary } = useRouteRecommend({ secondary: true });
+
+  const send = useCallback(
+    (mutate: (body: RouteRecommendRequestDto) => void) => {
+      // 출발지는 **보내는 시점의 뷰포트**로 판정한다 — 2차는 이동 후 기준이다 (L19·A5)
+      const body = buildRecommendBody({ text, bounds, origin });
+      if (body === null) return;
+      mutate(body);
+    },
+    [text, bounds, origin],
+  );
+
+  const submit = useCallback(() => {
+    if (needsSpanNormalize(bounds)) {
+      // 서버 상한(14401) 예방 — 지역 이동이 아니므로 토스트는 띄우지 않는다 (A2)
+      normalizingRef.current = true;
+      zoomTo(MAP_SCALE_1KM_ZOOM);
+      return;
+    }
+    send(sendPrimary);
+  }, [bounds, zoomTo, send, sendPrimary]);
+
+  useEffect(() => {
+    if (!normalizingRef.current || needsSpanNormalize(bounds)) return;
+    normalizingRef.current = false;
+    send(sendPrimary);
+  }, [bounds, send, sendPrimary]);
+
+  useEffect(() => {
+    if (!secondaryPending) return;
+    // 옛 bounds로 쏘면 2차가 무의미하다 — 이동이 지도에 반영될 때까지 기다린다 (R3·L18)
+    if (bounds === null || bounds === boundsAtMoveRef.current) return;
+
+    // 예약이 이미 소비됐으면 쏘지 않는다 — StrictMode(dev)의 이펙트 2회 실행 방어.
+    // 첫 실행의 `onMutate`가 예약을 끄므로 두 번째 실행은 여기서 멈춘다.
+    const fire = () => {
+      if (!useAiRouteStore.getState().secondaryPending) return;
+      send(sendSecondary);
+    };
+
+    // 서버 재요청 제한(14429)은 자동 재요청도 예외가 아니다 — 남은 창만큼 로딩을 유지한다 (Q2)
+    const delay = secondaryDelayMs({ requestedAt, now: Date.now() });
+    if (delay <= 0) {
+      fire();
+      return;
+    }
+    const timer = setTimeout(fire, delay);
+    // 재제출·언마운트·뷰포트 재갱신 시 예약을 취소한다 (Q2 — 대기 중 이탈)
+    return () => clearTimeout(timer);
+  }, [secondaryPending, bounds, requestedAt, send, sendSecondary]);
+
+  return { submit, originActive: origin !== null };
+};
diff --git a/apps/web/src/shared/geolocation.test.ts b/apps/web/src/shared/geolocation.test.ts
index f71c047b..496aaf51 100644
--- a/apps/web/src/shared/geolocation.test.ts
+++ b/apps/web/src/shared/geolocation.test.ts
@@ -1,16 +1,13 @@
 import { afterEach, describe, expect, it, vi } from "vitest";
-import { SEOMYEON_CENTER, getCurrentPosition } from "./geolocation";
+import { setGeolocation } from "@/test/geolocation";
+import {
+  SEOMYEON_CENTER,
+  getCurrentPosition,
+  getCurrentPositionOrNull,
+} from "./geolocation";
 
 const originalGeolocation = navigator.geolocation;
 
-const setGeolocation = (value: unknown) => {
-  Object.defineProperty(navigator, "geolocation", {
-    value,
-    configurable: true,
-    writable: true,
-  });
-};
-
 afterEach(() => {
   setGeolocation(originalGeolocation);
   vi.restoreAllMocks();
@@ -52,3 +49,44 @@ describe("getCurrentPosition (L6)", () => {
     });
   });
 });
+
+/**
+ * MSG-489 A1 — 폴백을 씌우지 않는 가산 어댑터.
+ * 경로추천 출발지 판정은 "거부·미확보"와 "서면에 있다"를 구분해야 한다:
+ * 기존 폴백은 MVP 지역(서면)이라 거부한 사용자도 뷰포트 안으로 오판정된다.
+ */
+describe("getCurrentPositionOrNull (MSG-489 A1)", () => {
+  it("위치 권한 거부/조회 실패 시 null을 반환한다 — 서면 폴백을 씌우지 않는다", async () => {
+    setGeolocation({
+      getCurrentPosition: (
+        _success: PositionCallback,
+        error: PositionErrorCallback,
+      ) => {
+        error({ code: 1, message: "denied" } as GeolocationPositionError);
+      },
+    });
+
+    await expect(getCurrentPositionOrNull()).resolves.toBeNull();
+  });
+
+  it("geolocation API 자체가 없으면 null을 반환한다", async () => {
+    setGeolocation(undefined);
+
+    await expect(getCurrentPositionOrNull()).resolves.toBeNull();
+  });
+
+  it("위치 허용 시 조회된 좌표를 반환한다", async () => {
+    setGeolocation({
+      getCurrentPosition: (success: PositionCallback) => {
+        success({
+          coords: { latitude: 35.1234, longitude: 129.0678 },
+        } as GeolocationPosition);
+      },
+    });
+
+    await expect(getCurrentPositionOrNull()).resolves.toEqual({
+      lat: 35.1234,
+      lng: 129.0678,
+    });
+  });
+});
diff --git a/apps/web/src/shared/geolocation.ts b/apps/web/src/shared/geolocation.ts
index eeafe4d4..b90d9082 100644
--- a/apps/web/src/shared/geolocation.ts
+++ b/apps/web/src/shared/geolocation.ts
@@ -8,17 +8,21 @@ export interface GeoCoords {
 export const SEOMYEON_CENTER: GeoCoords = { lat: 35.1579, lng: 129.0594 };
 
 /**
- * 현재 위치 조회 어댑터. [L6]
+ * 현재 위치 조회 어댑터 — 폴백 없음 (MSG-489 A1).
  * `navigator.geolocation`은 이 파일 안에서만 참조한다(RN 경계 — RN에서는 구현만 교체).
- * 권한 거부·조회 실패·API 미지원 시 서면 중심 좌표로 폴백한다.
+ * 권한 거부·조회 실패·API 미지원은 `null`로 구분해 돌려준다.
+ *
+ * 폴백판(`getCurrentPosition`)과 나뉘어 있는 이유: 폴백 좌표가 MVP 지역(서면)이라
+ * 거부한 사용자도 지도 뷰포트 안으로 들어와 "현위치가 화면 안"으로 **오판정**된다.
+ * 판정이 필요한 소비자(경로추천 출발지)는 이쪽을, 표시 좌표가 필요한 소비자는 폴백판을 쓴다.
  */
-export const getCurrentPosition = (): Promise<GeoCoords> =>
+export const getCurrentPositionOrNull = (): Promise<GeoCoords | null> =>
   new Promise((resolve) => {
     const geolocation =
       typeof navigator !== "undefined" ? navigator.geolocation : undefined;
 
     if (!geolocation) {
-      resolve(SEOMYEON_CENTER);
+      resolve(null);
       return;
     }
 
@@ -28,6 +32,13 @@ export const getCurrentPosition = (): Promise<GeoCoords> =>
           lat: position.coords.latitude,
           lng: position.coords.longitude,
         }),
-      () => resolve(SEOMYEON_CENTER),
+      () => resolve(null),
     );
   });
+
+/**
+ * 현재 위치 조회 어댑터. [L6]
+ * 권한 거부·조회 실패·API 미지원 시 서면 중심 좌표로 폴백한다.
+ */
+export const getCurrentPosition = (): Promise<GeoCoords> =>
+  getCurrentPositionOrNull().then((coords) => coords ?? SEOMYEON_CENTER);
diff --git a/apps/web/src/test/geolocation.ts b/apps/web/src/test/geolocation.ts
new file mode 100644
index 00000000..a751c177
--- /dev/null
+++ b/apps/web/src/test/geolocation.ts
@@ -0,0 +1,32 @@
+/**
+ * 테스트 전용 헬퍼 — `navigator.geolocation`을 갈아 끼운다.
+ * 같은 7줄이 세 파일째 복제되어(geolocation 단위 · AI 경로추천 스모크 · 자동 이동 훅)
+ * 추출했다 (envelope-response·stub-fetch·robots-meta 선례 — 중복 게이트 검출).
+ *
+ * 되돌리기는 각 파일이 `afterEach`에서 원본을 다시 넣어 한다.
+ */
+export const setGeolocation = (value: unknown) => {
+  Object.defineProperty(navigator, "geolocation", {
+    value,
+    configurable: true,
+    writable: true,
+  });
+};
+
+/** 위치 허용 — 지정 좌표를 즉시 돌려준다 */
+export const allowPositionAt = (coords: { lat: number; lng: number }) =>
+  setGeolocation({
+    getCurrentPosition: (success: PositionCallback) =>
+      success({
+        coords: { latitude: coords.lat, longitude: coords.lng },
+      } as GeolocationPosition),
+  });
+
+/** 위치 거부 — PERMISSION_DENIED로 실패시킨다 */
+export const denyPosition = () =>
+  setGeolocation({
+    getCurrentPosition: (
+      _success: PositionCallback,
+      error: PositionErrorCallback,
+    ) => error({ code: 1, message: "denied" } as GeolocationPositionError),
+  });
diff --git a/docs/STATUS.md b/docs/STATUS.md
index 2b3e3ab7..12ef7cf3 100644
--- a/docs/STATUS.md
+++ b/docs/STATUS.md
@@ -19,7 +19,7 @@
 | (error) | `RouteErrorBoundary` | 렌더·로더 오류 + 404 수렴 (MSG-325). "홈으로"는 `shared/navigation.redirectTo` 하드 이동 — 라우터 navigate는 same-location 에러를 못 푼다 (MSG-477 ②). `<main>`+`<h1>` 랜드마크, 마운트 중 robots 메타 `noindex`(MSG-478) |
 | (layout) | `MapShell` | 전 네비 섹션 공유 지속 지도 셸 |
 | `/` | `MapHomePage` | 지도 홈 (검색·지역 격자 패널 포함 — MSG-328에서 탐색 흡수) |
-| `/ai-route` | `RequireAuth > AiRoutePage` | AI 경로추천 (MSG-488). 로그인 전용 — 서버가 익명 POST를 401(2403)로 막는다. 결과 도착 시 **지도 이동·줌 없음**(카드 클릭만 `moveTo`) |
+| `/ai-route` | `RequireAuth > AiRoutePage` | AI 경로추천 (MSG-488). 로그인 전용 — 서버가 익명 POST를 401(2403)로 막는다. 카드 클릭만 `moveTo`(줌 불변). **응답 `mentionedArea`가 있으면 확인 없이 자동 이동 + 1km 축척 고정 + 토스트 + 2차 자동 재요청 1회**(MSG-489 — 서버 10초 rate limit이라 1차 요청 시각 +10.5s 대기 후 발사). 현위치가 뷰포트 안이면 `origin` 자동 전송 |
 | `/upload` | `SectionPanel` 스텁 | 실제 업로드는 모달 |
 | `/dex/:tab?` | `RequireAuth > DexPanel` | 탭이 URL 정본 (`/dex`·`/dex/badges`·`/dex/history` — MSG-414), 비로그인 시 홈+로그인 모달 (MSG-328) |
 | `/profile` | `RequireAuth > ProfilePanel` | 로그아웃 시 홈+로그인 모달 |
@@ -32,7 +32,7 @@
 - **map-home** — `MapHomePage` + ui/: `MapCanvas`(네이버 지도+오버레이), `MapControls`, `RegionPanel`(기본 분기 — 행정동 헤더+격자 카드 리스트+전체 지역 모드. **비로그인도 같은 구성 — 로그인 유도 분기는 MSG-474에서 제거**), `RegionGridCard`, `RegionListView`, `RegionReloadButton`("{행정동} 장소 불러오기" 재검색 pill), `HomeSearchBox`(장소·격자 검색+인기 검색어 드롭다운 — 격자 섹션은 MSG-412, 선택 시 이동+`emphasizeCell` 하이라이트), `RetryNotice`(실패+재시도 행 공용), `CellActionRow`, `HomeCellDetailPanel`, `FeedVideoCard`, `FeedVideoList`(격자 상세·테마 피드 공용), `ThemeChip`/`ThemeChipsBar`/`ThemeFeedPanel`, `naver-sdk-loader.ts`(SDK 격리 경계), `use-escape-close.ts`, `use-home-entry-lifecycle.ts` · MSG-451 신설 뷰-레이어 훅 3종: `use-home-chip-entry.ts`(칩 진입 — 줌+확정 후 최근접 이동), `use-home-panel-state.ts`(패널 분기+불러오기 대상), `use-home-close-handlers.ts`(미니 패널 우선 닫기)
 - **dex** — `DexPanel` + ui/: `DexProfileHeader`, `DexStatCards`, `DexTabs`, `RegionProgress`, `RecentRegionRow`(동 단위 행), `BadgeTabBody`(+대표 뱃지 편집모드 — MSG-413), `BadgeMedal`(메달 아트 + 편집모드 선택 표시), `FeaturedProfilePreview`(대표 뱃지 프로필 미리보기 카드), `GalleryTabBody`(격자 그룹+1열), `GalleryVideoCard`, `RecordTabBody`(기록 탭 본문 — 헤더+"전체 보기 ›"+메타+24주 잔디, MSG-414), `UploadGrassGrid`(잔디 카드 sm/lg 공용 — 월·요일 라벨·범례·sr-only 요약), `UploadHistoryModal`(1년 53주 모달 — DialogShell 960px), `DexTabErrorState`(구 BadgeErrorState — 탭 공용 통합) · 스모크 공용: `dex-fetch-stub.ts`, `dex-test-harness.tsx`
 - **profile** — `ProfilePanel` + ui/: `ProfileHeader`(대표 뱃지 ≥1개면 메타 줄을 pill 행으로 대체 — ADHOC-featured-badge-header), `ActivityCard`, `SettingRow`, `SettingToggleRow`(ui-web Switch 행 — "알림 받기", MSG-408) · `NotificationSettingsPanel`(388px 알림 설정 상세 — 로딩/오류 게이트+그룹 2개 토글 5행+각주, MSG-409) + ui/: `NotificationToggleRow`(label↔Switch 배선·행 단위 busy), `PermissionBanner`(수신 불가 시 안내 — CTA는 408 use-push-toggle ON 재사용, 미지원은 CTA 없음)
-- **ai-route** (MSG-488 신설) — `AiRoutePage`(388px `aside` — `SectionPanel` 미사용, 제목 헤더 강제 회피) + ui/: `RouteInputCard`(textarea 500자 + 제출), `RouteEmptyState`, `RouteSuggestionChips`(서면 기준 예시 2문구 FE 고정), `RouteResultHeader`, `RouteLoadingList`(ui-web `Skeleton` 3장), `RouteResultList`, `RouteStopCard`(순번 뱃지·kind 태그·표시명·reason), `RouteWalkConnector`("도보 약 Nm"), `RoutePartialBanner`(결과 부족 — 문구 FE 고정, 서버 `notice`는 null 여부 신호로만), `RouteErrorNotice`(ui-web `RetryNotice` 래핑 + 14503 분기), `use-route-legs.ts`, `use-ai-route-overlay-publish.ts`(map-overlay-store 게시/해제 — 언마운트 `clear()`)
+- **ai-route** (MSG-488 신설) — `AiRoutePage`(388px `aside` — `SectionPanel` 미사용, 제목 헤더 강제 회피) + ui/: `RouteInputCard`(textarea 500자 + 제출), `RouteEmptyState`, `RouteSuggestionChips`(서면 기준 예시 2문구 FE 고정), `RouteResultHeader`, `RouteLoadingList`(ui-web `Skeleton` 3장), `RouteResultList`, `RouteStopCard`(순번 뱃지·kind 태그·표시명·reason), `RouteWalkConnector`("도보 약 Nm"), `RoutePartialBanner`(결과 부족 — 문구 FE 고정, 서버 `notice`는 null 여부 신호로만), `RouteErrorNotice`(ui-web `RetryNotice` 래핑 + 14503 분기), `use-route-legs.ts`, `use-ai-route-overlay-publish.ts`(map-overlay-store 게시/해제 — 언마운트 `clear()`). MSG-489 추가: `use-ai-route-auto-move.ts`(제출·0.5도 정규화·현위치 1회 측위·출발지 판정·mentionedArea 자동 이동(`moveTo`+`zoomTo(MAP_SCALE_1KM_ZOOM)`)·2차 재요청 예약을 한 훅이 소유 — `bounds` 참조 변경 AND `requestedAt+10.5s` 경과 시 발사), `RouteToastHost.tsx`(ui-web `Toast` dark + `useAutoDismissToast` 3초 — 스토어 `movedAreaName` 전이로 표시), `RouteInputCard`에 `originActive` prop("현재 위치에서 출발" 행 — 결과 상태에선 숨기고 버튼 문구 "현재 위치에서 다시 짜기"로만 알림)
 - **oauth-callback** — `KakaoCallbackPage` (ui/ 없음)
 
 ## widgets/ (5)
@@ -53,7 +53,7 @@
 - **notifications** (MSG-408 신설) — config: `firebase`(Firebase config·VAPID 공개키 상수 정본 — VITE_ env 예외, 사용자 승인 2026-08-17) · model: `push-support`(지원 판별 순수), `push-sync`(재등록/로테이션 전이 + SW URL 조립 순수), `push-toggle`(토글 표시 파생 순수 — granted && 보관 토큰), `push-token-store`(보관 토큰 반응형, 저장 계층 `shared/storage.fcmTokenStorage`), `push-notice-store`(토글 denied/error 안내 단일 슬롯 — PR #60 리뷰 3) · api: `messaging`(firebase 동적 import 격리 경계 — 테스트 모킹 지점), `use-push-token-sync`(셸 상주 자동 동기화 — 기존 등록자 한정), `use-foreground-messages`(onMessage → 통지) · **MSG-477 ①에서 삭제** — 알림 설정 화면(MSG-409)이 걷히며 `preference-catalog`·`preference-cache`·`permission-banner`·`use-preferences-query`·`use-preference-mutation`·`use-push-toggle`이 소비처 0으로 함께 제거됐다(웹 푸시 **신규 등록 진입점 소멸** — 기존 등록자 동기화·수신 표시는 유지). `model/push-toggle`(표시 파생 순수)은 모바일 parity가 동적 import하므로 존치 · ui: `PushNoticeHost`(AppLayout 셸 분기 상주 — 동기화 배선 + 포그라운드·토글 안내 우하단 단일 스택). SW: `public/firebase-messaging-sw.js`(config는 쿼리스트링 전달, gstatic CDN compat)
 - **profile** — model: `profile-edit`, `profile-format`, `profile-modal-store`(모달 열림 — 사이드레일 초기화가 읽는다), `profile-image`(업로드 순수 로직), `upload-profile-image`(오케스트레이션 포트), `use-profile-image-upload`(웹 포트 훅), `use-profile-query`, `location-consent`(게이트 판정 순수 — RN 재사용 대상)·`use-location-consent-gate`(MSG-407) · api: `use-profile-mutations`(닉네임·위치동의 PUT·이미지 DELETE) · ui: `ProfileEditModal`, `DeleteAccountModal`, `LocationConsentScreen`(전면 동의 화면 — AppLayout 조건 렌더, MSG-407)
 - **video-actions** (MSG-411 신설) — model: `video-menu`(공개 옵션 2종·shouldPatchVisibility 같은 값 미발사·삭제 카드 문구 파생 순수 — RN 재사용 대상), `use-auto-dismiss-toast`(3초 자동 소멸 토스트 공유 훅 — PR #62 리뷰로 3곳 중복 추출, 동일 문구 연속 설정 타이머 재시작 보장), `report`(widgets/cell-detail에서 이동 — REPORT_REASONS·canSubmitReport + `toServerReportReason` FE 3종→서버 enum·`reportFailureNotice` 11409/409 중복 분기) · api: `use-video-mutations`(`useDeleteVideo` 도감·격자 무효화 + upload `invalidateGridQueries` cross-feature 재사용, `useSetVideoVisibility`, `useReportVideo`) · ui: `VideoMoreMenu`(Radix DropdownMenu 복합 소유 — 삭제 확인 모달·신고 모달·실패 토스트 동봉, mine 분기 + "영상 교체" 항목 → upload `openReplaceModal`, MSG-415), `VideoDeleteConfirmDialog`(danger confirm — 대상 카드 실데이터), `ReportDialog`·`ReportReasonSelect`(이동 + 실 POST). 진입점: 도감 `GalleryVideoCard` ⋯ + 미니 패널 헤더 ⋯
-- **ai-route** (MSG-488 신설) — model: `ai-route-store`(요청·결과·선택 상태, 플랫폼 중립 — 지도 SDK 미import), `route-request`(뷰포트 DTO 변환·trim 1~500 제출 판정), `route-point-view`(표시명 `[zoneName+zoneCell] · [regionName]` non-null join · kind 태그 매핑 — 미지 kind는 태그 없음, `EVENT`·`MISSION_FESTIVAL` 둘 다 `theme-festival`), `route-legs`(이웃 좌표 **직선** 구간 거리 — 실보행 경로는 MSG-490), `route-error`(developCode 14400/14401/14429/14502/14503 + 401(2403) → UI 반응 7행), `route-overlay`(points → `RouteOverlay` + `StyledCellOverlay[]` 순수 파생) · api: `use-route-recommend`(`recommendMutation` 래핑 + `unwrapEnvelope`) · ui/ 없음(UI는 pages/ai-route). **MSG-489·490 확장점 주석이 심겨 있다** — 소유권 경계는 `docs/spec/MSG-488.md` §4-2
+- **ai-route** (MSG-488 신설) — model: `ai-route-store`(요청·결과·선택 상태, 플랫폼 중립 — 지도 SDK 미import), `route-request`(뷰포트 DTO 변환·trim 1~500 제출 판정), `route-point-view`(표시명 `[zoneName+zoneCell] · [regionName]` non-null join · kind 태그 매핑 — 미지 kind는 태그 없음, `EVENT`·`MISSION_FESTIVAL` 둘 다 `theme-festival`), `route-legs`(이웃 좌표 **직선** 구간 거리 — 실보행 경로는 MSG-490), `route-error`(developCode 14400/14401/14429/14502/14503 + 401(2403) → UI 반응 7행), `route-overlay`(points → `RouteOverlay` + `StyledCellOverlay[]` 순수 파생), **MSG-489 추가**: `route-origin`(`resolveRouteOrigin` — 현위치 ∈ bounds면 origin, 밖/미확보/bounds null이면 null), `route-mentioned-area`(`resolveAutoMove` — `mentionedArea` non-null이면 `kind` 무관 이동, `alreadyMoved`면 차단(2차 무시) · `movedToastTitle` 받침 판정 조사), `route-request` 확장(`origin` 병합·`needsSpanNormalize` 0.5도·`submitLabel`·`secondaryDelayMs`/`SECONDARY_MIN_INTERVAL_MS`=10.5s), `ai-route-store` 사이클 플래그 5종(`autoMoved`·`originSent`·`movedAreaName`·`secondaryPending`·`requestedAt`) · api: `use-route-recommend`(`recommendMutation` 래핑 + `unwrapEnvelope`; MSG-489 — `onSuccess`가 1차/2차를 갈라 이동 필요 시 결과 미게시 + 2차 예약, `secondary` 옵션) · ui/ 없음(UI는 pages/ai-route). **MSG-489·490 확장점 주석이 심겨 있다** — 소유권 경계는 `docs/spec/MSG-488.md` §4-2
 - **upload** — model: `upload-wizard`(스텝 전이), `upload-orchestration`(presign→S3 PUT→확정 상태머신), `upload-validation`, `highlight-selection`(+훅), `video-trim`, `ready-poll`(READY 반영 폴링 — 통지 아님), `upload-modal-store`(+`replaceTarget`·`openReplaceModal` — 교체 모드, MSG-415), `use-upload-location`, `presign-purpose`, `wizard-mode`(모드별 문구·격자 라벨 순수, MSG-415) · api: `use-upload-mutations`(`useConfirmUpload` + `useReplaceVideo` — finalize만 `PUT /api/videos/{videoId}`·lat/lng 미전송 미러, MSG-415), `s3-upload`, `ffmpeg-trim`(ffmpeg.wasm), `invalidate-grid-queries`, `invalidate-upload-surfaces`(확정·교체·READY 공용 무효화 집합 — 재생·격자·도감·잔디), `start-ready-refresh`(확정 후 READY 전이에서 같은 집합 재무효화) · ui: `UploadModal`+`use-upload-wizard`, `SelectStep`/`HighlightStep`/`PreviewStep`, `SegmentList`/`SegmentRow`/`SegmentTrimmer`, `UploadDropzone`, `VideoPreview`, `AnalyzingModal`. **블러 경로(폴링·토스트·확인 모달) 전량 삭제 — 서버 블러 중단, MSG-476.** `PreviewStep`에 공개 범위 라디오(전체 공개/나만 보기 — video-actions `VISIBILITY_OPTIONS` 재사용, radix-ui RadioGroup) → 확정 body `visibility` 전송
 
 ## entities/ (5)
@@ -67,7 +67,7 @@
 ## shared/
 
 - api: `http-client.ts`(공용 Ky), `client-config.ts`(hey-api 런타임), `auth-pipeline.ts`, `api-error.ts`, `error-interceptor.ts`, `envelope.ts`(봉투 언랩), `generated/**`(hey-api 생성물 — 수정 금지)
-- 어댑터(RN 경계 경유지): `storage.ts`(webStorage·oauthState·uploadIntent·deviceId·**fcmToken**(MSG-408 — auth↔notifications 매개)), `navigation.ts`, `geolocation.ts` · 유틸: `format.ts`(formatDuration 포함), `use-debounced-value.ts`(flush 지원 디바운스 훅)
+- 어댑터(RN 경계 경유지): `storage.ts`(webStorage·oauthState·uploadIntent·deviceId·**fcmToken**(MSG-408 — auth↔notifications 매개)), `navigation.ts`, `geolocation.ts`(`getCurrentPosition` 서면 폴백 + MSG-489 가산 `getCurrentPositionOrNull` — 거부·실패·미지원이면 null, 출발지 판정 전용) · 유틸: `format.ts`(formatDuration 포함), `use-debounced-value.ts`(flush 지원 디바운스 훅)
 - SEO(MSG-478): `document-title.ts`(`SITE_NAME`·`SITE_TITLE`·`formatDocumentTitle` — `SITE_TITLE`은 테스트가 `index.html` `<title>`과 대조해 드리프트를 막는다), `use-document-title.ts`(마운트 설정·언마운트 복원, 의존성 0), `document-meta.ts`(`useRobotsNoindex` — 셸의 robots 메타 **content를 갱신**, 메타를 추가로 만들지 않음). 정적 셸 `index.html`이 description·OG 10종·Twitter 4종(`name`)·canonical·theme-color·robots를 갖고, `public/`에 `robots.txt`(dex·profile·oauth·upload Disallow)·`sitemap.xml`(홈 1건)·`og-image.png`(1200×630)이 있다 — 셋은 `app/seo-static.test.ts`가 fs로 읽어 단정
 - 테스트 인프라 `src/test/`: `setup`, `render-with-providers`, `stub-fetch`, `envelope-response`, `occupied-grids`, `playback-fixture`, `instant-load-image`, `auth-session`(signIn/signOutForTest), `query-wrapper`(공용 QueryClient 래퍼), `robots-meta`(robots 메타 심기·조회 — MSG-478)
 
@@ -83,9 +83,9 @@
 
 전 컴포넌트 스토리 존재(RN Storybook은 `apps/mobile/.rnstorybook/main.ts` glob 자동 등록 — 파일 추가만으로 등재). `index.ts`는 MSG-420이 독점 소유했으며, 이후 모바일 화면 티켓은 export를 추가하지 않는 것이 합의다. MSG-421이 이 합의를 지킨 채 `VideoCard`에 optional `thumbnailClassName`·`overlay`(미지정 시 렌더 불변)를, `SegmentedProgress`에 `accessible`(Android는 이게 없으면 role만으로 접근성 노드를 만들지 않아 진행바가 아예 낭독되지 않는다)을 추가했다 — **컴포넌트 파일 비파괴 확장은 열려 있고 `index.ts` 추가만 닫혀 있다**.
 
-## 테스트 자산 (apps/web/src — 193개, smoke 32개) + e2e 3스펙(apps/web/e2e — 로그인 시딩 `auth-session-stub`(getMe `locationConsent: true` 스텁 포함), `consent-gate-popstate.spec.ts`는 실브라우저 히스토리 방향 판별 고정 — MSG-407)
+## 테스트 자산 (apps/web/src — 196개, smoke 32개) + e2e 3스펙(apps/web/e2e — 로그인 시딩 `auth-session-stub`(getMe `locationConsent: true` 스텁 포함), `consent-gate-popstate.spec.ts`는 실브라우저 히스토리 방향 판별 고정 — MSG-407)
 
-레이어별 분포: app 8 · entities 6 · features/ai-route 7 · features/auth 6 · features/dex 15 · features/map-home 58 · features/notifications 6 · features/profile 12 · features/region 7 · features/search 3 · features/upload 16 · features/video-actions 6 · pages 23 · shared 12 · widgets 8. 목록은 `**/*.test.*`·`**/*.smoke.test.tsx` glob으로 확인 (2026-08-28 MSG-488에서 전수 재계수 — 직전 기재값 176은 MSG-473~478 웨이브 증가분이 반영되지 않은 스테일이었다. MSG-488 신규는 8개(features/ai-route 7 + pages/ai-route smoke 1)).
+레이어별 분포: app 8 · entities 6 · features/ai-route 9 · features/auth 6 · features/dex 15 · features/map-home 58 · features/notifications 6 · features/profile 12 · features/region 7 · features/search 3 · features/upload 16 · features/video-actions 6 · pages 24 · shared 12 · widgets 8. 목록은 `**/*.test.*`·`**/*.smoke.test.tsx` glob으로 확인 (2026-08-28 MSG-488에서 전수 재계수 — 직전 기재값 176은 MSG-473~478 웨이브 증가분이 반영되지 않은 스테일이었다. MSG-488 신규는 8개(features/ai-route 7 + pages/ai-route smoke 1)).
 
 커버리지 공백(테스트 없는 로직 파일): `dex/use-collection-query`, `map-home/map-query-policy`, `profile/use-profile-image-upload`, `upload/presign-purpose`·`use-highlight-selection`·`use-upload-wizard`·`use-video-duration`, `map-shell/sidebar-store`·`use-map-shell`, `map-home/use-escape-close`, `shared/error-interceptor`·`http-client`·`navigation`
 
@@ -162,3 +162,4 @@
 - MSG-475: [웹] 줌아웃 행정 단위 집계 마커 리디자인 + 핫구역 행정 단위 집계 신설 — ① 원형 3단(size-17/20/23 + `border-3 border-background` 흰 링) 마커를 Figma `15221:20097` **말풍선**으로 교체: 라운드 10·패딩 6/12/7·링 없음·`shadow-raised`·2줄(지역명 `text-fm-label` 백 85% / 개수 `text-fm-heading font-bold` 백), 채움은 Figma 정확 일치 토큰 **`bg-secondary`**(#0071E3 — 종전 `bg-primary` #0066CC에서 이동). `CLUSTER_UNIT_SIZE_CLASS` 삭제로 **단위별 크기 3단이 사라지고** 폭만 지명 길이에 hug된다(브라우저 실측 DONG 63×48·SIGUNGU 66×48 — 높이 동일). ② 축제·팝업 칩 활성 중에는 같은 마크업에 채움만 `bg-theme-festival`/`bg-theme-popup`으로 갈린다(MSG-451 ① 규칙 — 새 색·타이포 토큰 0, `design-tokens` diff 0). ③ **핫구역 칩 저줌 집계 신설** — `use-hotzone-aggregation-query`(`GET /api/hotzones/aggregation`, BE MSG-466)를 미션 집계와 같은 축척 표·같은 상한(동 1°·구 4°·시 10° `clampBoundsToSpan`)·같은 bbox 정본(**뷰포트** — 저줌엔 "장소 불러오기"가 없어 확정 영역으로는 갱신 수단이 없다)으로 배선하고, `toHotZoneClusterMarkers`(접두 `hot-{unit}-{regionCode}`, `theme: "hot"`)로 붉은 말풍선을 띄운다. **인증 게이트 없음**(사용자별 값 없음 — MSG-463 익명 선례). `occupancy-visibility.hotCellsVisible` 신설 + `use-home-overlays` 배선으로 저줌에서 개별 핫 격자를 걷어 마커와 상호 배타를 만든다(종전엔 `gateFillCells`가 색 있는 테마 셀을 저줌에도 남겨 점으로 뭉개졌다). 집계 소스는 **칩 기준 택일**(핫 / 축제·팝업 / 칩 없음+로그인 도감) — 두 종류가 한 지도에 서지 않는다. ④ **`gridIds` 교집합 좁힘은 승인 결정으로 미구현** — 시/구 클릭은 여전히 집계 구간에 내리고 DONG 클릭 후 패널은 이미 확정 행정동으로 걸러지는데 서버가 집계·개별의 판정 집합 동일을 보장해 효과가 null 버킷뿐이다(MSG-451 `missionIds` 후속 미룸과 같은 처리). ⑤ `MARKER_MERGE_PX`(68/80/92)는 **값 불변**(주석만 갱신) — 말풍선(약 61×49, 폭 가변)과 근거가 어긋나지만 모바일 parity 테스트가 리터럴로 고정하고 RN 렌더가 원 지름으로 소비한다. 재보정은 RN 렌더 교체 티켓과 함께. **명세 재생성 안 함** — `getHotZoneAggregates`·`HotZoneRegionAggregateResponseDto`가 MSG-445 스냅샷에 이미 들어와 있었다(티켓 [참고]의 "로컬 스냅샷에 없음"이 스테일). 생성물 4파일 diff 0줄로 병렬 MSG-474와의 충돌 창을 닫았다. **`apps/mobile` diff 0줄** — 웹 `region-cluster-overlay` 변경을 타입 확장·함수 신설의 **추가만**으로 묶어 parity 3종이 모바일 무수정 통과(신규 필드는 `theme`처럼 조건부 스프레드라야 `toEqual`이 안 깨진다). **모바일 화면은 이 티켓 후 두 가지가 벌어진다** — 마커 형태(원형 3단 vs 말풍선)와 핫 칩 저줌 표시(모바일은 격자 낱개 유지, 집계 훅 없음): 별도 [모바일] 티켓 몫. 검증 실측: 브라우저 계산 스타일 전건 일치·칩 5상태 택일·드릴다운 줌 2건·**AC 13 정합(부전2동 마커 1 = 격자 줌 붉은 셀 1)**·콘솔 에러 0, e2e `cluster-zoom-gate` 무수정 2/2, 웹 1289+모바일 982 전건. 확인불가 1건 — 미판정 버킷(`regionCode` null)이 실데이터에 0건(전국 SIDO 프로브 실측)이라 단위 테스트로 대체. nose 신규 9패밀리(신설 훅·테스트 ↔ 도감·미션 형제) baseline 등재 — 3형제 훅은 게이트 조건·envelope·placeholder 정책이 9개 지점에서 갈려 공통 추출이 부적합(nose 자신의 9파라미터 판정, MSG-476 선례). **등재 시 무관 흡수 1건(`profile-edit-modal.smoke` ↔ `envelope-response` — develop에도 있던 hidden 패밀리)을 되돌렸다**(MSG-476 교훈). 참고: 흰 글자 대비가 hot 3.6:1·popup 2.2:1로 WCAG 미달이나 MSG-451부터 승계된 테마 토큰 규칙이자 Figma 정본 값 — 디자인 차원 후속 거리.
 - MSG-474: 비로그인 지도 홈 개방 — QA 3건(최초 진입 로그인 안내만 뜸 / "장소 불러오기" 미작동 / 칩 최근접 이동 안 됨)의 뿌리는 하나였다: 역지오코딩이 비로그인에서 게이트돼 **확정(commit)이 영영 생기지 않음** → `committedBounds`가 부트스트랩 초기 뷰포트에 고정 → 칩 bbox가 좁고 `currentRegion` null이라 불러오기 버튼 미생성. 티켓이 지목한 `use-nearest-entry`는 무관했다(그 훅의 center는 `viewportCenter`라 비로그인에도 null 아님). **게이트 해제 3곳**(`MapHomePage`·`RegionPanel`·`use-committed-region` — 마지막은 티켓 미기재였으나 최초 확정의 실제 소스)으로 3건이 함께 풀렸고 `use-chip-entry`·`use-nearest-entry`·`region-reload`는 **무수정** 회귀 통과. ① `RegionPanel` 로그인 유도 분기 통삭제 → 헤더·격자 카드·"전체 보기"·전체 지역 무한 스크롤이 비로그인에도 열린다(**MSG-463 확정 1을 뒤집음** — 당시 근거 "데이터원이 로그인 전용"이 explore 익명 200으로 소멸, 사용자 승인). ② 비로그인 격자 상세는 `grids/{gridId}`(응답이 occupied·내 영상 수 = 사용자별이라 익명 401이 **설계상 정상**)를 부르지 않고 **진입점 응답의 이름 재료로 조립** — `deriveHomeCellDetail`을 `viewerAuthenticated` 판별식 유니언(로그인=cell 필수 / 비로그인=entryNaming 필수)으로 확장, 비로그인은 subtitle null·"내 점령" 배지 없음. ③ 인증 **true→false 전이**에서 `QueryProvider` 한 곳이 `queryClient.clear()` — 티켓의 "쿼리 키에 인증 반영"은 생성 키에 인증 축이 없고 로그인은 이미 clear 중(로그아웃만 누락)이라 키 확장 10곳+ 대신 전이 구독 1곳을 택했다. ④ **스펙 인벤토리 밖 401 경로 2건을 구현 중 발견·차단**: `use-grid-names-query`(코스 스팟 이름 = `grids/{id}` N회)·dex `use-region-videos-query`(`collections/videos` — 비로그인 확정 지역이 생기며 처음 활성화). **실측이 범위를 두 번 바꿨다**: 티켓의 "BE 선행 전부 배포 확인"과 달리 1차 익명 curl에서 `regions/{code}/grids`·`videos/{id}`·`explore`가 401(요구 2·5·재생 블로커) → 사용자가 권한 재배포 → 2차 실측 200으로 요구 5건 전부 성립. **`api:generate` 미실행** — 라이브 `/v3/api-docs`와 레포 스냅샷이 **바이트 동일**(권한만 열리고 계약 무변경)이라 생성물 4파일 diff 0, MSG-475와의 충돌 우려도 소멸(구현 중 발견된 생성물 재생성분은 `FriendPreviewResponseDto.relation`=MSG-391 친구 기능으로 무관 → HEAD 복원). **AC 14(최종 방어선) 통과**: 비로그인 전 과정(진입→전체 보기→이동→불러오기→칩 3종→격자 상세→코스 상세→재생) `/api/` 실호출 전건 200·**401 0건·reissue 0건**·금지 7종 0건. **재작업 1회차**: ① 모바일 `home-cell-detail.parity.test.ts`가 웹 파생 함수를 구 시그니처로 동적 import해 깨짐 — 빌더가 `--filter web`만 돌려 놓쳤고 루트 게이트가 잡았다(**MSG-476과 동일 재발** — 웹 파생 함수를 바꾸는 티켓은 모바일 패리티 앵커를 먼저 조회할 것), 타입까지 새 계약에 묶어 다음 드리프트를 typecheck가 잡게 함 ② e2e `consent-gate-popstate`가 익명 렌더 증거로 삭제 대상인 "로그인" 버튼을 단정 → 확정 행정동 heading으로 교체(게이트 본래 단정 무변경) ③ nose 신규 6패밀리 개별 검토 후 추출 대상 0건 판정·베이스라인 재등재. **BE 환류 2건**: 코스 스팟(`CourseSpotDto`)이 좌표만 줘 비로그인 코스 스팟 상세에 행정동 줄 없음(AC 11 부분, FE로 메울 수 없음) · dev 재생 미디어가 S3 키를 `https%3A//dev.local/seed/….m3u8`로 저장해 403(AC 12 프레임 미표시 — FE 계약은 성립, 시드 데이터 결함). 확인불가 2건은 로그인 상태 브라우저 회귀(카카오 세션 부재, MSG-463 선례)
 - MSG-488: [웹] AI 경로추천 페이지 신설 (`/ai-route`) — 자연어 문장 → `POST /api/routes/recommend` → 좌측 388px 패널 카드 리스트 + 지도 오버레이(번호 마커·격자 초록 틴트·이웃 직선). **라우트명은 티켓 가칭 `/route`에서 `/ai-route`로 변경**(사용자 승인) — 코드베이스에 `route`가 이미 3중 의미(`ROUTES` react-router 상수 · `ThemeId "route"` = 기존 코스 칩 "경로추천"으로 같은 초록 `theme-route`까지 공유 · `map-overlay-store.routes`)라 동음이의를 피했다. **로그인 전용** — 2026-08-28 익명 POST 실측이 `401 {developCode:2403}`이라 `RequireAuth` + 레일 항목 비로그인 클릭 시 `login-modal-store` 게이트. **결과 도착 시 지도를 이동·확대하지 않는다**(카드 클릭만 `moveTo`, 줌 불변) — 사용자가 보던 범위를 뺏지 않는 것이 이 티켓의 계약이고, 자동 이동은 MSG-489 몫. **재사용 성과: 신규 렌더 코드가 거의 없다** — `map-overlay-store`에 이미 `routes`(폴리라인 + 번호 경유지)·`cells`(색·빗금) 슬롯이 있어 MapShell→MapCanvas 렌더 경로를 통째로 썼고, MapCanvas 추가분은 경유지 `onClick` 슬롯 + `active` 강조뿐(`onRouteWaypointClick` 미제공이면 기존 코스 마커는 비클릭 그대로). 오버레이 파생은 순수 함수 `route-overlay.ts`에 두어 RN 경계 유지(`features/`·`model/`에 `naver` import 0건). 승격 2건: ui-web **`Skeleton`** 신설(레포 첫 스켈레톤 — 착수 전제였던 "GalleryTabBody가 첫 사용처"는 실측 오류였다. `GallerySkeleton`은 `DotsLoader` 래퍼이고 MSG-403이 의도적으로 도트로 통일한 자리라 미접촉), **`RetryNotice`**를 `pages/map-home/ui/` → ui-web 이동(재사용 시 pages→pages import가 되므로 — 소비 8파일은 import 한 줄씩만 변경). 마커 스타일은 Figma 정본(28px `size-7` + `border-2 border-background` + `shadow-raised`)으로 갱신했고 `routeMarkerContent` 공유상 **기존 코스 칩 경유지 마커도 함께 바뀌는 것을 사용자가 승인**(두 마커가 같은 초록이라 통일이 낫다는 판단 — `markerStyle` 분기 미생성). 결과 부족 배너는 **FE 고정 문구**이고 서버 `notice`는 null 여부 신호로만 쓴다(문자열 미노출을 `not.toContain`으로 고정), 0곳이면 카드·오버레이 없이 배너만. **웨이브 2 병렬 머지를 위해 파일 소유권을 설계 산출물로 명시**(정본 `docs/spec/MSG-488.md` §4-2): 489(상태·요청·입력카드 계열)와 490(구간거리·오버레이 기하·walk-paths 계열)의 **교차 파일 0건**, 공유 파일 `AiRoutePage.tsx`도 489만 2줄·490은 0줄, 셸·렌더·라우트·레일·ui-web은 488이 완결(둘 다 0줄). 확장점 주석 3종을 지정 위치에 심었고 489·490 신규 예정 파일은 하나도 만들지 않았다. **검증 실측**: 남아 있던 리프레시 쿠키로 실계정 자동 재발급이 돼 **실 API 8곳 응답**으로 브라우저 검증 — 지도 미이동(축척바 100m 불변) · 8→3→2→0곳 4회 연속 갱신 잔상 0 · 도감 왕복 후 복원 + **재요청 0회** · 실패 7경로 전건 · Figma 4프레임 오탐 목록 밖 편차 0 · 콘솔 에러 0. 확인불가 1건 — 빗금(점령 격자 교집합)이 실데이터에 발생하지 않아 육안 불가, 단위 테스트로 대체. a11y 지적 1건 즉시 반영: `RouteResultHeader`(`role="status"`)가 자체 `role="status"`를 가진 `DotsLoader`를 감싸 낭독이 실제로 중복돼(`"동선 찾는 중 동선 찾는 중"`) 도트를 `aria-hidden`으로 감쌌다(ui-web 무수정). **nose 중복 게이트는 착수 전부터 red**였고 근원이 이 티켓 자신의 웨이브 0 openapi 커밋(`107aa59`)이라 재등재했다 — 검증자가 `git archive HEAD`로 워크트리 밖에 풀어 재현해 HEAD 시점 3패밀리가 빌더 지목 id와 일치함을 독립 확인(숨어든 진짜 중복 0). **알려진 한계**: `gateFillCells`가 `zoom < 16`에서 채움 셀을 버려 넓게 본 상태에서 요청하면 격자 초록 틴트가 안 보인다(마커·선은 남음) — MSG-489의 1km 축척 고정이 해소한다. **489 선행 경고**: "지도 위 현재 위치 점"을 그릴 슬롯이 `MapCanvasProps`에 없어(`MapLabelOverlay`는 텍스트 pill, `waypoints`는 번호 뱃지) 489가 "488 완결·489 0줄"로 선언된 `MapCanvas.tsx`를 다시 열 공산이 크다 — 489∥490 병렬성 자체는 안 깨진다. **스펙 각주 누락 1건**: Figma 결과·결과 부족 프레임 양쪽에 "축제, 팝업, 코스, 행사 정보와…" 각주가 있는데 스펙은 로딩 화면에만 기재 — 디자인 정본을 따라 양쪽에 렌더.
+- MSG-489: [웹] AI 경로추천 — `mentionedArea` 자동 이동·1km 축척 고정·2차 자동 재요청·출발지(origin) 자동 판정. **웨이브 2 = 490(walk-paths)과 동시 진행** — `docs/spec/MSG-488.md` §4-2 소유권 표의 489열만 접촉, 접촉 금지 15경로 diff 0줄(검증자 감사), `MapCanvas.tsx` 0줄(현재 위치 점은 **Figma 12402·13139에 노드가 없어 제외** — 488의 "489가 MapCanvas를 다시 열 공산" 경고는 디자인 근거가 없었다). **착수 전 실측 2건이 설계를 결정했다**: ① 2차 자동 재요청은 서버 10초 rate limit **예외가 아니다**(로그인 세션 연속 호출 → 두 번째 `429/14429`, 1차 요청 시작 +11s는 200, `Retry-After` 없음) → 1차 `requestedAt` 기준 `10.5s` 잔여 대기 후 발사, 대기·2차 중 패널은 로딩·1차 결과 미게시, 2차 mentionedArea 무시(1회 한정), 2차 14429면 기존 에러 매핑. 브라우저 실측 간격 11,174ms·recommend 정확히 2회. ② `shared/geolocation.getCurrentPosition()`이 **권한 거부를 삼키고 서면 좌표를 돌려줘** 거부 사용자에게도 origin이 전송되는 오판정 → 가산 export `getCurrentPositionOrNull`(사용자 승인, 기존 소비 3곳 무수정). **488 "알려진 한계" 정정**: `gateFillCells`는 `zoom<16`에서 *색 있는 셀을 남기는* 필터이고 AI 경로 셀은 전부 `theme-route` 색이라 게이트를 **통과한다**(zoom 13에서 폴리곤 8개 DOM 실측, `fill=#34C759`) — 다만 1km 축척에선 셀이 6~7px이라 28px 마커에 가려 육안으로는 안 보인다. "1km 고정이 해소한다"는 서술은 성립하지 않으며 이는 홈과 동일한 저줌 공통 동작으로 수용(`MAP_SCALE_1KM_ZOOM`=13 < `GRID_MIN_ZOOM`=16). **설계 결정**: 제출·정규화·측위·이동·2차 예약을 훅 하나(`use-ai-route-auto-move`)가 소유해 `AiRoutePage.tsx`가 스펙 "2줄" 상한을 -w 기준 +14/−12로 넘겼다(제출 로직 7줄이 페이지에서 빠짐 — 490은 이 파일 0줄이라 병렬성 불변); 2차 발사는 `bounds` **참조 변경** AND 시간 경과 두 조건(이동 직후 즉시 쏘면 옛 bounds, `ZOOM_OUT`은 중심이 옛 뷰포트 안이라 중심 판정만으론 못 막음); 예약 플래그를 스토어에 둬 대기 중 섹션 이탈·StrictMode 2회 실행에서도 영구 로딩·중복 발사 없음; 토스트 조사는 받침 판정 순수 함수("서면으로", ㄹ 받침 예외 포함). 0.5도 예방(뷰포트 한 변 >0.5°면 중심 기준 1km로 먼저 맞추고 요청, 토스트 없음) 실측: span 0.7° 제출 → 요청 1회·14401 없음. ui-web `Toast` dark가 Figma 15675:3267과 1:1이라 승격 0건, Figma 편차 0(computed style 실측). **검증 실측**: 수용 기준 28개(L19+S9) 전건 통과·확인불가 0, Chrome 위치 권한 granted + 실좌표가 서면 안이라 S1 "안 → 표시"를 브라우저에서 직접 판정, 토스트 3초 소멸, 2차 로딩 전 구간 1차 잔상 0, 콘솔 0. 중복 게이트 재등재 +11/−6 전부 489 변경 파일 포함(무관 흡수 0), `setGeolocation` 3복제는 `src/test/geolocation.ts`로 추출. **후속 후보**: 0.5도 정규화 대기 중(네이버 다단 줌 애니메이션이 `idle`을 늦게 내 실측 14.2초) 로딩 피드백 없음 — 정규화 대기에도 로딩 상태를 켜면 해소; 2차 인스턴스에 `onLoginRequired` 미부착(1차 성공 직후 세션 만료 경로는 수용 기준 밖).
diff --git a/docs/decisions/DECISIONS.md b/docs/decisions/DECISIONS.md
index 29bd146c..23fda76e 100644
--- a/docs/decisions/DECISIONS.md
+++ b/docs/decisions/DECISIONS.md
@@ -420,3 +420,7 @@
 | 2026-08-28 | MSG-488 | 결정: `kindTag`가 tailwind 클래스가 아니라 **tone(의미)** 4종(`place`·`festival`·`popup`·`route`)을 반환하고, 토큰 클래스 매핑은 뷰(`RouteStopCard.TONE_CLASS`)가 소유 | 대안 ①모델이 클래스 문자열 반환(`theme-classes.ts` 선례): 짧지만 model 레이어가 웹 스타일 체계를 알게 돼 RN 재사용 시 그대로 못 옮긴다 ②태그 전부를 뷰로: L2가 모델 유닛으로 매핑을 못박게 요구한다. tone 유니언은 라벨/색을 한 소스에서 갈라두면서 경계를 지킨다 — 색 4종 중 2종(EVENT·MISSION_FESTIVAL)이 같은 tone을 공유하는 승인 Q3도 한 곳에서 표현된다 |
 | 2026-08-28 | MSG-488 | 결정: 로딩·결과 공통 각주("축제, 팝업, 코스, 행사 정보와 장소 검색 결과로만 추천해요")를 **결과 상태에도** 렌더 (스펙 S4는 로딩만 명시) | Figma 정본 15666:12855·13416 두 프레임 모두 리스트 아래에 같은 각주를 그렸다. 스펙 S5가 각주를 언급하지 않은 것은 누락으로 판단 — 디자인 정본을 따르고 빌드 리포트에 "스펙과 달라진 점"으로 기록했다. 반대로 스펙만 따르면 결과 화면이 Figma와 어긋나 검증에서 결함으로 잡힌다 |
 | 2026-08-28 | MSG-488 | 결정: `nose.baseline.json` 전량 재등재(437 패밀리, +30/−26). 감사 결과 **member 파일이 전부 이 티켓 변경 집합 밖인 추가 패밀리 9건** 중 3건(`1fff7443bd`·`6ead82d6f3` new, `d5c756408e` changed)은 착수 전 HEAD(107aa59, MSG-488 웨이브 0 openapi 스냅샷)에서 이미 off-baseline이었고, 나머지 6건은 내 편집이 이웃 패밀리를 재분할하며 생긴 재키잉이다 | MSG-475가 세운 "등재 후 무관 흡수 감사" 규칙 적용. 9건을 손으로 되돌리는 대안은 기각 — 재키잉 6건은 되돌리면 파티션이 깨져 baseline이 코드와 불일치하고, 나머지 3건의 드리프트 근원이 이 티켓 자신의 웨이브 0 커밋이라 in-scope다. 되돌림 대신 id 단위 실측을 리포트·이 로그에 남겨 추적 가능하게 한다 |
+| 2026-08-28 | MSG-489 | 결정: 제출·출발지 판정·자동 이동·2차 재요청을 **한 훅**(`pages/ai-route/ui/use-ai-route-auto-move.ts`)에 모으고, 스펙 §4-1이 정한 `AiRoutePage.tsx` "2줄" 상한을 -w 기준 +14/−12로 넘겼다 | 대안 ①스펙 §4-2 문면대로 `submit()`을 페이지에 남기기: 0.5도 정규화 대기·현위치 1회 측위·출발지 재판정이 전부 페이지로 올라와 오히려 diff가 커지고 자동 이동 훅과 재료(coords·bounds·requestedAt)를 이중으로 들게 된다 ②훅을 둘로 쪼개기: 같은 재료를 두 훅이 각각 구독해 측위가 2회 나간다. 실제 증가분 10줄 중 3줄은 `<RouteToastHost />`+fragment, 나머지는 D9 버튼 문구·S1 표시 행 배선이라 티켓 요구로 전부 소급된다 |
+| 2026-08-28 | MSG-489 | 결정: 2차 재요청 발사 조건을 "`viewport-store.bounds` **참조 변경** + `requestedAt + 10.5s` 경과" 두 조건 AND로 두고, 예약 상태(`secondaryPending`)를 스토어에 둔다 | 대안 ①이동 명령 직후 즉시 mutate: 옛 bounds로 쏜다(스펙 R3) ②목표 중심이 bounds 안인지로만 판정: `kind=ZOOM_OUT`은 중심이 이미 옛 뷰포트 안이라 즉시 통과해 R3를 못 막는다 ③예약을 훅 로컬 ref로: 대기 중 섹션 이탈 시 예약이 소실돼 패널이 영구 로딩으로 남는다. 스토어에 두면 재진입이 예약을 이어받고, `onMutate`가 끄므로 중복 발사도 같은 플래그로 막힌다 |
+| 2026-08-28 | MSG-489 | 결정: 토스트 제목의 조사를 리터럴 "(으)로"가 아니라 **받침 판정 순수 함수**로 확정한다("부산 서면으로 이동했어요"). 스펙 L10이 인용한 문자열은 기획 표기 관례로 판단 | 대안 ①L10 문자열 그대로 렌더: 사용자에게 "(으)로"가 그대로 보인다 ②서버가 조사를 실어 주기: 계약 변경이 필요하고 이 티켓은 "서버 API는 그대로"가 전제. ㄹ 받침이 "로"를 쓰는 예외까지 3케이스로 고정했다(오케스트레이터 지시) |
+| 2026-08-28 | MSG-489 | 결정: 결과 상태(`status === "result"`)에서는 "현재 위치에서 출발" 표시 행을 숨기고 버튼 문구로만 출발지를 알린다 | Figma 15666:13139(origin 결과)에 그 행이 없고 스펙 §8 오탐 방지 5가 "의도된 동작"으로 못박았다. 라이브 판정(`현위치 ∈ 현재 bounds`)만 쓰면 결과 화면에서도 계속 떠 Figma와 어긋난다 |
diff --git a/docs/spec/MSG-489.md b/docs/spec/MSG-489.md
new file mode 100644
index 00000000..792fc27e
--- /dev/null
+++ b/docs/spec/MSG-489.md
@@ -0,0 +1,270 @@
+# MSG-489: 경로추천 자동 동작 — 출발지 자동 판정 · mentionedArea 지역 이동 + 1km 축척 고정 + 2차 자동 재요청 · 토스트
+
+> 원문: `_workspace/MSG-489/00_ticket.md` (2026-08-28 FE 재작성본이 정본, 하단 `<details>`는 BE 초안)
+> 선행: MSG-488(머지 완료, `docs/spec/MSG-488.md`) · 병렬: MSG-490(walk-paths — 다른 워크트리 동시 진행)
+
+## 기획 요약
+
+MSG-488이 만든 `/ai-route` 패널(문장 → `POST /api/routes/recommend` → 카드 + 지도 오버레이) 위에 **세 가지 자동 동작**을 얹는다. ① 요청 시점에 현위치가 뷰포트 안이면 `origin`을 자동으로 실어 보내고 입력 카드에 "현재 위치에서 출발" 상태를 표시한다(토글 아님·컨트롤 아님). ② 1차 응답에 `mentionedArea`가 실리면 **확인 없이** 그 중심으로 지도를 옮기고 줌을 `MAP_SCALE_1KM_ZOOM`으로 고정한 뒤 안내 토스트를 띄우고 **새 뷰포트로 2차 요청을 자동 발사**한다(1회 한정, 1차 결과는 그리지 않는다). ③ 1차 요청 전 뷰포트가 너무 넓으면 같은 1km 단으로 먼저 정규화해 서버 상한(14401)을 예방한다. 서버 API 계약은 그대로다.
+
+---
+
+## 1. 사용자 확정 결정 (2026-08-28 — 이 스펙의 전제, 재질문 없음)
+
+| # | 결정 |
+|---|---|
+| D1 | 1차 요청은 **현재 뷰포트 그대로** (488 계약 유지) |
+| D2 | 응답 `mentionedArea`가 있으면 **확인 없이** `centerLat/centerLng`로 `moveTo` + `zoomTo(MAP_SCALE_1KM_ZOOM)` |
+| D3 | 이동 직후 토스트 — 제목 `{name}(으)로 이동했어요` / 본문 `지도 범위 약 1km 기준으로 동선을 짜요` |
+| D4 | 새 뷰포트로 **2차 요청 자동 발사** — 세션당 요청 사이클 1회 한정, 2차 응답의 `mentionedArea`는 무시 |
+| D5 | 2차 진행 중 패널은 **로딩(스켈레톤)**, 1차 결과는 스토어에도 오버레이에도 게시하지 않는다 |
+| D6 | `kind = ZOOM_OUT`도 MOVE와 **동일 처리**. `fitBounds`는 채택하지 않는다 |
+| D7 | Figma 12621 토스트 본문의 "약 2km"는 **1km로 정정**해 구현 |
+| D8 | 출발지 자동 판정 — 현위치 확보 && 뷰포트 안 → `origin` 전송 + "현재 위치에서 출발" 표시(누르는 컨트롤 아님). 밖·거부·미확보 → 생략·표시 없음 |
+| D9 | `origin`을 보낸 결과 화면의 제출 버튼 라벨은 **"현재 위치에서 다시 짜기"**, 아니면 "다시 짜기" |
+
+---
+
+## 2. 수용 기준
+
+### 2-A. 로직 기준 (vitest)
+
+| # | 기준 | 검증 대상 |
+|---|------|----------|
+| L1 | `resolveRouteOrigin({ coords, bounds })` — 좌표가 bounds 안이면 `{ lat, lng }`를 반환한다 | `route-origin.ts` |
+| L2 | 좌표가 bounds 밖이면 `null`을 반환한다 (경도·위도 각각 벗어난 2케이스) | `route-origin.ts` |
+| L3 | `coords`가 `null`(미확보·권한 거부)이면 `null`을 반환한다 | `route-origin.ts` |
+| L4 | `bounds`가 `null`(지도 미준비)이면 `null`을 반환한다 | `route-origin.ts` |
+| L5 | 경계선 위 좌표(`lat === sw.lat` 등)는 **안**으로 판정한다(포함 경계) | `route-origin.ts` |
+| L6 | `resolveAutoMove({ mentionedArea, alreadyMoved: false })` — `kind: "MOVE"`면 `{ center: { lat: centerLat, lng: centerLng }, zoom: MAP_SCALE_1KM_ZOOM, areaName: name }`을 반환한다 | `route-mentioned-area.ts` |
+| L7 | `kind: "ZOOM_OUT"`이 **L6과 완전히 같은 결과**를 낸다(`toEqual` 동치) | `route-mentioned-area.ts` |
+| L8 | `mentionedArea === null`이면 `null`을 반환한다 | `route-mentioned-area.ts` |
+| L9 | `alreadyMoved: true`면 `mentionedArea`가 실려 있어도 `null`을 반환한다 (2차 응답 무시 = 무한 루프 차단) | `route-mentioned-area.ts` |
+| L10 | 토스트 문구 파생이 제목 `"부산 서면(으)로 이동했어요"` · 본문 `"지도 범위 약 1km 기준으로 동선을 짜요"`를 내고, **"2km"를 포함하지 않는다**(`not.toContain("2km")`) | `route-mentioned-area.ts` |
+| L11 | `buildRecommendBody`에 `origin`을 주면 body에 `origin: { lat, lng }`가 붙고, 주지 않으면 **`origin` 키 자체가 없다**(`not.toHaveProperty`) | `route-request.ts` |
+| L12 | `needsSpanNormalize(bounds)` — 위·경도 어느 한 변이라도 span > 0.5도면 `true`, 0.5도 이하면 `false`, `null` bounds면 `false` | `route-request.ts` |
+| L13 | `submitLabel({ status, originSent })` — `origin`을 실어 보낸 결과 상태면 `"현재 위치에서 다시 짜기"`, 아니면 `"다시 짜기"`, 최초 입력 대기는 `"동선 짜기"` | `route-request.ts` |
+| L14 | 스토어: 2차 요청 시작 시 `status === "loading"` && `points.length === 0`(1차 결과 미게시) && `autoMoved === true` | `ai-route-store.ts` |
+| L15 | 스토어: 새 1차 요청(`startRequest`)이 `autoMoved`·`originSent`·`movedAreaName`을 초기화한다 | `ai-route-store.ts` |
+| L16 | `use-ai-route-auto-move` — `mentionedArea`가 실린 1차 응답에서 `moveTo` 1회 + `zoomTo(MAP_SCALE_1KM_ZOOM)` 1회 + 2차 `mutate` 1회를 호출한다 | `use-ai-route-auto-move.ts` |
+| L17 | 같은 훅 — 2차 응답에 `mentionedArea`가 또 실려도 `moveTo`·`zoomTo`·`mutate` **추가 호출 0회**(총 호출 수 불변) | `use-ai-route-auto-move.ts` |
+| L18 | 같은 훅 — 2차 요청 body의 `viewport`가 **이동 후 새 bounds**로 만들어진다(1차 bounds와 다름) | `use-ai-route-auto-move.ts` |
+| L19 | 2차 요청의 `origin`은 **새 뷰포트 기준으로 재판정**된다 — 1차에서 안이었어도 이동 후 밖이면 2차 body에 `origin`이 없다 (추정 A5) | `use-ai-route-auto-move.ts` |
+
+### 2-B. 화면 기준 (브라우저 실동작 + Figma 대조)
+
+| # | 기준 | 검증 방법 |
+|---|------|----------|
+| S1 | 현위치가 뷰포트 안일 때 입력 카드 하단 좌측에 내비 아이콘(13px) + "현재 위치에서 출발"이 `text-fm-label text-foreground-muted`로 뜬다 (Figma 15666:12571) | 브라우저 + Figma |
+| S2 | 현위치가 뷰포트 밖이거나 권한 거부/미확보면 그 행이 **없고**, 제출·요청은 정상 동작한다 | 브라우저 |
+| S3 | 지역명이 든 문장으로 제출하면 지도 중심이 그 지역으로 이동하고, 축척 바가 **"1km"**를 표시한다 | 브라우저 |
+| S4 | 이동과 함께 지도 상단 중앙에 다크 토스트(제목 + 본문 2줄, `i` 원형 배지)가 뜨고 3초 뒤 사라진다. 본문이 "약 1km"다 (Figma 15675:3267) | 브라우저 + Figma |
+| S5 | 2차 요청 진행 중 패널이 스켈레톤 3장 + "동선 찾는 중"이고, **1차 결과 카드·지도 마커·격자 틴트가 전혀 나타나지 않는다** | 브라우저 |
+| S6 | 2차 응답 도착 후 카드와 지도 오버레이가 새 지역 기준으로 그려지고, **추가 요청이 발생하지 않는다**(네트워크 탭 `recommend` 총 2회) | 브라우저 + Network |
+| S7 | `origin`을 실어 보낸 결과 화면의 제출 버튼 라벨이 "현재 위치에서 다시 짜기"다 (Figma 15666:13139) | 브라우저 + Figma |
+| S8 | 뷰포트를 0.5도보다 넓게 줌아웃한 상태에서 제출하면 요청 전에 지도가 1km 단으로 좁혀지고, 14401 에러 안내가 뜨지 않는다 | 브라우저 |
+| S9 | 위 전 과정에서 콘솔 에러 0건 | 브라우저 콘솔 |
+
+**검증 프로파일**: **화면** — 자동 이동·토스트·입력 카드 표시 행·버튼 라벨이 모두 시각 결과이고 Figma 정본 노드(12402·12621/15675:3267·13139)와 대조해야 한다. 로직 기준이 19개로 많지만 화면·로직이 섞이면 넓은 쪽으로 판정한다(스킬 절차 4).
+
+---
+
+## 3. 코드베이스 현황 (실측 — STATUS.md 22·35·56·164행 + 소스 확인)
+
+| 사실 | 실측 |
+|---|---|
+| `MAP_SCALE_1KM_ZOOM` | `MIN_ZOOM(6) + SCALE_BY_ZOOM.indexOf("1km")(7)` = **13** |
+| `GRID_MIN_ZOOM` | **16** (`grid-overlay.ts:28`) |
+| `gateFillCells` | `zoom >= 16 ? cells : cells.filter(c => c.color !== undefined)` — **색이 있는 셀은 저줌에서도 남긴다** |
+| AI 경로 격자 틴트 셀 | `buildAiRouteOverlay`가 `color: palette["theme-route"]`를 **항상 채운다** → 게이트를 통과한다 |
+| `MentionedAreaDto` | `{ name, centerLat, centerLng, minLat, minLng, maxLat, maxLng, kind: string }` — **`kind`는 유니언이 아니라 raw `string`** |
+| `OriginDto` / 요청 | `RouteRecommendRequestDto = { text, viewport, origin?: { lat, lng } }` — optional |
+| 현위치 조회 | `shared/geolocation.getCurrentPosition()` — **실패·거부를 삼키고 `SEOMYEON_CENTER`로 폴백**한다. 현위치 전용 스토어는 **없다** |
+| 지도 명령 | `use-map-shell`: `moveTo`·`zoomTo`·`fitBounds`·`locate` 전부 이미 있다 |
+| 뷰포트 | `viewport-store`: `{ center, zoom, bounds }` — MapCanvas idle이 밀어 넣는다 |
+| locate 버튼 | 이미 `MapShell` → `MapCanvas onLocate`로 지도 우측에 상시 렌더 — **489가 새로 만들 것이 없다** |
+| ui-web `Toast` | dark 변형이 Figma 15675:3267과 구조·토큰 일치(면 `bg-foreground`, `shadow-toast`, 아이콘 `size-7.5 bg-primary`, 제목 14/600, 본문 12 `/65`) — **무수정 재사용** |
+| 3초 자동 소멸 | `features/video-actions/model/use-auto-dismiss-toast` 존재 — cross-feature 재사용 선례 있음(`invalidate-grid-queries`) |
+| `clampBoundsToSpan(bounds, capDeg)` | `features/map-home/model/aggregation-unit.ts:47` — 0.5도 판정에 참고 가능(단 489는 "좁혀서 보내기"가 아니라 "줌을 바꾸고 보내기"라 직접 소비는 안 한다) |
+
+---
+
+## 4. 구현 계획
+
+- **브랜치**: `feat/ai-route-mentioned-area-auto-move-origin` — **이미 체크아웃된 현재 브랜치**(워크트리 `sc-quantum-josephson-b882`). 신규 생성 없음. 원격에 `*489*` 브랜치 없음(`git ls-remote` 실측)
+
+### 4-1. 파일 소유권 (MSG-488 §4-2 표 준수 — 490과 교차 0)
+
+**확장 (5)**
+
+| 파일 | 변경 |
+|---|---|
+| `features/ai-route/model/ai-route-store.ts` | `autoMoved`(2차 발사 1회 한정 플래그)·`originSent`·`movedAreaName` 필드 + `startSecondaryRequest()` 액션. `startRequest`가 3필드를 초기화 |
+| `features/ai-route/model/route-request.ts` | `buildRecommendBody`에 optional `origin` 병합 · `needsSpanNormalize(bounds)` 신설 · `submitLabel({ status, originSent })` 신설 |
+| `features/ai-route/api/use-route-recommend.ts` | `onSuccess`에서 1차/2차 구분 — 2차 발사가 필요한 응답이면 스토어에 **결과를 게시하지 않고** 로딩을 유지한다(D5). 콜백 `onAutoMove(area)` 추가 |
+| `pages/ai-route/ui/RouteInputCard.tsx` | `[MSG-489 확장점]`(45행) 자리에 `originActive` prop 기반 "현재 위치에서 출발" 행. `submitLabel`은 이미 prop이라 시그니처 불변 |
+| `pages/ai-route/AiRoutePage.tsx` | **2줄만** — `useAiRouteAutoMove(...)` 마운트(94행 확장점) + `<RouteToastHost />` |
+
+**신규 (4)**
+
+| 파일 | 책임 |
+|---|---|
+| `features/ai-route/model/route-origin.ts` | `resolveRouteOrigin({ coords, bounds })` 순수 판정 (L1~L5). 지도 SDK·`navigator` 미참조 — RN 재사용 대상 |
+| `features/ai-route/model/route-mentioned-area.ts` | `resolveAutoMove({ mentionedArea, alreadyMoved })` + 토스트 문구 파생 (L6~L10). 순수 |
+| `pages/ai-route/ui/use-ai-route-auto-move.ts` | 자동 이동 오케스트레이션 — `moveTo`·`zoomTo` 명령, 새 bounds 확정 후 2차 `mutate`, origin 재판정 (L16~L19) |
+| `pages/ai-route/ui/RouteToastHost.tsx` | ui-web `Toast`(dark) + `useAutoDismissToast` 3초. 지도 상단 중앙 배치 |
+
+**소비만**: `features/map-home/model/map-scale.ts`의 `MAP_SCALE_1KM_ZOOM` · `widgets/map-shell/use-map-shell.ts`의 `moveTo`/`zoomTo` · `features/map-home/model/viewport-store.ts` · `features/video-actions/model/use-auto-dismiss-toast` (전부 import만, diff 0줄)
+
+**접촉 금지 (490 소유 또는 488 완결)**: `route-legs.ts` · `use-route-legs.ts` · `RouteWalkConnector.tsx` · `route-overlay.ts` · `use-walk-paths-query.ts` · `map-overlay-store.ts` · `MapShell.tsx` · `MapCanvas.tsx` · `packages/ui-web/*` · `app/routes.ts` · `router.tsx` · `SideRailNav.tsx`
+
+**표에 없는 파일 2건 — 명시 승인 대상** (둘 다 MSG-490은 미접촉이라 병렬성 불변):
+1. `shared/geolocation.ts` — 추정 A1 참조 (**가산 export만**)
+2. `pages/ai-route/ai-route-panel.smoke.test.tsx` — 기존 488 스모크에 S1·S2 케이스 추가
+
+### 4-2. 데이터 흐름
+
+`AiRoutePage`가 `submit()`에서 ① `needsSpanNormalize(bounds)`면 `zoomTo(MAP_SCALE_1KM_ZOOM)`를 먼저 부르고 새 bounds를 기다린 뒤 ② `resolveRouteOrigin({ coords, bounds })`로 `origin`을 판정해 ③ `buildRecommendBody({ text, bounds, origin })`을 쏜다 → `use-route-recommend.onSuccess`가 `resolveAutoMove`를 물어 **null이면 종전대로 `succeed()`**, **비-null이면 결과를 버리고 `startSecondaryRequest()` + `onAutoMove(area)`** → `use-ai-route-auto-move`가 `moveTo(center)` + `zoomTo(MAP_SCALE_1KM_ZOOM)`를 실행하고 토스트를 세우며, `viewport-store.bounds`가 새 값으로 갱신되는 것을 보고 origin을 **재판정**해 2차 `mutate` 1회를 쏜다 → 2차 응답은 `alreadyMoved: true`라 `resolveAutoMove`가 항상 null → `succeed()`로 카드·오버레이가 그려진다.
+
+지도 이동은 `use-map-shell` 명령 → MapCanvas → idle 이벤트 → `viewport-store` 경로를 그대로 타므로 홈의 다른 소비자(격자 오버레이·집계 마커)와 반영 경로가 같다(티켓 요구).
+
+- **재사용**: ui-web `Toast`(dark, 무수정) · ui-web `Button`(라벨만 교체) · `use-auto-dismiss-toast` · `use-map-shell` 명령 4종 · `viewport-store` · `MAP_SCALE_1KM_ZOOM`
+- **신규 로직 배치**: 순수 판정 2개는 `features/ai-route/model/`(RN 재사용 대상), 지도 명령·요청 오케스트레이션은 `pages/ai-route/ui/`(웹 뷰 계층) — 488이 세운 경계 유지
+- **라우트**: 변경 없음 (`/ai-route`)
+- **승격 후보**: **없음** — Figma 토스트가 ui-web `Toast` dark와 1:1이라 `packages/ui-web` diff 0줄
+- **모바일**: `apps/mobile`·`packages/ui-native` diff 0줄, parity 테스트 신설 없음
+
+---
+
+## 5. 디자인 토큰 매핑 (MSG-488 §6 형식)
+
+Figma 정본: 섹션 15666:12401 — `15666:12402`(대기 + 출발 표시) · `15666:12621`(로딩 + 토스트) · `15666:13139`(origin 결과)
+
+| 용도 | Figma | Tailwind |
+|---|---|---|
+| "현재 위치에서 출발" 문구 | `FeelMap/Label` 12/15 500 + `color/muted` | `text-fm-label text-foreground-muted` |
+| 내비 아이콘 | 13×13 벡터(`nav-icon`, 15666:12572) — lucide `Navigation` 대체 | `size-3.25` 상당(→ 실제 클래스는 구현 시 토큰 스케일로 확정), `text-foreground-muted` |
+| 출발 표시 행 간격 | gap 5 | `gap-1.25` (없으면 `gap-1`, 오탐 방지 목록 참조) |
+| 토스트 면 | `color/text-primary`(#1D1D1F) + `radius/lg` 16 + `FeelMap/Shadow/Toast` | ui-web `Toast variant="dark"` (`bg-foreground rounded-lg shadow-toast`) — **무수정** |
+| 토스트 아이콘 배지 | `color/primary` 원 30px + `on-primary` "i" | ui-web `Toast` 기본 (`size-7.5 bg-primary`) |
+| 토스트 제목 | `FeelMap/Base` 14 semibold + `color/text-inverse` | ui-web 내부 `text-fm-base font-semibold text-foreground-inverse` |
+| 토스트 본문 | 12 regular + `rgba(255,255,255,0.64)` | ui-web 내부 `text-fm-label text-foreground-inverse/65` (64 vs 65 — 오탐 방지) |
+| 토스트 폭·위치 | w 342, 지도 상단 중앙(left 779 / top 84 = 패널 우측 영역 중앙) | `w-85.5` 상당 고정 대신 `max-w-*` + 중앙 정렬 — 구현 시 결정, px 임의값 금지 |
+| 제출 버튼 | `FeelMap Button(primary·sm)` `radius/sm` 8 | ui-web `Button variant="primary" size="sm"` (488 그대로, 라벨만 교체) |
+
+**px 임의값 금지**(DESIGN_SYSTEM 규칙 1 — oxlint 기계 강제).
+
+---
+
+## 6. 추정 (승인 대상 — 티켓에 없어 채운 것)
+
+- **A1. 현위치 조회 어댑터 확장** — 티켓은 "권한 거부·미확보면 origin 생략"을 요구하는데, 현행 `shared/geolocation.getCurrentPosition()`은 **거부·실패를 삼키고 서면 좌표를 돌려준다**. MVP 지역이 서면이라 폴백 좌표가 뷰포트 안에 들어와 **거부한 사용자에게도 origin이 전송되는 오판정**이 난다. → `shared/geolocation.ts`에 **가산 export** `getCurrentPositionOrNull(): Promise<GeoCoords | null>`(실패 시 `null`)를 추가하고 기존 `getCurrentPosition`은 그 위에 폴백을 씌워 재구성한다. 기존 소비 3곳(`MapShell` 2·`use-region-stat-query` 1) 무수정. **파일 소유권 표에 없는 파일이라 명시 승인이 필요하다**(490 미접촉 확인됨).
+- **A2. 0.5도 예방의 실행 방식** — 1차 요청 시점 뷰포트의 위도·경도 span 중 하나라도 0.5도를 넘으면, 요청 전에 현재 **중심 기준** `zoomTo(MAP_SCALE_1KM_ZOOM)`으로 맞추고 새 bounds가 `viewport-store`에 반영된 뒤 보낸다(bounds를 잘라 보내지 않는다 — 사용자가 보는 화면과 요청 범위를 어긋나게 두지 않기 위해). 이 경우 토스트는 띄우지 않는다(지역 이동이 아니므로).
+- **A3. `kind` 미지 값 처리** — 생성 타입의 `kind`는 유니언이 아니라 `string`이다. `mentionedArea`가 non-null이면 **`kind` 값과 무관하게** 이동한다(MOVE·ZOOM_OUT이 동일 처리로 확정된 이상, 서버가 신호를 보냈다는 사실 자체가 판정 근거). 판정 함수는 `kind`를 반환값에 실어 두되 분기하지 않는다.
+- **A4. 토스트 노출·중복** — 3초 자동 소멸(`use-auto-dismiss-toast` 기본값). 자동 이동은 요청 사이클당 최대 1회라 중복 토스트가 구조적으로 없지만, 연속 제출로 새 토스트가 오면 기존 것을 **대체**한다(동일 문구 연속도 타이머 재시작 — 훅이 보장).
+- **A5. 2차 요청의 origin 재판정** — 새 뷰포트 기준으로 다시 판정한다. 1차에서 안이었어도 이동 후 밖이면 2차 body에 `origin`이 없고 입력 카드 표시도 사라진다. (오케스트레이터 지시대로 추정으로 기재)
+- **A6. 2차 실패 처리** — 2차가 실패하면 **1차 결과를 복원하지 않고** 기존 에러 화면(488 `RouteErrorNotice`)으로 간다. 지도는 이미 이동한 자리에 있고 토스트도 이미 떴다(되돌리지 않는다). "다시 짜기"는 이동한 새 뷰포트로 1차부터 다시 시작한다.
+- **A7. 섹션 이탈 중 2차** — 진행 중 다른 섹션으로 나가면 mutation은 그대로 완주하고 결과는 스토어에 게시된다(488 S11 "돌아오면 복원" 계약 유지). 지도 이동·토스트는 이탈 전에 이미 끝났다. 언마운트 시 오버레이만 `clear()`(488 기존 동작).
+- **A8. 축척 1km 고정 후의 격자 게이트** — §8 R1 참조. 현행대로 두면 **AI 경로 격자 틴트는 zoom 13에서도 보인다**(색 보유 셀이라 게이트 통과). 다만 사용자 점령 격자·격자 선은 zoom 13에서 사라진다 — 이는 이 티켓이 만드는 회귀가 아니라 저줌 공통 동작이므로 **수용**한다.
+
+## 7. 질문 (사용자 결정 필요 — 승인 게이트)
+
+- **Q1. 지도 위 "현재 위치 점"을 이 티켓에 넣는가?**
+  **실측 결과 Figma에 없다.** `get_metadata`로 15666:12402 전 노드를 열거했고 지도 레이어의 자식은 격자 셀 135개 + ZoomControl + `MapIconButton/locate` + FAB + 칩뿐 — 현재 위치 점 노드가 **존재하지 않는다**. 15666:13139 스크린샷에서도 경로선이 1번 마커에서 시작할 뿐 별도 파란 점이 없다. MSG-488 §5가 489 몫으로 적어 둔 "지도 위 현재 위치 점(`color/primary`)"과 "489가 MapCanvas를 다시 열 공산이 크다"는 경고는 **디자인 정본에 근거가 없다**.
+  → **권고: 이 티켓에서 제외**하고 `MapCanvas.tsx` 489 diff를 **0줄로 유지**한다. 넣기로 한다면 `MapCanvasProps`에 `currentLocation?: { lat, lng } | null` 슬롯 1개만 추가하는 최소 변경으로 제한한다(490은 MapCanvas 0줄이라 병렬성은 어느 쪽이든 안 깨진다).
+  **결정 필요: 제외(권고) / 최소 슬롯 1개로 포함**
+- **Q2. 2차 자동 재요청이 서버 10초 rate limit(14429) 예외인가? (BE 미해결)**
+  두 설계안을 준비했다.
+  - **안 A(예외인 경우)**: 이동 직후 즉시 발사. 구현 단순, 체감 지연 없음.
+  - **안 B(예외가 아닌 경우)**: 1차 요청 시각을 스토어에 기록하고 `10s - 경과`만큼 대기 후 발사한다. **대기 동안 로딩 상태를 유지**하고 토스트는 이동 시점에 이미 떠 있다. 대기 중 사용자가 이탈·재제출하면 예약을 취소한다.
+  → 착수 전 **실측 계획**: 로그인 세션 쿠키로 `POST /api/routes/recommend`를 연속 2회 호출(간격 1초 미만)해 두 번째 응답이 200인지 `14429`인지 확인한다. 예외가 아니면 안 B로 확정하고 L16~L18 테스트에 타이머 케이스를 추가한다.
+  **결정 필요: 실측을 착수 전에 할 것인지 / 안 B를 기본으로 깔고 시작할 것인지**
+- **Q3. 1km 고정이 격자 틴트 한계를 해소하지 못하는 사실 — 대응 방향**
+  실측: `MAP_SCALE_1KM_ZOOM = 13`, `GRID_MIN_ZOOM = 16`이므로 **13 < 16**이다. 즉 1km 고정은 격자 줌 게이트를 넘지 못한다. 다만 §8 R1에서 밝히듯 **AI 경로 셀은 `color`를 갖고 있어 게이트에 안 걸린다** — MSG-488이 "알려진 한계"로 남긴 서술 자체가 사실과 다르다. 남는 실제 차이는 (a) 격자 실선이 안 그려짐 (b) 내 점령 격자(무색)가 저줌에서 걷힘 (c) 지역 집계 마커(SIGUNGU)가 함께 뜸 — 셋 다 홈과 동일한 저줌 공통 동작이다.
+  **결정 필요: (i) 현행 수용(권고 — 추정 A8) / (ii) `MAP_SCALE_500M_ZOOM`(=14)이나 그 이상으로 고정 줌을 올려 재검토(티켓 문구 "1km"와 충돌, MSG-487 결정 재개봉) / (iii) 후속 티켓으로 분리**
+
+---
+
+## 8. 리스크
+
+- **R1. MSG-488 "알려진 한계" 서술이 실측과 어긋난다 (문서 ↔ 코드 모순)** — `docs/spec/MSG-488.md` §11과 `docs/STATUS.md` 164행은 "`gateFillCells`가 `zoom < 16`에서 채움 셀을 버려 넓게 본 상태에서 요청하면 격자 초록 틴트가 안 보인다 — MSG-489의 1km 축척 고정이 해소한다"고 적었다. 실제 구현은 `zoom >= 16 ? cells : cells.filter(c => c.color !== undefined)`로 **색 있는 셀을 남기는** 게이트이고, `buildAiRouteOverlay`는 모든 셀에 `color: palette["theme-route"]`를 채운다. 따라서 (a) 초록 틴트는 저줌에서도 보였고 (b) 1km 고정(zoom 13)은 어차피 게이트 임계(16) 아래라 "해소"할 수 없다. → **489가 이 서술에 기대어 설계하면 안 된다.** 브라우저 검증에서 저줌 틴트 표시를 직접 확인하고, 결과를 STATUS.md 489 줄에 정정 기록한다.
+- **R2. 현위치 어댑터가 거부를 은닉한다** — 추정 A1. 승인 없이 기존 `getCurrentPosition`을 그대로 쓰면 "권한 거부 시 origin 생략"이라는 티켓 요구를 **구조적으로 만족할 수 없다**(서면 폴백이 뷰포트 안에 들어온다). 승인이 나지 않으면 이 요구를 미구현으로 두고 그 사실을 명시해야 한다.
+- **R3. 2차 요청 발사 타이밍이 `viewport-store` 갱신에 의존한다** — `moveTo`/`zoomTo`는 명령이고 새 bounds는 MapCanvas의 `idle` 이벤트를 거쳐야 스토어에 들어온다. "이동 명령 직후 즉시 mutate"하면 **옛 bounds로 2차를 쏜다**. bounds 변화 구독(또는 목표 중심·줌으로부터 파생) 중 하나로 반드시 새 값을 확인하고 발사해야 한다. 테스트 L18이 이 지점을 고정한다.
+- **R4. dev 서버 포트 점유** — 네이버 지도 키가 `localhost:5173`에 묶여 브라우저 검증은 `--strictPort 5173`이 필수인데, **현재 5173은 다른 워크트리(`sc-cooled-fluxon-51c2`, 옛 488 브랜치)의 dev 서버(node PID 72012)가 LISTEN 중**이다(실측). 검증 착수 시 그 서버를 내리거나 순서를 조율해야 하고, 임의 포트로 우회하면 지도가 뜨지 않아 S3~S8 전부 판정 불가가 된다.
+- **R5. 로그인 전용 화면** — `/ai-route`는 `RequireAuth`이고 서버가 익명 POST를 401(2403)으로 막는다. 실계정 세션 없이는 화면 기준 9개 중 S1·S2를 제외한 전부가 확인 불가로 떨어진다(MSG-463·488 선례).
+- **R6. 490과의 동시 진행** — 파일 교차 0을 §4-1로 고정했으나, 공유 파일 `AiRoutePage.tsx`가 489만 2줄 변경이라는 전제가 깨지면 머지 충돌이 난다. 이 스펙은 그 2줄을 넘지 않는다.
+- **Figma 오탐 방지** (page-verifier용):
+  1. **토스트 본문 "약 2km" → "약 1km"** — Figma 15675:3267 시안 문구가 구식이다. 사용자 확정(D7)에 따라 **1km가 맞고 Figma가 틀렸다**. 결함으로 보고하지 말 것.
+  2. **토스트 본문 불투명도 64% vs 65%** — Figma `rgba(255,255,255,0.64)`, ui-web `text-foreground-inverse/65`. ui-web은 488 완결분이라 무수정이다.
+  3. **토스트 gap 12 vs ui-web `gap-sm`** — 아이콘↔본문 간격이 Figma 12, ui-web 토큰은 `gap-sm`. ui-web을 고치지 않는다(다른 소비처 영향).
+  4. **지도 위 현재 위치 점 없음** — Figma에도 없고 이 티켓에도 없다(Q1). 누락으로 보고하지 말 것.
+  5. **결과 상태에서 "현재 위치에서 출발" 행 없음** — Figma 13139에서도 그 행은 사라지고 버튼 라벨로만 origin을 알린다. 의도된 동작이다.
+  6. **`locate` MapIconButton은 신규가 아니다** — MSG-488 §6 표가 이 항목을 "489"로 적었으나 실측상 `MapShell`이 이미 상시 렌더한다. 489는 아무것도 추가하지 않는다.
+  7. **Figma 지도 배경의 지명(에리카 캠퍼스뮤즈홀·안산체력인증센터 등)은 플레이스홀더**다 — MVP 지역은 부산 서면이고, 서울·경기 지명은 하드코딩 금지(메모리 규칙). 토스트 예시 문구 "부산 서면으로 이동했어요"가 실데이터 기준이다.
+  8. **패널 로딩 스켈레톤 3장은 488 기존 구현** — 2차 진행 중에도 같은 컴포넌트를 재사용하므로 로딩 화면이 1차와 동일한 것이 정상이다.
+
+---
+
+## 9. 승인 기록 (2026-08-28, 사용자 승인 게이트)
+
+- **스펙 승인** — 추정 A1~A8 전부 승인. 특히 **A1 `shared/geolocation.ts` 가산 export `getCurrentPositionOrNull` 승인**(소유권 표 밖 파일, 490 미접촉).
+- **Q1 현재 위치 점: 제외** — Figma 12402·13139에 노드 없음. `MapCanvas.tsx` 489 diff 0줄 유지.
+- **Q2 14429: 착수 전 실측 후 결정** — 로그인 세션으로 recommend 연속 2회 호출. 예외면 안 A(즉시 발사), 아니면 안 B(잔여시간 대기·로딩 유지). 실측 결과는 아래에 추기.
+- **Q3 1km 격자: 현행 수용** — A8. 488 "알려진 한계" 서술은 STATUS 489 줄에서 정정.
+- **환경: 5173 점유 서버(PID 72012, `sc-cooled-fluxon-51c2`) 종료 허용.**
+
+### Q2 실측 결과 (2026-08-28, 로그인 세션 · 페이지 컨텍스트 fetch · `https://api.fillmap.kr`)
+
+| 프로브 | 1차 | 2차 | 판정 |
+|---|---|---|---|
+| ① 연속 호출 | 200 (6,716ms, points 8, mentionedArea null) | 1차 응답 직후(=1차 요청 시작 +6.7s) → **429 / developCode 14429** "요청이 너무 잦습니다" (32ms) | **예외 아님** |
+| ② 간격 검증 | 200 (4,721ms) | 1차 요청 시작 +11.0s(응답 +6.3s) → **200** (3,469ms) | 창은 요청 시작 기준 10s로 해석 가능 |
+
+`Retry-After` 헤더 없음. → **안 B 확정**: 1차 `mutate` 호출 시각(`requestedAt`)을 기준으로 `max(0, 10_000 + 500(여유) − (now − requestedAt))`만큼 대기 후 2차 발사. 대기 중 로딩 상태 유지, 토스트는 이동 시점에 즉시. 2차가 그래도 14429면 기존 488 에러 매핑(재시도 안내)으로 — 추가 자동 재시도 없음. 대기 중 이탈·재제출 시 예약 취소.
+
+---
+
+## 10. 작업 로그 (2026-08-28 — 구현·검증 완료 후 승격)
+
+### 실측 동작 (게이트)
+- 루트 풀 게이트 6종 전건 통과: test(web 1447 + mobile·packages 982) · typecheck · lint(경고 0) · format:check · check:duplication(신규 0, baseline +11/−6 — 추가 전건이 489 변경 파일 포함, 무관 흡수 0) · openapi-ts 드리프트 0.
+- 수용 기준 28개(L1~L19 · S1~S9) **전건 통과**, 확인불가 0.
+- 브라우저 계측(`fetch` 래퍼 + 120ms DOM 폴링, 실 API): S6 recommend 정확히 2회 — 1차 t=4,262ms(origin 없음, 중심 광안 앞바다) → 2차 t=15,436ms(**간격 11,174ms ≥ 10,500ms**); S4 토스트 "서면으로 이동했어요 / 지도 범위 약 1km 기준으로 동선을 짜요" 등장→소멸 ≈3.9s; S5 로딩 4.4s~21.4s 전 구간 스켈레톤 유지·이전 결과 문자열 부재; S7 2차가 이동 후 뷰포트로 origin 재판정(`hasOrigin:true`) → 버튼 "현재 위치에서 다시 짜기"; S8 span ≈0.7° 제출 → 1km로 먼저 좁혀진 뒤 요청 1회, 14401 없음(body span 0.129°/0.297°); S9 콘솔 에러·경고 0.
+- S1: Chrome 위치 권한 granted + 실좌표가 서면 뷰포트 안이라 "안 → 표시"를 단위 테스트 대체 없이 브라우저에서 직접 판정.
+- Figma 편차 0 — `w-85.5`=342px·`left-97`=388px·`top-21`=84px·`gap-1.25`=5px·`size-3.25`=13px computed style 실측 일치.
+- 소유권: 접촉 금지 15경로 diff 0줄. `features/ai-route/**` naver·window·라우터 참조 0, Hermes 미구현 API 0, px/hex 임의값 0, 기존 테스트 단정 약화·삭제 0.
+
+### 변경 파일 (20개)
+확장: `ai-route-store.ts`(+50/−4 — 사이클 플래그 5종 + `startRequest`/`startSecondaryRequest`/`markSecondarySent`) · `route-request.ts`(+59/−2 — `origin` 병합·`needsSpanNormalize`·`submitLabel`·`secondaryDelayMs`) · `use-route-recommend.ts`(+30/−3 — `onSuccess` 1차/2차 분기, `onAutoMove`·`secondary` 옵션) · `RouteInputCard.tsx`(+13/−2 — `originActive` 행) · `AiRoutePage.tsx`(-w +14/−12) · `shared/geolocation.ts`(+16/−5 — A1).
+신규: `route-origin.ts`(32) · `route-mentioned-area.ts`(61) · `use-ai-route-auto-move.ts`(145) · `RouteToastHost.tsx`(44).
+테스트: `route-origin.test.ts`(52) · `route-mentioned-area.test.ts`(74) · `use-ai-route-auto-move.test.tsx`(234) · `route-request.test.ts`(+106) · `ai-route-store.test.ts`(+46) · `ai-route-panel.smoke.test.tsx`(+63) · `geolocation.test.ts`(+47/−9) · `src/test/geolocation.ts`(32, `setGeolocation` 헬퍼 추출).
+기타: `docs/decisions/DECISIONS.md`(+4) · `nose.baseline.json` · `docs/STATUS.md` · 이 문서.
+수용 기준 ↔ 테스트 매핑은 `_workspace/MSG-489/02_build_report.md` §2 (검증자가 실제 테스트 파일로 대조 완료).
+
+### 검토한 대안 (기각 사유)
+| 판단 | 채택 | 기각한 대안 |
+|---|---|---|
+| 자동 동작 배치 | 훅 1개(`use-ai-route-auto-move`)가 제출·정규화·이동·2차 소유 — `AiRoutePage` "2줄" 상한 초과(-w +14/−12) | ①§4-2 문면대로 `submit()`을 페이지에 유지 → 정규화 대기·측위·재판정이 페이지로 올라와 diff가 더 커지고 재료 이중 구독 ②훅 2개 분리 → 측위 2회 |
+| 2차 인스턴스 | `useRouteRecommend({ secondary: true })` 두 번째 mutation | mutate 변수 래핑 → 페이지 호출부까지 변경 |
+| 2차 발사 시점 | `bounds` 참조 변경 AND `requestedAt+10.5s` | ①이동 직후 즉시 → 옛 bounds(R3) ②목표 중심 ∈ bounds 판정 → `ZOOM_OUT`은 즉시 통과 |
+| 10초 창 계산 | 순수 `secondaryDelayMs` + 스토어 `requestedAt` | 훅 안 `Date.now()` → 테스트 불가, 이탈 후 기준 시각 소실 |
+| 예약 상태 | 스토어 `secondaryPending` | 훅 로컬 ref → 이탈 시 영구 로딩 + StrictMode 중복 발사 |
+| 0.5도 대기 | `useRef` | `useState` → StrictMode에서 1차 2회 발사 |
+| 토스트 트리거 | 스토어 `movedAreaName` 전이, 마운트 시점 값은 소비 처리 | ①effect + setMessage 의존 → 소멸 타이머 재시작 반복 ②마운트 시 무조건 표시 → 재진입마다 재표시 |
+| 조사 | 받침 판정 순수 함수 | ①"(으)로" 리터럴 노출 ②서버 제공 → 계약 변경 |
+| 결과 화면 표시 행 | `status !== "result"`에서만 | 라이브 판정만 → Figma 13139와 어긋남 |
+| `setGeolocation` 중복 | `src/test/geolocation.ts` 추출 | baseline 등재 → 0파라미터 완전 동일 헬퍼라 명분 없음 |
+
+### 정정 사항 (선행 문서)
+- MSG-488 §11 / STATUS 164행 "gateFillCells가 zoom<16에서 채움 셀을 버려 틴트가 안 보인다 → 489가 해소": **양쪽 다 사실과 다름.** 게이트는 색 있는 셀을 남기고 AI 경로 셀은 전부 색을 가져 통과한다(zoom 13 DOM 폴리곤 8개 실측). 1km(13)는 어차피 16 미만. 실제 저줌 육안 미식별의 원인은 셀 6~7px + 28px 마커 가림. STATUS 489줄에 정정 기록.
+- MSG-488 §6 표의 `locate` MapIconButton "489" 표기는 오기 — `MapShell`이 이미 상시 렌더.
+- 빌드 리포트 §5 "추가 12건"은 표기 오차 — 검증자 id 대조 결과 11건.
+
+### WAIVED · 확인불가
+없음.
+
+### 후속 권장 (지라 코멘트 환류 대상)
+- 0.5도 정규화 대기(실측 14.2초 — 네이버 다단 줌 애니메이션이 `idle`을 늦게 냄) 동안 로딩 피드백 없음 — 정규화 대기에도 로딩 상태를 켜면 해소.
+- 2차 인스턴스에 `onLoginRequired` 미부착 — 1차 성공 직후 세션 만료 시 로그인 모달 없이 입력 대기로 복귀.
+- `features/dex/use-region-stat-query.ts`의 private `useCurrentCoords`와 이 티켓 동명 훅이 구조상 3복제(baseline 등재) — 공통화하려면 dex의 "조회 전 null 대기" 계약을 tri-state로 변경 필요.
+- 자동 이동 순간 축척 바(`role="status"`)가 "1km"를 토스트와 함께 낭독(내용 일치, 중복 낭독은 아님).
diff --git a/nose.baseline.json b/nose.baseline.json
index deaa24dd..ce4c8a67 100644
--- a/nose.baseline.json
+++ b/nose.baseline.json
@@ -3,6 +3,45 @@
   "tool": "nose",
   "baseline_kind": "accepted-duplication",
   "families": [
+    {
+      "id": "00808d9b5575efb1",
+      "note": "repeated across 3 directories — extract a shared abstraction — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "90e09c10001a26a6",
+          "source_digest": "fnv1a64:e2a201eaffda69a6",
+          "file": "apps/web/src/features/profile/ui/location-consent-screen.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 57,
+          "end_line": 60,
+          "kind": "Function",
+          "name": "ctaButton",
+          "is_fragment": false
+        },
+        {
+          "id": "1ca1d4cba9ea2264",
+          "source_digest": "fnv1a64:6142afa96ac5438d",
+          "file": "apps/web/src/features/upload/ui/upload-wizard-flow.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 162,
+          "end_line": 163,
+          "kind": "Function",
+          "name": "nextButton",
+          "is_fragment": false
+        },
+        {
+          "id": "6f023ab90eecf86d",
+          "source_digest": "fnv1a64:0122952205f67179",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 66,
+          "end_line": 67,
+          "kind": "Function",
+          "name": "submitButton",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "0132e006eea42261",
       "note": "repeated across 4 directories — extract a shared abstraction — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -351,6 +390,72 @@
         }
       ]
     },
+    {
+      "id": "06d12686f52541f9",
+      "note": "repeated across 5 directories — extract a shared abstraction",
+      "members": [
+        {
+          "id": "01c9baf45ec44cbf",
+          "source_digest": "fnv1a64:a109910cc4f6b200",
+          "file": "apps/web/src/app/RouteErrorBoundary.tsx",
+          "lang": "typescript",
+          "start_line": 28,
+          "end_line": 28,
+          "kind": "Block",
+          "is_fragment": true,
+          "fragment_kind": "expr-effect",
+          "reason_code": "exact-expr-effect"
+        },
+        {
+          "id": "e2d3dd5979dd4134",
+          "source_digest": "fnv1a64:ca3d6b429abfe04e",
+          "file": "apps/web/src/pages/ai-route/AiRoutePage.tsx",
+          "lang": "typescript",
+          "start_line": 40,
+          "end_line": 40,
+          "kind": "Block",
+          "is_fragment": true,
+          "fragment_kind": "expr-effect",
+          "reason_code": "exact-expr-effect"
+        },
+        {
+          "id": "169e9f8afb16ec1e",
+          "source_digest": "fnv1a64:028e5b08b43bbaab",
+          "file": "apps/web/src/pages/dex/DexPanel.tsx",
+          "lang": "typescript",
+          "start_line": 64,
+          "end_line": 64,
+          "kind": "Block",
+          "is_fragment": true,
+          "fragment_kind": "expr-effect",
+          "reason_code": "exact-expr-effect"
+        },
+        {
+          "id": "1d264230b840da92",
+          "source_digest": "fnv1a64:0f6f0abff89a292d",
+          "file": "apps/web/src/pages/oauth-callback/KakaoCallbackPage.tsx",
+          "lang": "typescript",
+          "start_line": 62,
+          "end_line": 62,
+          "kind": "Block",
+          "is_fragment": true,
+          "fragment_kind": "expr-effect",
+          "reason_code": "exact-expr-effect"
+        },
+        {
+          "id": "a301692b20022a8e",
+          "source_digest": "fnv1a64:9b632066b7322a64",
+          "file": "apps/web/src/pages/profile/ProfilePanel.tsx",
+          "lang": "typescript",
+          "start_line": 33,
+          "end_line": 33,
+          "kind": "Block",
+          "is_fragment": true,
+          "fragment_kind": "expr-effect",
+          "reason_code": "exact-expr-effect"
+        }
+      ]
+    },
     {
       "id": "08e49dcc4a7e9436",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -481,6 +586,45 @@
         }
       ]
     },
+    {
+      "id": "0d15ac9750167195",
+      "note": "consolidate `useCurrentCoords` — 3 copies",
+      "members": [
+        {
+          "id": "03e4a3726e2129d0",
+          "source_digest": "fnv1a64:e05f46d1da962eed",
+          "file": "apps/mobile/src/features/dex/model/use-region-stat-query.ts",
+          "lang": "typescript",
+          "start_line": 52,
+          "end_line": 66,
+          "kind": "Function",
+          "name": "useCurrentCoords",
+          "is_fragment": false
+        },
+        {
+          "id": "d0650e039bb8b528",
+          "source_digest": "fnv1a64:eacffa5f717fb5c0",
+          "file": "apps/web/src/features/dex/model/use-region-stat-query.ts",
+          "lang": "typescript",
+          "start_line": 52,
+          "end_line": 66,
+          "kind": "Function",
+          "name": "useCurrentCoords",
+          "is_fragment": false
+        },
+        {
+          "id": "b06efc7841d809a9",
+          "source_digest": "fnv1a64:55053a666cf480a0",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
+          "lang": "typescript",
+          "start_line": 32,
+          "end_line": 46,
+          "kind": "Function",
+          "name": "useCurrentCoords",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "0db5d8ac0316501d",
       "note": "consolidate `div` — 2 copies",
@@ -1834,152 +1978,6 @@
         }
       ]
     },
-    {
-      "id": "1fa76df4bddbbbfe",
-      "note": "repeated across 9 directories — extract a shared abstraction — high-parameter (18 varying spots): divergence readability; a smaller helper for the invariant core may fit better",
-      "members": [
-        {
-          "id": "d27ffd943352ed31",
-          "source_digest": "fnv1a64:f98072fb6db34108",
-          "file": "apps/web/src/shared/api/auth-pipeline.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 424,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "229ae6331c64b01c",
-          "source_digest": "fnv1a64:26cd36f40a63515e",
-          "file": "apps/mobile/src/shared/api/auth-pipeline.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 339,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "24309ae8c4926b4c",
-          "source_digest": "fnv1a64:2d36e2a184f30684",
-          "file": "apps/web/src/pages/map-home/ui/naver-sdk-loader.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 315,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "801f620ba3bc64ec",
-          "source_digest": "fnv1a64:f10834c242629d6d",
-          "file": "apps/mobile/src/features/upload/api/upload-effects.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 255,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "aaf8ecfaae088132",
-          "source_digest": "fnv1a64:83c882d72840e95a",
-          "file": "apps/mobile/src/features/auth/model/configure-auth.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 248,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "5d50e3030e837962",
-          "source_digest": "fnv1a64:5f63fdd1dd2c15c3",
-          "file": "apps/mobile/src/features/upload/api/s3-upload.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 153,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "e25ee33f74a2c992",
-          "source_digest": "fnv1a64:3d056659c53a9555",
-          "file": "apps/mobile/src/shared/api/error-interceptor.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 85,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "1e8a0594889fd5e0",
-          "source_digest": "fnv1a64:41945d6130ca9230",
-          "file": "apps/web/src/features/upload/api/s3-upload.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 75,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "f6a5b0f01f35672f",
-          "source_digest": "fnv1a64:289d0c73b95f3187",
-          "file": "apps/mobile/src/shared/api/client-config.storybook.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 64,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "5fba790ba75d150a",
-          "source_digest": "fnv1a64:4b0a1f974e79d4da",
-          "file": "apps/mobile/src/features/upload/model/location-label.parity.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 63,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "f035a31ac00d448c",
-          "source_digest": "fnv1a64:669b8f67cb3a8be0",
-          "file": "apps/web/src/shared/geolocation.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 54,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "67f5c26d2c1d24df",
-          "source_digest": "fnv1a64:5a32fc60615251dd",
-          "file": "apps/mobile/src/features/auth/api/kakao-adapter.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 38,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "5cb89b3fd17a81b9",
-          "source_digest": "fnv1a64:b13135bbec416fed",
-          "file": "apps/mobile/src/shared/api/client-config.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 36,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "68a2ee8d1e1743bd",
-          "source_digest": "fnv1a64:ab93a3f7b3f1aa02",
-          "file": "apps/web/src/shared/api/client-config.test.ts",
-          "lang": "typescript",
-          "start_line": 1,
-          "end_line": 32,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "1fff7443bd78b12c",
       "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -3782,34 +3780,6 @@
         }
       ]
     },
-    {
-      "id": "41f3b479c726d46f",
-      "note": "consolidate `routes` — 2 copies",
-      "members": [
-        {
-          "id": "127299413b1df34e",
-          "source_digest": "fnv1a64:4d0fdc1b39ca1ef4",
-          "file": "apps/web/src/pages/dex/dex-test-harness.tsx",
-          "lang": "typescript",
-          "start_line": 33,
-          "end_line": 48,
-          "kind": "Block",
-          "name": "routes",
-          "is_fragment": false
-        },
-        {
-          "id": "bf07dee37ce1cd96",
-          "source_digest": "fnv1a64:8fe27cd57b04fb19",
-          "file": "apps/web/src/pages/map-home/map-home-panel-switch.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 88,
-          "end_line": 92,
-          "kind": "Block",
-          "name": "routes",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "4202764abf20f408",
       "note": "consolidate `pressable` — 2 copies",
@@ -7645,6 +7615,32 @@
         }
       ]
     },
+    {
+      "id": "8abb8e8f76b002ea",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "8b458a7f106aba2c",
+          "source_digest": "fnv1a64:a7befad4bbcc9e51",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 210,
+          "end_line": 216,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "8f705544028b7013",
+          "source_digest": "fnv1a64:5d981aa860b0f991",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 95,
+          "end_line": 100,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "8af2a1b250789430",
       "note": "duplicated across 2 directories — extract a method from the repeated block — high-parameter (8 varying spots): divergence readability; a smaller helper for the invariant core may fit better",
@@ -7671,6 +7667,52 @@
         }
       ]
     },
+    {
+      "id": "8afa0cca113362a2",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "df726660d85787d8",
+          "source_digest": "fnv1a64:8a5dedc597e4d063",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 147,
+          "end_line": 169,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "3cd2ccf369a89dc9",
+          "source_digest": "fnv1a64:4ffc419943892caf",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 132,
+          "end_line": 145,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "5eb8663201e0e57b",
+          "source_digest": "fnv1a64:c6fd29b1c441f0fb",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 171,
+          "end_line": 184,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "e8ead66416159899",
+          "source_digest": "fnv1a64:1d70ef71f9a62dc3",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 186,
+          "end_line": 195,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "8b66ba605ad513fe",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -8497,68 +8539,28 @@
       ]
     },
     {
-      "id": "9687a16b28976f71",
-      "note": "repeated across 5 directories — extract a shared abstraction",
+      "id": "963e859dc96670fe",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
       "members": [
         {
-          "id": "01c9baf45ec44cbf",
-          "source_digest": "fnv1a64:a109910cc4f6b200",
-          "file": "apps/web/src/app/RouteErrorBoundary.tsx",
-          "lang": "typescript",
-          "start_line": 28,
-          "end_line": 28,
-          "kind": "Block",
-          "is_fragment": true,
-          "fragment_kind": "expr-effect",
-          "reason_code": "exact-expr-effect"
-        },
-        {
-          "id": "87cf2cb7f16306bc",
-          "source_digest": "fnv1a64:ca3d6b429abfe04e",
-          "file": "apps/web/src/pages/ai-route/AiRoutePage.tsx",
-          "lang": "typescript",
-          "start_line": 39,
-          "end_line": 39,
-          "kind": "Block",
-          "is_fragment": true,
-          "fragment_kind": "expr-effect",
-          "reason_code": "exact-expr-effect"
-        },
-        {
-          "id": "169e9f8afb16ec1e",
-          "source_digest": "fnv1a64:028e5b08b43bbaab",
-          "file": "apps/web/src/pages/dex/DexPanel.tsx",
+          "id": "4c628b1104df60e2",
+          "source_digest": "fnv1a64:c797beae5cf36aa6",
+          "file": "apps/web/src/features/ai-route/model/ai-route-store.test.ts",
           "lang": "typescript",
-          "start_line": 64,
-          "end_line": 64,
+          "start_line": 111,
+          "end_line": 161,
           "kind": "Block",
-          "is_fragment": true,
-          "fragment_kind": "expr-effect",
-          "reason_code": "exact-expr-effect"
+          "is_fragment": false
         },
         {
-          "id": "1d264230b840da92",
-          "source_digest": "fnv1a64:0f6f0abff89a292d",
-          "file": "apps/web/src/pages/oauth-callback/KakaoCallbackPage.tsx",
+          "id": "493970027043a8d1",
+          "source_digest": "fnv1a64:70bd36e820e50fb9",
+          "file": "apps/web/src/features/ai-route/model/ai-route-store.test.ts",
           "lang": "typescript",
-          "start_line": 62,
-          "end_line": 62,
-          "kind": "Block",
-          "is_fragment": true,
-          "fragment_kind": "expr-effect",
-          "reason_code": "exact-expr-effect"
-        },
-        {
-          "id": "a301692b20022a8e",
-          "source_digest": "fnv1a64:9b632066b7322a64",
-          "file": "apps/web/src/pages/profile/ProfilePanel.tsx",
-          "lang": "typescript",
-          "start_line": 33,
-          "end_line": 33,
+          "start_line": 50,
+          "end_line": 69,
           "kind": "Block",
-          "is_fragment": true,
-          "fragment_kind": "expr-effect",
-          "reason_code": "exact-expr-effect"
+          "is_fragment": false
         }
       ]
     },
@@ -10536,6 +10538,32 @@
         }
       ]
     },
+    {
+      "id": "b7c5d4be692af391",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "3c2fdd18bb9e357b",
+          "source_digest": "fnv1a64:af1dfa16d6e4b263",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 172,
+          "end_line": 178,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "f39b5eb33fac205f",
+          "source_digest": "fnv1a64:87d172a612855854",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 294,
+          "end_line": 300,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "b7d50ca769a15da0",
       "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -10562,6 +10590,45 @@
         }
       ]
     },
+    {
+      "id": "b84a763f515a1ef8",
+      "note": "consolidate `routes` — 3 copies",
+      "members": [
+        {
+          "id": "127299413b1df34e",
+          "source_digest": "fnv1a64:4d0fdc1b39ca1ef4",
+          "file": "apps/web/src/pages/dex/dex-test-harness.tsx",
+          "lang": "typescript",
+          "start_line": 33,
+          "end_line": 48,
+          "kind": "Block",
+          "name": "routes",
+          "is_fragment": false
+        },
+        {
+          "id": "2b8338fdedd913cc",
+          "source_digest": "fnv1a64:f7d16498dfc8f3d3",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 73,
+          "end_line": 77,
+          "kind": "Block",
+          "name": "routes",
+          "is_fragment": false
+        },
+        {
+          "id": "bf07dee37ce1cd96",
+          "source_digest": "fnv1a64:8fe27cd57b04fb19",
+          "file": "apps/web/src/pages/map-home/map-home-panel-switch.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 88,
+          "end_line": 92,
+          "kind": "Block",
+          "name": "routes",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "b9eacbae2f9c3d50",
       "note": "consolidate `p` — 2 copies",
@@ -11296,48 +11363,12 @@
           "is_fragment": false
         },
         {
-          "id": "f259f78f2c37627e",
-          "source_digest": "fnv1a64:efa00b9a13ca909b",
-          "file": "apps/web/src/pages/map-home/map-home-panel-switch.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 351,
-          "end_line": 373,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
-    {
-      "id": "c854f5bf9eaa5301",
-      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
-      "members": [
-        {
-          "id": "4a035881d572e75d",
-          "source_digest": "fnv1a64:a07e14e88600b7f0",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 187,
-          "end_line": 207,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "f7ed898790d9bbb8",
-          "source_digest": "fnv1a64:3e2b07f8237196b4",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 209,
-          "end_line": 226,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "05f0b7f903fe05ac",
-          "source_digest": "fnv1a64:fd95561cb55b726f",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "id": "f259f78f2c37627e",
+          "source_digest": "fnv1a64:efa00b9a13ca909b",
+          "file": "apps/web/src/pages/map-home/map-home-panel-switch.smoke.test.tsx",
           "lang": "typescript",
-          "start_line": 160,
-          "end_line": 171,
+          "start_line": 351,
+          "end_line": 373,
           "kind": "Block",
           "is_fragment": false
         }
@@ -12336,32 +12367,6 @@
         }
       ]
     },
-    {
-      "id": "db4cee5be783f3a7",
-      "note": "duplicated across 2 directories — extract a method from the repeated block",
-      "members": [
-        {
-          "id": "bb01f7f967bc5348",
-          "source_digest": "fnv1a64:a90f6e1a3da50a68",
-          "file": "apps/mobile/src/features/dex/model/use-region-stat-query.ts",
-          "lang": "typescript",
-          "start_line": 45,
-          "end_line": 66,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "1a07c1f8346b8d00",
-          "source_digest": "fnv1a64:d531e4fc8a28f584",
-          "file": "apps/web/src/features/dex/model/use-region-stat-query.ts",
-          "lang": "typescript",
-          "start_line": 45,
-          "end_line": 66,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "db574d62e9dff2d6",
       "note": "duplicated across 2 directories — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -12502,6 +12507,152 @@
         }
       ]
     },
+    {
+      "id": "dc83df2e1a27c39c",
+      "note": "repeated across 9 directories — extract a shared abstraction — high-parameter (18 varying spots): divergence readability; a smaller helper for the invariant core may fit better",
+      "members": [
+        {
+          "id": "d27ffd943352ed31",
+          "source_digest": "fnv1a64:f98072fb6db34108",
+          "file": "apps/web/src/shared/api/auth-pipeline.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 424,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "229ae6331c64b01c",
+          "source_digest": "fnv1a64:26cd36f40a63515e",
+          "file": "apps/mobile/src/shared/api/auth-pipeline.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 339,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "24309ae8c4926b4c",
+          "source_digest": "fnv1a64:2d36e2a184f30684",
+          "file": "apps/web/src/pages/map-home/ui/naver-sdk-loader.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 315,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "801f620ba3bc64ec",
+          "source_digest": "fnv1a64:f10834c242629d6d",
+          "file": "apps/mobile/src/features/upload/api/upload-effects.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 255,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "aaf8ecfaae088132",
+          "source_digest": "fnv1a64:83c882d72840e95a",
+          "file": "apps/mobile/src/features/auth/model/configure-auth.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 248,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "5d50e3030e837962",
+          "source_digest": "fnv1a64:5f63fdd1dd2c15c3",
+          "file": "apps/mobile/src/features/upload/api/s3-upload.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 153,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "a1a464da9122feee",
+          "source_digest": "fnv1a64:512e8889dcdae01c",
+          "file": "apps/web/src/shared/geolocation.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 92,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "e25ee33f74a2c992",
+          "source_digest": "fnv1a64:3d056659c53a9555",
+          "file": "apps/mobile/src/shared/api/error-interceptor.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 85,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "1e8a0594889fd5e0",
+          "source_digest": "fnv1a64:41945d6130ca9230",
+          "file": "apps/web/src/features/upload/api/s3-upload.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 75,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "f6a5b0f01f35672f",
+          "source_digest": "fnv1a64:289d0c73b95f3187",
+          "file": "apps/mobile/src/shared/api/client-config.storybook.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 64,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "5fba790ba75d150a",
+          "source_digest": "fnv1a64:4b0a1f974e79d4da",
+          "file": "apps/mobile/src/features/upload/model/location-label.parity.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 63,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "67f5c26d2c1d24df",
+          "source_digest": "fnv1a64:5a32fc60615251dd",
+          "file": "apps/mobile/src/features/auth/api/kakao-adapter.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 38,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "5cb89b3fd17a81b9",
+          "source_digest": "fnv1a64:b13135bbec416fed",
+          "file": "apps/mobile/src/shared/api/client-config.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 36,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "68a2ee8d1e1743bd",
+          "source_digest": "fnv1a64:ab93a3f7b3f1aa02",
+          "file": "apps/web/src/shared/api/client-config.test.ts",
+          "lang": "typescript",
+          "start_line": 1,
+          "end_line": 32,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "dcce8999a2402d93",
       "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -12528,6 +12679,34 @@
         }
       ]
     },
+    {
+      "id": "dcf4f8cf0d982209",
+      "note": "consolidate `queryclientprovider` — 2 copies",
+      "members": [
+        {
+          "id": "0780b43894e117d8",
+          "source_digest": "fnv1a64:1f0bc9fdfa24bb86",
+          "file": "apps/web/src/pages/dex/dex-test-harness.tsx",
+          "lang": "typescript",
+          "start_line": 27,
+          "end_line": 50,
+          "kind": "Block",
+          "name": "queryclientprovider",
+          "is_fragment": false
+        },
+        {
+          "id": "67b416873ad71f32",
+          "source_digest": "fnv1a64:1cd1acf6e127984b",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 67,
+          "end_line": 79,
+          "kind": "Block",
+          "name": "queryclientprovider",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "dcf705c8f9235ea0",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -13743,6 +13922,42 @@
         }
       ]
     },
+    {
+      "id": "f4d91cd257a2171d",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "9fc87c7873336c19",
+          "source_digest": "fnv1a64:a07e14e88600b7f0",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 198,
+          "end_line": 218,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "0c8b0cdf17c3ac46",
+          "source_digest": "fnv1a64:3e2b07f8237196b4",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 220,
+          "end_line": 237,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "89d6ef56a89b6e62",
+          "source_digest": "fnv1a64:fd95561cb55b726f",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 171,
+          "end_line": 182,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "f5430579f4f967e5",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -13940,45 +14155,6 @@
         }
       ]
     },
-    {
-      "id": "fa0e96b4dcf39433",
-      "note": "repeated across 3 directories — extract a shared abstraction — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
-      "members": [
-        {
-          "id": "90e09c10001a26a6",
-          "source_digest": "fnv1a64:e2a201eaffda69a6",
-          "file": "apps/web/src/features/profile/ui/location-consent-screen.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 57,
-          "end_line": 60,
-          "kind": "Function",
-          "name": "ctaButton",
-          "is_fragment": false
-        },
-        {
-          "id": "1ca1d4cba9ea2264",
-          "source_digest": "fnv1a64:6142afa96ac5438d",
-          "file": "apps/web/src/features/upload/ui/upload-wizard-flow.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 162,
-          "end_line": 163,
-          "kind": "Function",
-          "name": "nextButton",
-          "is_fragment": false
-        },
-        {
-          "id": "4cc220887bc1f2ff",
-          "source_digest": "fnv1a64:0122952205f67179",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 61,
-          "end_line": 62,
-          "kind": "Function",
-          "name": "submitButton",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "fa6b3707e6922fc0",
       "note": "duplicated across 2 directories — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",

From 6d2f21cad0b72697997459645d1df58bce61fbc8 Mon Sep 17 00:00:00 2001
From: gyuhochoime <cjg1999@naver.com>
Date: Sat, 29 Aug 2026 15:37:52 +0900
Subject: [PATCH 2/6] =?UTF-8?q?MSG-489=20feat:=20[=EC=9B=B9]=20AI=20?=
 =?UTF-8?q?=EA=B2=BD=EB=A1=9C=EC=B6=94=EC=B2=9C=20=E2=80=94=20=EC=B6=94?=
 =?UTF-8?q?=EC=B2=9C=20=EC=8B=9C=201km=20=EC=B6=95=EC=B2=99=20=EA=B3=A0?=
 =?UTF-8?q?=EC=A0=95=20+=20=EA=B2=BD=EB=A1=9C=20=ED=99=94=EB=A9=B4=20?=
 =?UTF-8?q?=EC=A7=91=EA=B3=84=20=EB=A7=88=EC=BB=A4=20=EC=88=A8=EA=B9=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 제출하면 항상 현재 중심 기준 1km(MAP_SCALE_1KM_ZOOM)로 맞춘 뒤 요청한다("다시 짜기"도 동일). 이미 1km면 줌 명령 없이 즉시 발사 — 같은 값 zoomTo는 idle을 내지 않아 요청이 나가지 않는다
- 종전 "뷰포트 한 변 0.5도 초과일 때만 정규화"(needsSpanNormalize) 규칙은 위 규칙에 흡수·폐기. 다만 서버 상한 가드는 exceedsViewportSpan으로 부활시켜 **발사 직전**에 둔다 — 정규화 대기·상한 만료·2차를 포함한 발사 4경로가 모두 send() 한 지점을 지난다
- 줌 맞추는 동안 로딩 표시(normalizePending). rate-limit 기준 시각 requestedAt은 실제 mutate 시점에만 기록해 2차 조기 발사(14429)를 막는다
- 2차 자동 재요청은 "목표 뷰포트 도달" 판정 후 발사하고, 도달 실패 시에도 상한 뒤 종결한다 — 영구 로딩과 확정 실패 요청 둘 다 금지
- 탭이 숨은 동안에는 정착 상한 타이머를 걸지 않는다. 백그라운드 탭에서는 네이버 지도가 idle을 내지 않아 뷰포트 스토어가 옛 값에 머물고, 그 상태로 상한이 발화해 정규화되지 않은 범위(1.9°x4.7°)로 요청이 나가 서버 400(14401)이 재현됐다
- /ai-route에서 다른 집계 클러스터 마커(지역 점령·미션·핫구역)를 숨긴다 — gateRouteClusters를 MapShell 파생 결과에만 적용. 집계층은 줌 16(100m) 미만에서만 존재하므로 경로 게이트 하나로 충족된다. 홈·도감은 불변
- 검증: 결함 재현 시나리오에서 과대 뷰포트 요청 0건·복귀 후 정상 발사, 세션 recommend 7건 전건 span<=0.5°·200. 클러스터 /ai-route 0개 vs 홈 동일 뷰포트 3개. S6 간격 10,498ms·14429 없음, 결과 후 확대 시 추가 호출 0. 게이트 6종 green(web 1472 tests)
- 14429(요청 과다) 안내를 서버와 같은 문장 "요청이 너무 잦습니다. 잠시 후 다시 시도해주세요"로 교체 — 종전 문구는 사유를 알려주지 않아 재시도를 연속으로 누른 사용자가 같은 안내만 반복해서 봤다. FE 고정 문구 상수이며 서버 응답 문자열을 렌더하지는 않는다(MSG-488 §1-5 정책 유지)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QkrsSVoDCWaPAV45gzKpZX
---
 .../ai-route/model/ai-route-store.test.ts     |  68 +++
 .../features/ai-route/model/ai-route-store.ts |  37 +-
 .../ai-route/model/route-error.test.ts        |   4 +-
 .../features/ai-route/model/route-error.ts    |  13 +-
 .../ai-route/model/route-request.test.ts      | 133 ++++-
 .../features/ai-route/model/route-request.ts  |  88 ++-
 .../ai-route/ai-route-panel.smoke.test.tsx    |   5 +-
 .../ui/use-ai-route-auto-move.test.tsx        | 247 ++++++++-
 .../ai-route/ui/use-ai-route-auto-move.ts     | 144 ++++-
 apps/web/src/widgets/map-shell/MapShell.tsx   |  12 +-
 .../map-shell/cluster-route-gate.test.ts      |  24 +
 .../widgets/map-shell/cluster-route-gate.ts   |  14 +
 docs/STATUS.md                                |  10 +-
 docs/decisions/DECISIONS.md                   |  11 +
 docs/spec/MSG-489.md                          | 111 ++++
 nose.baseline.json                            | 514 +++++++++---------
 16 files changed, 1109 insertions(+), 326 deletions(-)
 create mode 100644 apps/web/src/widgets/map-shell/cluster-route-gate.test.ts
 create mode 100644 apps/web/src/widgets/map-shell/cluster-route-gate.ts

diff --git a/apps/web/src/features/ai-route/model/ai-route-store.test.ts b/apps/web/src/features/ai-route/model/ai-route-store.test.ts
index 45015a4b..30973f87 100644
--- a/apps/web/src/features/ai-route/model/ai-route-store.test.ts
+++ b/apps/web/src/features/ai-route/model/ai-route-store.test.ts
@@ -159,3 +159,71 @@ describe("2차 자동 재요청 사이클 (L14·L15)", () => {
     expect(store().originSent).toBe(true);
   });
 });
+
+describe("축척 정규화 대기 (L23·D11)", () => {
+  beforeEach(() => {
+    useAiRouteStore.setState(useAiRouteStore.getInitialState(), true);
+  });
+
+  it("정규화 대기를 시작하면 즉시 로딩이지만 요청 시각은 아직 기록하지 않는다 (L23)", () => {
+    store().startNormalize();
+
+    expect(store().status).toBe("loading");
+    expect(store().normalizePending).toBe(true);
+    expect(store().requestedAt).toBeNull();
+  });
+
+  it("실제 mutate 시점에 요청 시각이 기록되고 정규화 대기가 풀린다 (L23)", () => {
+    store().startNormalize();
+    const before = Date.now();
+
+    store().startRequest();
+
+    expect(store().normalizePending).toBe(false);
+    expect(store().requestedAt!).toBeGreaterThanOrEqual(before);
+  });
+
+  it("정규화 대기는 이전 결과를 먼저 비운다 — 잔상이 로딩 중에 남지 않는다 (D11)", () => {
+    store().startRequest();
+    store().succeed(ROUTE_POINTS, null);
+
+    store().startNormalize();
+
+    expect(store().points).toHaveLength(0);
+    expect(store().selectedOrder).toBeNull();
+  });
+});
+
+describe("요청 없이 대기를 종결한다 (§12 — 영구 로딩·확정 400 동시 금지)", () => {
+  /** 뷰포트가 서버 상한을 넘어 보낼 수 없을 때의 안내 (route-error VIEWPORT_TOO_WIDE_NOTICE와 같은 모양) */
+  const TOO_WIDE = {
+    message: "지도를 조금 더 확대하거나 다른 곳으로 옮긴 뒤 다시 시도해 주세요",
+    retryable: true,
+    disablesFeature: false,
+    requiresLogin: false,
+  } as const;
+
+  beforeEach(() => {
+    useAiRouteStore.setState(useAiRouteStore.getInitialState(), true);
+  });
+
+  it("정규화 대기를 안내로 종결하면 에러 화면이 되고 대기 플래그가 풀린다 — 다시 누를 수 있다 (§12·D13)", () => {
+    store().startNormalize();
+
+    store().abortPending(TOO_WIDE);
+
+    expect(store().status).toBe("error");
+    expect(store().errorNotice).toEqual(TOO_WIDE);
+    expect(store().normalizePending).toBe(false);
+  });
+
+  it("2차 대기도 같은 종결을 쓴다 — 예약이 남아 재발사되지 않는다 (§12·D13)", () => {
+    store().startRequest();
+    store().startSecondaryRequest("부산 해운대");
+
+    store().abortPending(TOO_WIDE);
+
+    expect(store().status).toBe("error");
+    expect(store().secondaryPending).toBe(false);
+  });
+});
diff --git a/apps/web/src/features/ai-route/model/ai-route-store.ts b/apps/web/src/features/ai-route/model/ai-route-store.ts
index c4735a51..88548da6 100644
--- a/apps/web/src/features/ai-route/model/ai-route-store.ts
+++ b/apps/web/src/features/ai-route/model/ai-route-store.ts
@@ -32,15 +32,29 @@ interface AiRouteState {
   movedAreaName: string | null;
   /** 2차 요청이 예약됐지만 아직 발사되지 않았는가 — 섹션 이탈·재진입에도 예약이 살아남는다 */
   secondaryPending: boolean;
+  /** 제출했지만 1km 축척 정규화를 기다리는 중인가 — 로딩 표시의 근거 (D11·L23) */
+  normalizePending: boolean;
   /** 1차 요청을 쏜 시각(ms) — 2차 발사가 서버 10초 창을 계산하는 기준 (Q2 안 B) */
   requestedAt: number | null;
   setText: (text: string) => void;
+  /**
+   * 제출 직후 축척 정규화 대기 시작 (D11) — 즉시 로딩 화면이지만 요청은 아직 안 나갔다.
+   * `requestedAt`을 여기서 기록하지 않는 이유: 그러면 정규화 대기가 서버 10초 창을
+   * 잡아먹어 2차가 조기 발사되고 14429가 난다 (L23).
+   */
+  startNormalize: () => void;
   /** 1차 요청 시작 — 사이클 플래그를 전부 초기화한다 (L15) */
   startRequest: (originSent?: boolean) => void;
   /** 자동 이동 확정 + 2차 요청 예약 — 1차 결과는 게시하지 않고 로딩을 유지한다 (D5·L14) */
   startSecondaryRequest: (areaName: string) => void;
   /** 예약된 2차를 실제로 발사한 시점 — 재발사를 막고 출발지 재판정 결과를 반영한다 */
   markSecondarySent: (originSent: boolean) => void;
+  /**
+   * 요청을 보내지 못한 채 대기를 끝낸다 (§12) — 정착 상한이 만료됐는데 뷰포트가
+   * 서버 상한을 넘어 확정 400이 되는 경로. 쏘면 400, 안 쏘면 영구 로딩이라
+   * **명시적 안내로 종결**해 사용자가 다시 누를 수 있게 한다 (D13).
+   */
+  abortPending: (notice: RouteErrorNotice) => void;
   succeed: (points: RoutePointDto[], notice: string | null) => void;
   fail: (notice: RouteErrorNotice) => void;
   selectOrder: (order: number | null) => void;
@@ -50,12 +64,17 @@ interface AiRouteState {
 /** 요청 사이클 플래그 초기값 — startRequest와 reset이 공유한다 (L15) */
 const clearedCycle = (): Pick<
   AiRouteState,
-  "autoMoved" | "originSent" | "movedAreaName" | "secondaryPending"
+  | "autoMoved"
+  | "originSent"
+  | "movedAreaName"
+  | "secondaryPending"
+  | "normalizePending"
 > => ({
   autoMoved: false,
   originSent: false,
   movedAreaName: null,
   secondaryPending: false,
+  normalizePending: false,
 });
 
 /** 결과·선택·에러가 비워진 상태 — 새 요청 시작과 reset이 공유한다 (매번 새 배열) */
@@ -77,6 +96,14 @@ export const useAiRouteStore = create<AiRouteState>((set) => ({
   ...cleared(),
   ...clearedCycle(),
   setText: (text) => set({ text }),
+  // 정규화 대기도 새 사이클이라 이전 결과를 먼저 비운다 — 잔상이 로딩 중에 남지 않는다
+  startNormalize: () =>
+    set({
+      ...cleared(),
+      ...clearedCycle(),
+      status: "loading",
+      normalizePending: true,
+    }),
   // 새 요청은 이전 결과를 **먼저** 비운다 — 잔상(이전 카드·지도 표시)이 로딩 중에 남지 않는다
   startRequest: (originSent = false) =>
     set({
@@ -95,6 +122,14 @@ export const useAiRouteStore = create<AiRouteState>((set) => ({
     }),
   markSecondarySent: (originSent) =>
     set({ secondaryPending: false, originSent }),
+  // 두 대기(정규화·2차)를 함께 푼다 — 예약이 남으면 같은 뷰포트로 재발사된다
+  abortPending: (notice) =>
+    set({
+      status: "error",
+      errorNotice: notice,
+      normalizePending: false,
+      secondaryPending: false,
+    }),
   succeed: (points, notice) =>
     set({ status: "result", points, notice, errorNotice: null }),
   fail: (notice) =>
diff --git a/apps/web/src/features/ai-route/model/route-error.test.ts b/apps/web/src/features/ai-route/model/route-error.test.ts
index 8205ec40..e81a700e 100644
--- a/apps/web/src/features/ai-route/model/route-error.test.ts
+++ b/apps/web/src/features/ai-route/model/route-error.test.ts
@@ -18,11 +18,11 @@ describe("routeErrorNotice — developCode → UI 반응 매핑 (L5, §1-4)", ()
     }
   });
 
-  it("14429(요청 과다)는 잠시 후 재시도 안내다 — 클라이언트 쿨다운은 걸지 않는다 (L5, Q7)", () => {
+  it("14429(요청 과다)는 서버와 같은 문구로 사유까지 알린다 — 클라이언트 쿨다운은 걸지 않는다 (L5, Q7)", () => {
     expect(
       routeErrorNotice(apiError({ status: 429, developCode: 14429 })),
     ).toEqual({
-      message: "잠시 후 다시 시도해 주세요",
+      message: "요청이 너무 잦습니다. 잠시 후 다시 시도해주세요",
       retryable: true,
       disablesFeature: false,
       requiresLogin: false,
diff --git a/apps/web/src/features/ai-route/model/route-error.ts b/apps/web/src/features/ai-route/model/route-error.ts
index 2e9eb0ed..a2187a32 100644
--- a/apps/web/src/features/ai-route/model/route-error.ts
+++ b/apps/web/src/features/ai-route/model/route-error.ts
@@ -40,7 +40,10 @@ const BY_DEVELOP_CODE: Record<number, RouteErrorNotice> = {
   14401: notice(
     "지도를 조금 더 확대하거나 다른 곳으로 옮긴 뒤 다시 시도해 주세요",
   ),
-  14429: notice("잠시 후 다시 시도해 주세요"),
+  // 서버 문구를 그대로 쓴다 (MSG-489, 2026-08-29 사용자 지시) — "다시 시도"를 연속으로 누르면
+  // 이 코드만 반복해서 보게 되는데, 종전 문구는 왜 막혔는지를 알려주지 않았다.
+  // 서버 응답 문자열을 렌더하지는 않는다(FE 고정 문구 정책, MSG-488 §1-5) — 같은 문장을 상수로 둔다.
+  14429: notice("요청이 너무 잦습니다. 잠시 후 다시 시도해주세요"),
   14502: notice("AI가 문장을 이해하지 못했어요. 다시 시도해 주세요"),
   14503: notice("지금은 경로 추천을 쓸 수 없어요", {
     retryable: false,
@@ -49,6 +52,14 @@ const BY_DEVELOP_CODE: Record<number, RouteErrorNotice> = {
   2403: notice(null, { retryable: false, requiresLogin: true }),
 };
 
+/**
+ * 요청을 **보내지 못하고** 끝낸 경우의 안내 (MSG-489 §12).
+ * 지도가 정착하지 못해 뷰포트가 서버 상한을 넘을 때, 확정 400(14401)을 대신 맞아 주는 대신
+ * 같은 안내로 종결한다 — 사용자가 할 일(확대 후 재시도)이 서버 응답 때와 동일하다.
+ */
+export const VIEWPORT_TOO_WIDE_NOTICE: RouteErrorNotice =
+  BY_DEVELOP_CODE[14401];
+
 export const routeErrorNotice = (error: unknown): RouteErrorNotice => {
   if (!(error instanceof ApiError)) return GENERIC;
 
diff --git a/apps/web/src/features/ai-route/model/route-request.test.ts b/apps/web/src/features/ai-route/model/route-request.test.ts
index 2321b354..a9019610 100644
--- a/apps/web/src/features/ai-route/model/route-request.test.ts
+++ b/apps/web/src/features/ai-route/model/route-request.test.ts
@@ -2,10 +2,13 @@ import { describe, expect, it } from "vitest";
 import type { Bounds } from "@/entities/cell";
 import {
   MAX_ROUTE_TEXT_LENGTH,
+  MAX_VIEWPORT_SPAN_DEG,
   SECONDARY_MIN_INTERVAL_MS,
   buildRecommendBody,
   canSubmit,
-  needsSpanNormalize,
+  exceedsViewportSpan,
+  needsZoomNormalize,
+  reachedTargetViewport,
   secondaryDelayMs,
   submitLabel,
   toViewportDto,
@@ -122,34 +125,130 @@ describe("buildRecommendBody — 출발지 병합 (L11)", () => {
   });
 });
 
-describe("needsSpanNormalize — 0.5도 초과 뷰포트 예방 판정 (L12)", () => {
-  it("위·경도 어느 한 변이라도 0.5도를 넘으면 정규화가 필요하다 (L12)", () => {
+describe("needsZoomNormalize — 항상 1km 정규화 판정 (L20·L21)", () => {
+  it("현재 줌이 목표 축척 단이 아니면 정규화가 필요하다 (L20)", () => {
+    expect(needsZoomNormalize({ zoom: 16, targetZoom: 13 })).toBe(true);
+    expect(needsZoomNormalize({ zoom: 10, targetZoom: 13 })).toBe(true);
+  });
+
+  it("이미 목표 축척 단이면 정규화가 필요 없다 — 줌 명령을 내면 안 된다 (L21)", () => {
+    expect(needsZoomNormalize({ zoom: 13, targetZoom: 13 })).toBe(false);
+  });
+
+  it("소수 줌은 축척 라벨과 같은 내림 기준으로 같은 단으로 본다 (L21)", () => {
+    expect(needsZoomNormalize({ zoom: 13.4, targetZoom: 13 })).toBe(false);
+  });
+});
+
+describe("reachedTargetViewport — 목표 뷰포트 도달 판정 (L24·D12)", () => {
+  const MOVED: Bounds = {
+    sw: { lat: 35.1523, lng: 129.1521 },
+    ne: { lat: 35.1712, lng: 129.1712 },
+  };
+
+  it("줌이 목표 단이고 이동이 지도에 반영되면 도달이다 (L24)", () => {
     expect(
-      needsSpanNormalize({
-        sw: { lat: 35.0, lng: 129.0 },
-        ne: { lat: 35.6, lng: 129.1 },
+      reachedTargetViewport({
+        bounds: MOVED,
+        boundsAtCommand: BOUNDS,
+        zoom: 13,
+        targetZoom: 13,
       }),
     ).toBe(true);
+  });
+
+  it("이동이 아직 반영되지 않았으면(명령 시점 뷰포트 그대로) 도달이 아니다 (L24)", () => {
     expect(
-      needsSpanNormalize({
-        sw: { lat: 35.0, lng: 129.0 },
-        ne: { lat: 35.1, lng: 129.6 },
+      reachedTargetViewport({
+        bounds: BOUNDS,
+        boundsAtCommand: BOUNDS,
+        zoom: 13,
+        targetZoom: 13,
       }),
-    ).toBe(true);
+    ).toBe(false);
+  });
+
+  it("대기 중 사용자가 줌을 바꿔 목표를 벗어나면 도달이 아니다 (D12)", () => {
+    expect(
+      reachedTargetViewport({
+        bounds: MOVED,
+        boundsAtCommand: BOUNDS,
+        zoom: 16,
+        targetZoom: 13,
+      }),
+    ).toBe(false);
   });
 
-  it("두 변 모두 0.5도 이하면 정규화가 필요 없다 (L12, 경계 포함)", () => {
-    expect(needsSpanNormalize(BOUNDS)).toBe(false);
+  it("지도가 준비되기 전(bounds null)에는 도달이 아니다 (L24)", () => {
     expect(
-      needsSpanNormalize({
-        sw: { lat: 35.0, lng: 129.0 },
-        ne: { lat: 35.5, lng: 129.5 },
+      reachedTargetViewport({
+        bounds: null,
+        boundsAtCommand: BOUNDS,
+        zoom: 13,
+        targetZoom: 13,
       }),
     ).toBe(false);
   });
 
-  it("지도가 준비되기 전(bounds null)에는 정규화를 시도하지 않는다 (L12)", () => {
-    expect(needsSpanNormalize(null)).toBe(false);
+  it("이 마운트에서 이동 명령을 내지 않았으면(재진입) 이미 정착한 뷰포트로 본다 (A7)", () => {
+    expect(
+      reachedTargetViewport({
+        bounds: MOVED,
+        boundsAtCommand: null,
+        zoom: 16,
+        targetZoom: 13,
+      }),
+    ).toBe(true);
+  });
+});
+
+describe("exceedsViewportSpan — 서버 뷰포트 상한 가드 (§12 · developCode 14401)", () => {
+  /** 줌 9(축척 16km)에서 아직 정착하지 않은 지도의 뷰포트 — 검증 실측 span 1.9379° × 4.7461° */
+  const UNSETTLED_WIDE: Bounds = {
+    sw: { lat: 34.2, lng: 126.6 },
+    ne: { lat: 36.1379, lng: 131.3461 },
+  };
+
+  it("정착 전 저줌 뷰포트는 상한을 넘는다 — 이대로 나가면 확정 400(14401)이다 (§12)", () => {
+    expect(
+      exceedsViewportSpan({
+        viewport: toViewportDto(UNSETTLED_WIDE),
+        maxSpanDeg: MAX_VIEWPORT_SPAN_DEG,
+      }),
+    ).toBe(true);
+  });
+
+  it("한 변만 넘어도 상한 초과다 — 위도·경도를 각각 본다 (§12)", () => {
+    const tallOnly: Bounds = {
+      sw: { lat: 35.0, lng: 129.0 },
+      ne: { lat: 35.6, lng: 129.1 },
+    };
+    const wideOnly: Bounds = {
+      sw: { lat: 35.0, lng: 129.0 },
+      ne: { lat: 35.1, lng: 129.6 },
+    };
+
+    expect(
+      exceedsViewportSpan({
+        viewport: toViewportDto(tallOnly),
+        maxSpanDeg: MAX_VIEWPORT_SPAN_DEG,
+      }),
+    ).toBe(true);
+    expect(
+      exceedsViewportSpan({
+        viewport: toViewportDto(wideOnly),
+        maxSpanDeg: MAX_VIEWPORT_SPAN_DEG,
+      }),
+    ).toBe(true);
+  });
+
+  it("1km 단으로 정착한 뷰포트는 상한 안이다 — 정상 경로는 이 가드에 걸리지 않는다 (§12·D10)", () => {
+    expect(
+      exceedsViewportSpan({
+        viewport: toViewportDto(BOUNDS),
+        maxSpanDeg: MAX_VIEWPORT_SPAN_DEG,
+      }),
+    ).toBe(false);
   });
 });
 
diff --git a/apps/web/src/features/ai-route/model/route-request.ts b/apps/web/src/features/ai-route/model/route-request.ts
index ca952007..c6944e44 100644
--- a/apps/web/src/features/ai-route/model/route-request.ts
+++ b/apps/web/src/features/ai-route/model/route-request.ts
@@ -10,7 +10,7 @@ import type { AiRouteStatus } from "./ai-route-store";
  * 추천 요청 조립·제출 판정 (MSG-488 L8·L9).
  * 순수 함수 — 지도 SDK를 모르고 뷰포트를 플랫폼 중립 `Bounds`로 받는다(RN 경계).
  *
- * MSG-489가 출발지 병합(L11)·0.5도 예방 판정(L12)·버튼 문구(L13)·2차 대기(Q2)를 얹었다.
+ * MSG-489가 출발지 병합(L11)·축척 정규화 판정(L20·L24)·버튼 문구(L13)·2차 대기(Q2)를 얹었다.
  */
 
 /** 서버 계약 상한 (RouteRecommendRequestDto.text: trim 후 1~500자) */
@@ -47,22 +47,92 @@ export const buildRecommendBody = ({
   return origin ? { ...body, origin } : body;
 };
 
-/** 서버 뷰포트 상한 (14401) — 위·경도 한 변이 이 값을 넘으면 요청이 거절된다 */
-const MAX_VIEWPORT_SPAN_DEG = 0.5;
+/**
+ * 요청 전 축척 정규화가 필요한가 (L20·L21, D10).
+ * 추천은 **항상 1km 단 뷰포트**에서만 나간다 — 참이면 호출부가 줌을 먼저 맞추고
+ * 새 뷰포트가 반영된 뒤 보낸다(bounds를 잘라 보내지 않는다). 거짓이면 즉시 발사한다:
+ * 이미 목표 단인데 줌 명령을 내면 지도가 `idle`을 내지 않아 요청이 영영 안 나간다 (L21).
+ *
+ * 목표 줌 단은 파라미터로 받는다 — 이 모듈은 지도 축척 상수(features/map-home)를
+ * import하지 않는다(RN 경계·feature 경계). 값 주입은 뷰-레이어 훅 몫이다.
+ * 내림 비교인 이유: 축척 라벨(map-scale)이 내림 기준이라 13.4도 사용자에게는 "1km"다.
+ *
+ * MSG-489 §11에서 0.5도 상한 판정(`needsSpanNormalize`, A2)을 대체했다.
+ * 단 §11이 함께 적은 "항상 1km면 14401이 구조적으로 불가능"은 §12에서 반증됐다 —
+ * 정착 대기 상한이 만료되는 출구(D13)는 이 판정을 거치지 않는다.
+ * 최종 방어선은 아래 `exceedsViewportSpan`이다.
+ */
+export const needsZoomNormalize = ({
+  zoom,
+  targetZoom,
+}: {
+  zoom: number;
+  targetZoom: number;
+}): boolean => Math.floor(zoom) !== targetZoom;
+
+/**
+ * 서버 뷰포트 상한 (developCode 14401) — 요청 사각형의 한 변이 이 값을 넘으면 400이다.
+ *
+ * MSG-489 §11이 "항상 1km 정규화면 14401은 구조적으로 불가능"이라며 이 상수와
+ * `needsSpanNormalize`를 폐기했으나, §12 검증에서 **반증**됐다: 숨은 탭에서는 지도가
+ * `idle`을 내지 않아 뷰포트가 갱신되지 않는데, D13의 종결 출구(정착 상한 만료)가
+ * 그 옛 bounds로 그대로 쏴 줌 9의 1.9379° × 4.7461° 요청이 나가 400을 맞았다(실측).
+ *
+ * 그래서 **정규화 트리거가 아니라 발사 직전 최종 가드**로만 되살렸다 —
+ * 정상 경로의 "항상 1km"(D10)는 그대로이고, 이 판정은 정착 실패 경로에서만 참이 된다.
+ */
+export const MAX_VIEWPORT_SPAN_DEG = 0.5;
+
+/**
+ * 보내려는 사각형이 서버 상한을 넘는가 (§12) — 참이면 호출부는 요청을 보내지 않고
+ * 안내로 종결한다(확정 400을 대신 맞아 주지 않는다). 판정 대상은 **실제로 실릴 body의
+ * viewport**라, 어떤 경로로 조립됐든 같은 가드를 통과한다.
+ * 상한 값은 파라미터로 받는다 — 테스트가 값을 고정하고, 서버 계약이 바뀌어도 호출부만 고친다.
+ */
+export const exceedsViewportSpan = ({
+  viewport,
+  maxSpanDeg,
+}: {
+  viewport: ViewportDto;
+  maxSpanDeg: number;
+}): boolean =>
+  viewport.maxLat - viewport.minLat > maxSpanDeg ||
+  viewport.maxLng - viewport.minLng > maxSpanDeg;
 
 /**
- * 요청 전 축척 정규화가 필요한가 (L12, A2).
- * 참이면 호출부가 1km 단으로 줌을 맞추고 새 뷰포트가 반영된 뒤 보낸다 —
- * bounds를 잘라 보내지 않는다(사용자가 보는 화면과 요청 범위를 어긋나게 두지 않는다).
+ * 목표 뷰포트 도달 판정 (L24·D12) — 2차 자동 재요청의 발사 조건.
+ * "이동 명령이 지도에 반영됐고(bounds 참조 교체) 줌이 목표 단"일 때만 참이라,
+ * 대기 중 사용자가 지도를 만져도 2차가 엉뚱한 뷰포트로 나가지 않는다(지도는 잠그지 않는다).
+ *
+ * `boundsAtCommand`가 null이면 이 마운트에서 이동 명령을 내지 않은 것이다(섹션 재진입, A7) —
+ * 이동은 이전 마운트에서 이미 정착했으므로 도달로 본다.
  */
-export const needsSpanNormalize = (bounds: Bounds | null): boolean => {
+export const reachedTargetViewport = ({
+  bounds,
+  boundsAtCommand,
+  zoom,
+  targetZoom,
+}: {
+  bounds: Bounds | null;
+  /** 이동 명령을 낸 시점의 bounds — 새 bounds가 들어오면 참조가 바뀐다 */
+  boundsAtCommand: Bounds | null;
+  zoom: number;
+  targetZoom: number;
+}): boolean => {
   if (bounds === null) return false;
+  if (boundsAtCommand === null) return true;
   return (
-    bounds.ne.lat - bounds.sw.lat > MAX_VIEWPORT_SPAN_DEG ||
-    bounds.ne.lng - bounds.sw.lng > MAX_VIEWPORT_SPAN_DEG
+    bounds !== boundsAtCommand && !needsZoomNormalize({ zoom, targetZoom })
   );
 };
 
+/**
+ * 지도 정착 대기 상한 (D13) — 목표 도달 판정이 성립하지 않아도 이 시간이 지나면
+ * 현재 뷰포트로 보낸다. 사용자가 대기 중 줌을 되돌리면 목표에 영영 닿지 않는데,
+ * 그때 패널이 로딩에 갇히는 것을 막는 유일한 출구다. 어떤 경로로도 요청은 1회 종결한다.
+ */
+export const VIEWPORT_SETTLE_TIMEOUT_MS = 3_000;
+
 /** 제출 버튼 문구 (L13·D9) — 출발지를 실어 보낸 결과 화면만 "현재 위치에서" 접두가 붙는다 */
 export const submitLabel = ({
   status,
diff --git a/apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx b/apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx
index 46a5d95f..a93599d6 100644
--- a/apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx
+++ b/apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx
@@ -5,6 +5,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { RequireAuth } from "@/app/RequireAuth";
 import { useAiRouteStore } from "@/features/ai-route/model/ai-route-store";
 import { useLoginModalStore } from "@/features/auth/model/login-modal-store";
+import { MAP_SCALE_1KM_ZOOM } from "@/features/map-home/model/map-scale";
 import { useViewportStore } from "@/features/map-home/model/viewport-store";
 import { useMapOverlayStore } from "@/widgets/map-shell/map-overlay-store";
 import type { MapShellContext } from "@/widgets/map-shell/use-map-shell";
@@ -85,12 +86,14 @@ beforeEach(() => {
   useLoginModalStore.setState({ open: false });
   useAiRouteStore.setState(useAiRouteStore.getInitialState(), true);
   useMapOverlayStore.setState(useMapOverlayStore.getInitialState(), true);
-  // 지도 준비 완료 — 요청 뷰포트의 근원 (부산 서면)
+  // 지도 준비 완료 — 요청 뷰포트의 근원 (부산 서면).
+  // 줌은 1km 단으로 둔다: MSG-489 §11 이후 제출은 이 단에서만 즉시 발사된다 (D10)
   useViewportStore.setState({
     bounds: {
       sw: { lat: 35.1521, lng: 129.0537 },
       ne: { lat: 35.1662, lng: 129.0712 },
     },
+    zoom: MAP_SCALE_1KM_ZOOM,
   });
   moveTo.mockClear();
 });
diff --git a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx
index 93a6825f..aa23867a 100644
--- a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx
+++ b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx
@@ -7,6 +7,7 @@ import type { Bounds } from "@/entities/cell";
 import { useAiRouteStore } from "@/features/ai-route/model/ai-route-store";
 import {
   SECONDARY_MIN_INTERVAL_MS,
+  VIEWPORT_SETTLE_TIMEOUT_MS,
   toViewportDto,
 } from "@/features/ai-route/model/route-request";
 import { MAP_SCALE_1KM_ZOOM } from "@/features/map-home/model/map-scale";
@@ -47,6 +48,14 @@ const BOUNDS_AFTER: Bounds = {
   ne: { lat: 35.1712, lng: 129.1712 },
 };
 const CURRENT_POSITION = { lat: 35.1579, lng: 129.0594 };
+/**
+ * 줌 9(축척 16km)에서 아직 1km로 정착하지 못한 뷰포트 — 검증 실측 span 1.9379° × 4.7461°.
+ * 현위치를 품고 있어 제출은 정상 진입한다(originActive true).
+ */
+const UNSETTLED_WIDE: Bounds = {
+  sw: { lat: 34.2, lng: 126.6 },
+  ne: { lat: 36.1379, lng: 131.3461 },
+};
 
 const MENTIONED_AREA: MentionedAreaDto = {
   name: "부산 해운대",
@@ -90,8 +99,8 @@ const stubBothWithMentionedArea = () =>
     }),
   );
 
-/** 현위치 확보 대기 → 1차 제출 → 자동 이동 명령 도착까지 */
-const submitAndAwaitMove = async () => {
+/** 렌더 → 현위치 확보 대기 → 제출. 제출 전 줌은 각 시나리오가 세팅한다 */
+const renderAndSubmit = async () => {
   const rendered = renderHook(
     () => useAiRouteAutoMove({ onLoginRequired: vi.fn() }),
     { wrapper },
@@ -99,26 +108,90 @@ const submitAndAwaitMove = async () => {
 
   await waitFor(() => expect(rendered.result.current.originActive).toBe(true));
   act(() => rendered.result.current.submit());
+
+  return rendered;
+};
+
+/** 제출 → 자동 이동 명령 도착까지 */
+const submitAndAwaitMove = async () => {
+  const rendered = await renderAndSubmit();
   await waitFor(() => expect(moveTo).toHaveBeenCalledTimes(1));
 
   return rendered;
 };
 
+/** 지도가 새 뷰포트로 정착한다 — 줌 단은 시나리오가 정한다(기본은 목표 1km) */
+const settleViewport = (bounds: Bounds, zoom = MAP_SCALE_1KM_ZOOM) => {
+  act(() => useViewportStore.setState({ bounds, zoom }));
+};
+
 /** 지도 이동이 반영돼 새 bounds가 들어오고, 서버 10초 창도 지난 상태를 만든다 */
 const settleNewViewport = () => {
-  act(() => {
+  act(() =>
     useAiRouteStore.setState({
       requestedAt: Date.now() - SECONDARY_MIN_INTERVAL_MS,
+    }),
+  );
+  settleViewport(BOUNDS_AFTER);
+};
+
+/** 제출 → 자동 이동 → 서버 10초 창 경과 → 대기 중 사용자가 지도를 바꾼다 (도달 실패 경로) */
+const submitThenDisturbViewport = async (bounds: Bounds, zoom: number) => {
+  const rendered = await submitAndAwaitMove();
+  act(() =>
+    useAiRouteStore.setState({
+      requestedAt: Date.now() - SECONDARY_MIN_INTERVAL_MS,
+    }),
+  );
+  settleViewport(bounds, zoom);
+
+  return rendered;
+};
+
+/** 지도가 목표 축척으로 정착하면 그 뷰포트로 1차가 1회 나간다 — 정규화 경로의 공통 종착 */
+const settleAndExpectPrimaryFired = async (
+  received: ReturnType<typeof stubBothWithMentionedArea>,
+) => {
+  settleViewport(BOUNDS_AFTER);
+
+  await waitFor(() => expect(received).toHaveLength(1));
+  expect(received[0].body).toMatchObject({
+    viewport: toViewportDto(BOUNDS_AFTER),
+  });
+};
+
+/**
+ * 탭 가시성 스텁 — jsdom의 `document.visibilityState`는 프로토타입 getter라 재정의로 바꾼다.
+ * 숨은 탭에서는 rAF가 멈춰 지도가 `idle`을 내지 않는다(§12 결함의 조건).
+ */
+const setVisibility = (state: DocumentVisibilityState) => {
+  act(() => {
+    Object.defineProperty(document, "visibilityState", {
+      value: state,
+      configurable: true,
     });
-    useViewportStore.setState({ bounds: BOUNDS_AFTER });
+    document.dispatchEvent(new Event("visibilitychange"));
+  });
+};
+
+/** 정착 상한을 실제로 넘겨 본다 — 이 훅의 대기는 실타이머 기반이다 */
+const waitPastSettleTimeout = async () => {
+  await act(async () => {
+    await new Promise((resolve) =>
+      setTimeout(resolve, VIEWPORT_SETTLE_TIMEOUT_MS + 300),
+    );
   });
 };
 
 beforeEach(() => {
   useAiRouteStore.setState(useAiRouteStore.getInitialState(), true);
   useAiRouteStore.getState().setText("해운대에서 저녁 먹고 산책");
-  useViewportStore.setState({ bounds: BOUNDS_BEFORE });
+  useViewportStore.setState({
+    bounds: BOUNDS_BEFORE,
+    zoom: MAP_SCALE_1KM_ZOOM,
+  });
   allowPositionAt(CURRENT_POSITION);
+  setVisibility("visible");
   moveTo.mockClear();
   zoomTo.mockClear();
 });
@@ -154,14 +227,10 @@ describe("useAiRouteAutoMove — 언급 지역 자동 이동과 2차 재요청 (
       expect(useAiRouteStore.getState().status).toBe("result"),
     );
     // 2차 응답 뒤 뷰포트가 또 갱신돼도 예약이 남아 있지 않다
-    act(() =>
-      useViewportStore.setState({
-        bounds: {
-          sw: { lat: 35.15, lng: 129.15 },
-          ne: { lat: 35.18, lng: 129.18 },
-        },
-      }),
-    );
+    settleViewport({
+      sw: { lat: 35.15, lng: 129.15 },
+      ne: { lat: 35.18, lng: 129.18 },
+    });
 
     expect(received).toHaveLength(2);
     expect(moveTo).toHaveBeenCalledTimes(1);
@@ -204,7 +273,10 @@ describe("useAiRouteAutoMove — 언급 지역 자동 이동과 2차 재요청 (
         secondaryPending: true,
         requestedAt: Date.now() - SECONDARY_MIN_INTERVAL_MS,
       });
-      useViewportStore.setState({ bounds: BOUNDS_AFTER });
+      useViewportStore.setState({
+        bounds: BOUNDS_AFTER,
+        zoom: MAP_SCALE_1KM_ZOOM,
+      });
     });
 
     renderHook(() => useAiRouteAutoMove({ onLoginRequired: vi.fn() }), {
@@ -222,7 +294,7 @@ describe("useAiRouteAutoMove — 언급 지역 자동 이동과 2차 재요청 (
     const received = stubBothWithMentionedArea();
 
     await submitAndAwaitMove();
-    act(() => useViewportStore.setState({ bounds: BOUNDS_AFTER }));
+    settleViewport(BOUNDS_AFTER);
     await act(async () => {
       await Promise.resolve();
     });
@@ -232,3 +304,148 @@ describe("useAiRouteAutoMove — 언급 지역 자동 이동과 2차 재요청 (
     expect(useAiRouteStore.getState().points).toHaveLength(0);
   });
 });
+
+describe("항상 1km 정규화 (L20~L23·D10·D11)", () => {
+  /** 제출 시점 줌이 1km 단이 아닌 상태 — 정규화 대기로 들어간다 */
+  const startWide = () =>
+    useViewportStore.setState({ bounds: BOUNDS_BEFORE, zoom: 16 });
+
+  it("현재 줌이 1km 단이 아니면 제출이 요청을 보내지 않고 줌만 맞춘다 (L20)", async () => {
+    const received = stubBothWithMentionedArea();
+    startWide();
+
+    await renderAndSubmit();
+
+    expect(zoomTo).toHaveBeenCalledTimes(1);
+    expect(zoomTo).toHaveBeenCalledWith(MAP_SCALE_1KM_ZOOM);
+    expect(received).toHaveLength(0);
+  });
+
+  it("제출 클릭 즉시 로딩이고 요청 시각은 mutate 시점에만 기록된다 (L23·D11)", async () => {
+    stubBothWithMentionedArea();
+    startWide();
+
+    await renderAndSubmit();
+
+    expect(useAiRouteStore.getState().status).toBe("loading");
+    expect(useAiRouteStore.getState().requestedAt).toBeNull();
+  });
+
+  it("줌이 목표에 도달하면 요청이 정확히 1회 나간다 — StrictMode 2회 실행 포함 (L22)", async () => {
+    const received = stubBothWithMentionedArea();
+    startWide();
+
+    await renderAndSubmit();
+    await settleAndExpectPrimaryFired(received);
+
+    expect(useAiRouteStore.getState().requestedAt).not.toBeNull();
+    // 새 뷰포트가 또 들어와도 1차가 다시 나가지 않는다
+    settleViewport(BOUNDS_BEFORE);
+    expect(received).toHaveLength(1);
+  });
+
+  it("이미 1km 단이면 줌 명령 없이 즉시 발사한다 (L21)", async () => {
+    const received = stubBothWithMentionedArea();
+
+    await renderAndSubmit();
+
+    // 자동 이동 응답이 오기 전 — 정규화 줌 명령이 아예 없어야 한다
+    expect(zoomTo).not.toHaveBeenCalled();
+    await waitFor(() => expect(received).toHaveLength(1));
+  });
+});
+
+describe("2차 종결 보장과 결과 후 자유 확대 (L24·L25)", () => {
+  it("목표 도달에 실패해도 대기 창이 지나면 현재 뷰포트로 2차가 1회 나간다 (L24 — 영구 로딩 금지)", async () => {
+    const received = stubBothWithMentionedArea();
+
+    // 대기 중 사용자가 줌을 바꿔 목표(1km)를 벗어난다 — 도달 판정이 영영 성립하지 않는다
+    await submitThenDisturbViewport(BOUNDS_AFTER, 16);
+
+    expect(received).toHaveLength(1);
+    await waitFor(() => expect(received).toHaveLength(2), {
+      timeout: VIEWPORT_SETTLE_TIMEOUT_MS + 1_000,
+    });
+    expect(received[1].body).toMatchObject({
+      viewport: toViewportDto(BOUNDS_AFTER),
+    });
+    await waitFor(() =>
+      expect(useAiRouteStore.getState().status).toBe("result"),
+    );
+  });
+
+  it("결과 상태에서 뷰포트가 바뀌어도 recommend가 추가로 나가지 않는다 (L25)", async () => {
+    const received = stubFetch(() =>
+      envelopeResponse({
+        points: ROUTE_POINTS,
+        notice: null,
+        mentionedArea: null,
+      }),
+    );
+
+    await renderAndSubmit();
+    await waitFor(() =>
+      expect(useAiRouteStore.getState().status).toBe("result"),
+    );
+
+    settleViewport(BOUNDS_AFTER, 16);
+    settleViewport(BOUNDS_BEFORE);
+
+    expect(received).toHaveLength(1);
+    expect(zoomTo).not.toHaveBeenCalled();
+  });
+});
+
+describe("서버 뷰포트 상한 가드와 탭 가시성 (§12 — 14401 재현 방지)", () => {
+  /** 줌 9에서 제출 — 정규화 대기로 들어가지만 지도가 정착하지 못한 상태를 만든다 */
+  const startUnsettledWide = () =>
+    useViewportStore.setState({ bounds: UNSETTLED_WIDE, zoom: 9 });
+
+  it("정착 상한이 만료돼도 뷰포트가 서버 상한을 넘으면 요청을 보내지 않고 안내로 종결한다 (§12·S8)", async () => {
+    const received = stubBothWithMentionedArea();
+    startUnsettledWide();
+
+    await renderAndSubmit();
+
+    await waitFor(
+      () => expect(useAiRouteStore.getState().status).toBe("error"),
+      { timeout: VIEWPORT_SETTLE_TIMEOUT_MS + 1_000 },
+    );
+    expect(received).toHaveLength(0);
+    // 사용자가 다시 누를 수 있어야 한다 — 영구 로딩도, 확정 400도 아니다 (D13)
+    expect(useAiRouteStore.getState().errorNotice?.retryable).toBe(true);
+    expect(useAiRouteStore.getState().normalizePending).toBe(false);
+  });
+
+  it("숨은 탭에서는 정착 상한을 소모하지 않고, 복귀 후 정착한 1km 뷰포트로 1회 나간다 (§12)", async () => {
+    const received = stubBothWithMentionedArea();
+    startUnsettledWide();
+    setVisibility("hidden");
+
+    await renderAndSubmit();
+    await waitPastSettleTimeout();
+
+    expect(received).toHaveLength(0);
+    expect(useAiRouteStore.getState().status).toBe("loading");
+
+    // 탭 복귀 → rAF 재개 → 지도가 목표 축척으로 정착한다
+    setVisibility("visible");
+    await settleAndExpectPrimaryFired(received);
+
+    expect(useAiRouteStore.getState().status).not.toBe("error");
+  });
+
+  it("2차 종결 상한에서도 과대 뷰포트로는 쏘지 않고 안내로 종결한다 (§12 — 어떤 경로로도)", async () => {
+    const received = stubBothWithMentionedArea();
+
+    // 대기 중 사용자가 크게 줌아웃 — 도달 실패 + 상한 초과가 겹치는 경로
+    await submitThenDisturbViewport(UNSETTLED_WIDE, 9);
+
+    await waitFor(
+      () => expect(useAiRouteStore.getState().status).toBe("error"),
+      { timeout: VIEWPORT_SETTLE_TIMEOUT_MS + 1_000 },
+    );
+    expect(received).toHaveLength(1);
+    expect(useAiRouteStore.getState().secondaryPending).toBe(false);
+  });
+});
diff --git a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts
index 71cc4311..c7ea31c0 100644
--- a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts
+++ b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts
@@ -3,10 +3,15 @@ import type { Bounds, LatLng } from "@/entities/cell";
 import { useRouteRecommend } from "@/features/ai-route/api/use-route-recommend";
 import { useAiRouteStore } from "@/features/ai-route/model/ai-route-store";
 import type { RouteAutoMove } from "@/features/ai-route/model/route-mentioned-area";
+import { VIEWPORT_TOO_WIDE_NOTICE } from "@/features/ai-route/model/route-error";
 import { resolveRouteOrigin } from "@/features/ai-route/model/route-origin";
 import {
+  MAX_VIEWPORT_SPAN_DEG,
+  VIEWPORT_SETTLE_TIMEOUT_MS,
   buildRecommendBody,
-  needsSpanNormalize,
+  exceedsViewportSpan,
+  needsZoomNormalize,
+  reachedTargetViewport,
   secondaryDelayMs,
 } from "@/features/ai-route/model/route-request";
 import { MAP_SCALE_1KM_ZOOM } from "@/features/map-home/model/map-scale";
@@ -16,16 +21,22 @@ import { getCurrentPositionOrNull } from "@/shared/geolocation";
 import { useMapShell } from "@/widgets/map-shell/use-map-shell";
 
 /**
- * AI 경로추천 자동 동작 오케스트레이션 (MSG-489 L16~L19).
+ * AI 경로추천 자동 동작 오케스트레이션 (MSG-489 L16~L25).
  * **뷰-레이어 훅** — 지도 명령(`use-map-shell`)에 직접 배선하므로 RN 재사용 대상이 아니다.
  * 판정은 전부 순수 함수(`route-origin`·`route-mentioned-area`·`route-request`)가 소유하고,
- * 여기에는 "언제 무엇을 호출하는가"만 남는다.
+ * 여기에는 "언제 무엇을 호출하는가"와 목표 줌 단(`MAP_SCALE_1KM_ZOOM`) 주입만 남는다.
  *
  * 세 가지 자동 동작을 한 훅에 모은 이유: 셋 다 같은 재료(현위치·뷰포트 bounds·요청 시각)를
  * 공유하고 한 요청 사이클 안에서 순서로 얽혀 있다 — 나누면 재료를 이중으로 들고 있게 된다.
- *  ① 제출 시 출발지 자동 판정(D8)과 0.5도 예방 정규화(A2)
+ *  ① 제출 시 출발지 자동 판정(D8)과 **항상 1km 축척 정규화**(D10 — §11에서 A2를 대체)
  *  ② 응답 mentionedArea → 지도 이동 + 1km 축척 고정(D2)
- *  ③ 새 뷰포트가 반영된 뒤 2차 자동 재요청 1회(D4·Q2 안 B)
+ *  ③ 목표 뷰포트에 도달하면 2차 자동 재요청 1회(D4·D12·Q2 안 B)
+ *
+ * 두 대기(정규화·2차) 모두 **반드시 종결한다** — 목표 도달 판정이 성립하지 않는 경로에서도
+ * `VIEWPORT_SETTLE_TIMEOUT_MS` 뒤에는 현재 뷰포트로 보낸다. 패널이 로딩에 갇히면 안 된다 (D13).
+ * 단 그 출구가 **서버 상한을 넘는 뷰포트를 쏘면 확정 400(14401)** 이라, 발사는 전부
+ * `send()` 하나를 거치고 상한을 넘으면 보내는 대신 안내로 종결한다 (§12).
+ * 결과 상태에서는 두 대기 플래그가 모두 꺼져 있어 뷰포트가 바뀌어도 요청이 나가지 않는다 (D14·L25).
  */
 
 /** 진입 시 1회 측위 — 거부·미확보는 null 그대로 둔다(서면 폴백을 쓰면 오판정된다, A1) */
@@ -45,8 +56,31 @@ const useCurrentCoords = (): LatLng | null => {
   return coords;
 };
 
+/**
+ * 탭 가시성 (§12) — 숨은 탭에서는 rAF가 멈춰 네이버 지도가 줌 애니메이션도 `idle`도
+ * 진행하지 않는다. 그 동안 정착 대기 상한을 소모시키면 **갱신되지 않은 옛 뷰포트**로
+ * 발사돼 14401을 맞는다(검증 실측: 줌 9에서 제출 후 백그라운드 전환 → 1.94° × 4.75° 요청).
+ * 그래서 숨은 동안에는 상한 타이머를 걸지 않고, 복귀 시 다시 잰다.
+ *
+ * `document` 접근이 여기 있는 이유: 이 파일은 **뷰-레이어 훅**이다. 순수 모델
+ * (`route-request` 등)은 플랫폼을 몰라야 하므로 판정만 갖고 가시성은 모른다 (RN 경계).
+ */
+const useDocumentVisible = (): boolean => {
+  const [visible, setVisible] = useState(
+    () => document.visibilityState === "visible",
+  );
+
+  useEffect(() => {
+    const sync = () => setVisible(document.visibilityState === "visible");
+    document.addEventListener("visibilitychange", sync);
+    return () => document.removeEventListener("visibilitychange", sync);
+  }, []);
+
+  return visible;
+};
+
 interface AiRouteAutoMove {
-  /** 제출 — 축척 정규화가 필요하면 줌을 먼저 맞추고 새 뷰포트가 반영된 뒤 보낸다 */
+  /** 제출 — 축척이 1km 단이 아니면 줌을 먼저 맞추고 새 뷰포트가 반영된 뒤 보낸다 (D10) */
   submit: () => void;
   /** 이번 뷰포트 기준으로 출발지가 실리는가 — 입력 카드의 "현재 위치에서 출발" 표시 (S1) */
   originActive: boolean;
@@ -59,10 +93,15 @@ export const useAiRouteAutoMove = ({
 }): AiRouteAutoMove => {
   const { moveTo, zoomTo } = useMapShell();
   const bounds = useViewportStore((s) => s.bounds);
+  const zoom = useViewportStore((s) => s.zoom);
   const text = useAiRouteStore((s) => s.text);
+  const normalizePending = useAiRouteStore((s) => s.normalizePending);
   const secondaryPending = useAiRouteStore((s) => s.secondaryPending);
   const requestedAt = useAiRouteStore((s) => s.requestedAt);
+  const startNormalize = useAiRouteStore((s) => s.startNormalize);
+  const abortPending = useAiRouteStore((s) => s.abortPending);
 
+  const visible = useDocumentVisible();
   const coords = useCurrentCoords();
   const origin = useMemo(
     () => resolveRouteOrigin({ coords, bounds }),
@@ -72,10 +111,6 @@ export const useAiRouteAutoMove = ({
   // 이동 명령 직후의 bounds — 2차는 이 값이 **바뀐 뒤**에만 나간다.
   // moveTo·zoomTo는 명령일 뿐이고 새 bounds는 MapCanvas idle을 거쳐 스토어에 들어온다(R3).
   const boundsAtMoveRef = useRef<Bounds | null>(null);
-  // 0.5도 초과 뷰포트 정규화 대기 — 줌을 맞춘 뒤 새 bounds로 1차를 보낸다 (A2).
-  // state가 아니라 ref인 이유: 대기 여부는 화면에 안 보이고, 발사 시점은 bounds 갱신이
-  // 정한다. state로 두면 StrictMode(dev)의 이펙트 2회 실행에서 같은 요청이 두 번 나간다.
-  const normalizingRef = useRef(false);
 
   const onAutoMove = useCallback(
     (move: RouteAutoMove) => {
@@ -92,54 +127,105 @@ export const useAiRouteAutoMove = ({
   });
   const { mutate: sendSecondary } = useRouteRecommend({ secondary: true });
 
+  /**
+   * 이 훅의 **유일한 발사 지점** — 어떤 경로(즉시·정규화 대기·2차·상한 만료)로 와도
+   * 여기를 지난다. 보냈으면 true, 보내지 않았으면 false다(호출부가 종결을 책임진다).
+   */
   const send = useCallback(
-    (mutate: (body: RouteRecommendRequestDto) => void) => {
+    (mutate: (body: RouteRecommendRequestDto) => void): boolean => {
       // 출발지는 **보내는 시점의 뷰포트**로 판정한다 — 2차는 이동 후 기준이다 (L19·A5)
       const body = buildRecommendBody({ text, bounds, origin });
-      if (body === null) return;
+      if (body === null) return false;
+      // 서버 뷰포트 상한 최종 가드 (§12) — 정상 경로(1km)에서는 결코 참이 아니고,
+      // 지도가 정착하지 못한 채 상한이 만료된 경로에서만 걸린다. 확정 400을 보내지 않는다.
+      if (
+        exceedsViewportSpan({
+          viewport: body.viewport,
+          maxSpanDeg: MAX_VIEWPORT_SPAN_DEG,
+        })
+      ) {
+        return false;
+      }
       mutate(body);
+      return true;
     },
     [text, bounds, origin],
   );
 
   const submit = useCallback(() => {
-    if (needsSpanNormalize(bounds)) {
-      // 서버 상한(14401) 예방 — 지역 이동이 아니므로 토스트는 띄우지 않는다 (A2)
-      normalizingRef.current = true;
+    if (needsZoomNormalize({ zoom, targetZoom: MAP_SCALE_1KM_ZOOM })) {
+      // 추천은 1km 단에서만 나간다 — 클릭 즉시 로딩이고 요청 시각은 mutate 때 찍는다 (D10·D11)
+      startNormalize();
       zoomTo(MAP_SCALE_1KM_ZOOM);
       return;
     }
     send(sendPrimary);
-  }, [bounds, zoomTo, send, sendPrimary]);
+  }, [zoom, zoomTo, startNormalize, send, sendPrimary]);
 
   useEffect(() => {
-    if (!normalizingRef.current || needsSpanNormalize(bounds)) return;
-    normalizingRef.current = false;
-    send(sendPrimary);
-  }, [bounds, send, sendPrimary]);
+    if (!normalizePending) return;
+
+    // 예약이 이미 소비됐으면 쏘지 않는다 — StrictMode(dev)의 이펙트 2회 실행 방어.
+    // 첫 실행의 `onMutate`(startRequest)가 플래그를 끄므로 두 번째 실행은 여기서 멈춘다 (L22).
+    const fire = () => {
+      if (!useAiRouteStore.getState().normalizePending) return;
+      // 보내지 못하면(뷰포트가 서버 상한 초과) 안내로 종결한다 — 영구 로딩도 400도 아니다 (§12)
+      if (!send(sendPrimary)) abortPending(VIEWPORT_TOO_WIDE_NOTICE);
+    };
+
+    if (!needsZoomNormalize({ zoom, targetZoom: MAP_SCALE_1KM_ZOOM })) {
+      fire();
+      return;
+    }
+    // 숨은 탭에서는 지도가 정착하지 않는다 — 상한을 소모하지 않고 복귀 시 다시 잰다 (§12)
+    if (!visible) return;
+    // 대기 중 사용자가 줌을 되돌리면 목표에 영영 닿지 않는다 — 상한을 두고 종결한다 (D13)
+    const timer = setTimeout(fire, VIEWPORT_SETTLE_TIMEOUT_MS);
+    return () => clearTimeout(timer);
+  }, [normalizePending, zoom, visible, send, sendPrimary, abortPending]);
 
   useEffect(() => {
-    if (!secondaryPending) return;
-    // 옛 bounds로 쏘면 2차가 무의미하다 — 이동이 지도에 반영될 때까지 기다린다 (R3·L18)
-    if (bounds === null || bounds === boundsAtMoveRef.current) return;
+    if (!secondaryPending || bounds === null) return;
 
-    // 예약이 이미 소비됐으면 쏘지 않는다 — StrictMode(dev)의 이펙트 2회 실행 방어.
-    // 첫 실행의 `onMutate`가 예약을 끄므로 두 번째 실행은 여기서 멈춘다.
+    // 예약 소비 여부는 스토어가 정본이다 — 위 정규화 이펙트와 같은 StrictMode 방어
     const fire = () => {
       if (!useAiRouteStore.getState().secondaryPending) return;
-      send(sendSecondary);
+      if (!send(sendSecondary)) abortPending(VIEWPORT_TOO_WIDE_NOTICE);
     };
 
+    // 옛 뷰포트로 쏘면 2차가 무의미하고(R3·L18), 진행 중 조작이 섞이면 엉뚱한 범위가 나간다 (D12)
+    const reached = reachedTargetViewport({
+      bounds,
+      boundsAtCommand: boundsAtMoveRef.current,
+      zoom,
+      targetZoom: MAP_SCALE_1KM_ZOOM,
+    });
     // 서버 재요청 제한(14429)은 자동 재요청도 예외가 아니다 — 남은 창만큼 로딩을 유지한다 (Q2)
     const delay = secondaryDelayMs({ requestedAt, now: Date.now() });
-    if (delay <= 0) {
+    if (reached && delay <= 0) {
       fire();
       return;
     }
-    const timer = setTimeout(fire, delay);
+    // 도달 대기 중 탭이 숨으면 지도가 정착하지 않는다 — 상한을 소모하지 않는다 (§12).
+    // 이미 도달했으면 남은 것은 서버 10초 창뿐이라 숨은 채로도 계속 잰다.
+    if (!reached && !visible) return;
+    // 도달 실패 경로에서도 창 경과 후에는 현재 뷰포트로 1회 보낸다 — 영구 로딩 금지 (D13·L24)
+    const timer = setTimeout(
+      fire,
+      reached ? delay : Math.max(delay, VIEWPORT_SETTLE_TIMEOUT_MS),
+    );
     // 재제출·언마운트·뷰포트 재갱신 시 예약을 취소한다 (Q2 — 대기 중 이탈)
     return () => clearTimeout(timer);
-  }, [secondaryPending, bounds, requestedAt, send, sendSecondary]);
+  }, [
+    secondaryPending,
+    bounds,
+    zoom,
+    visible,
+    requestedAt,
+    send,
+    sendSecondary,
+    abortPending,
+  ]);
 
   return { submit, originActive: origin !== null };
 };
diff --git a/apps/web/src/widgets/map-shell/MapShell.tsx b/apps/web/src/widgets/map-shell/MapShell.tsx
index 87a6f0b7..161ffe82 100644
--- a/apps/web/src/widgets/map-shell/MapShell.tsx
+++ b/apps/web/src/widgets/map-shell/MapShell.tsx
@@ -3,6 +3,7 @@ import { Outlet, useLocation, useNavigate } from "react-router-dom";
 import { ROUTES } from "@/app/routes";
 import type { LatLng } from "@/entities/cell";
 import { buildCellClickHandler } from "./grid-click-routing";
+import { gateRouteClusters } from "./cluster-route-gate";
 import { useMapOverlayStore } from "./map-overlay-store";
 import { gateFillCells } from "@/features/map-home/model/cluster-overlay";
 import {
@@ -111,6 +112,8 @@ export const MapShell = () => {
     viewportBounds,
     viewportZoom,
   );
+  // 칩 바 표시(AC 14)와 집계 마커 게이트(MSG-489 §12)가 같은 pathname을 읽는다
+  const { pathname } = useLocation();
   // 집계 소스는 칩 기준 **택일** (MSG-475 AC 14) — 한 지도에 두 종류의 집계 마커가
   // 서지 않는다. 경로추천 칩은 집계 층이 없고, 도감 집계는 훅이 로그인·칩 없음을 게이트한다
   const clusters = useMemo(() => {
@@ -133,6 +136,12 @@ export const MapShell = () => {
     aggregationUnit,
     viewportZoom,
   ]);
+  // AI 경로추천에서는 다른 섹션의 집계 마커를 지도에 남기지 않는다 (MSG-489 §12 — 사용자 지시).
+  // 파생은 그대로 두고 셸이 내리는 값만 걷는다 — 다른 섹션 동작 영향 0
+  const visibleClusters = useMemo(
+    () => gateRouteClusters(clusters, pathname),
+    [clusters, pathname],
+  );
   // 오버레이 셀 클릭(MSG-122 AC 14·18) — 핸들러도 스토어 중계, null이면 표시 전용 기존 동작(R3)
   const onOverlayCellClick = useMapOverlayStore((s) => s.onCellClick);
   // 경로 경유지 마커 클릭(MSG-488 S8) — AI 경로추천 패널이 게시, null이면 코스 마커는 비클릭
@@ -176,7 +185,6 @@ export const MapShell = () => {
 
   // 칩 바는 홈에서만 뜨지만 **접힘 래퍼 밖**이다 (AC 14) — 패널을 접어도 칩은 지도 위에
   // 남아야 한다. 접힘 래퍼(hidden) 안의 MapHomePage가 그리던 것을 셸로 올렸다
-  const { pathname } = useLocation();
   const isHome = pathname === ROUTES.home;
 
   const mapRef = useRef<MapCanvasHandle>(null);
@@ -218,7 +226,7 @@ export const MapShell = () => {
           gridLines={gridLines}
           routes={routeOverlays}
           labels={labelOverlays}
-          clusters={clusters}
+          clusters={visibleClusters}
           onOverlayCellClick={handleCellClick}
           onRouteWaypointClick={onRouteWaypointClick ?? undefined}
         />
diff --git a/apps/web/src/widgets/map-shell/cluster-route-gate.test.ts b/apps/web/src/widgets/map-shell/cluster-route-gate.test.ts
new file mode 100644
index 00000000..bd2ca655
--- /dev/null
+++ b/apps/web/src/widgets/map-shell/cluster-route-gate.test.ts
@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { ROUTES } from "@/app/routes";
+import { gateRouteClusters } from "./cluster-route-gate";
+
+/** 저줌 집계 마커 3종(지역 점령·미션·핫구역)이 셸에서 파생돼 내려오는 모양의 표본 */
+const CLUSTERS = [
+  { id: "busanjin-gu", count: 12 },
+  { id: "haeundae-gu", count: 4 },
+];
+
+describe("gateRouteClusters — AI 경로추천에서 집계 마커 숨김 (MSG-489 §12)", () => {
+  it("/ai-route에서는 집계 마커를 한 개도 내리지 않는다", () => {
+    expect(gateRouteClusters(CLUSTERS, ROUTES.aiRoute)).toEqual([]);
+  });
+
+  it("지도 홈에서는 파생된 집계 마커를 그대로 내린다 — 다른 섹션 영향 0", () => {
+    expect(gateRouteClusters(CLUSTERS, ROUTES.home)).toBe(CLUSTERS);
+  });
+
+  it("도감·프로필 등 다른 섹션도 기존 동작을 유지한다", () => {
+    expect(gateRouteClusters(CLUSTERS, ROUTES.dex)).toBe(CLUSTERS);
+    expect(gateRouteClusters(CLUSTERS, ROUTES.profile)).toBe(CLUSTERS);
+  });
+});
diff --git a/apps/web/src/widgets/map-shell/cluster-route-gate.ts b/apps/web/src/widgets/map-shell/cluster-route-gate.ts
new file mode 100644
index 00000000..e224f7fb
--- /dev/null
+++ b/apps/web/src/widgets/map-shell/cluster-route-gate.ts
@@ -0,0 +1,14 @@
+import { ROUTES } from "@/app/routes";
+
+/**
+ * 저줌 집계 마커의 경로 게이트 (MSG-489 §12, 사용자 지시 2026-08-29).
+ *
+ * 지시 원문: "ai 경로 추천인 상태에서는 다른 애들 클러스터링 된 것들 안보이게 해 /
+ * 한마디로 줌레벨 100m보다 커지면 더 이상 지도상에서 안 보이게 하라는 뜻이야".
+ * 집계 마커(지역 점령·미션·핫구역) 3종은 **줌 16(100m) 미만에서만** 존재하는 층이라
+ * — 16 이상에서는 격자 채움으로 전환된다 — 이 경로 게이트 하나로 지시가 전부 충족된다.
+ *
+ * 셸이 파생한 결과에만 적용한다: 파생 훅(집계 쿼리)은 손대지 않아 다른 섹션 영향이 0이다.
+ */
+export const gateRouteClusters = <T>(clusters: T[], pathname: string): T[] =>
+  pathname === ROUTES.aiRoute ? [] : clusters;
diff --git a/docs/STATUS.md b/docs/STATUS.md
index 12ef7cf3..0b5e1e65 100644
--- a/docs/STATUS.md
+++ b/docs/STATUS.md
@@ -19,7 +19,7 @@
 | (error) | `RouteErrorBoundary` | 렌더·로더 오류 + 404 수렴 (MSG-325). "홈으로"는 `shared/navigation.redirectTo` 하드 이동 — 라우터 navigate는 same-location 에러를 못 푼다 (MSG-477 ②). `<main>`+`<h1>` 랜드마크, 마운트 중 robots 메타 `noindex`(MSG-478) |
 | (layout) | `MapShell` | 전 네비 섹션 공유 지속 지도 셸 |
 | `/` | `MapHomePage` | 지도 홈 (검색·지역 격자 패널 포함 — MSG-328에서 탐색 흡수) |
-| `/ai-route` | `RequireAuth > AiRoutePage` | AI 경로추천 (MSG-488). 로그인 전용 — 서버가 익명 POST를 401(2403)로 막는다. 카드 클릭만 `moveTo`(줌 불변). **응답 `mentionedArea`가 있으면 확인 없이 자동 이동 + 1km 축척 고정 + 토스트 + 2차 자동 재요청 1회**(MSG-489 — 서버 10초 rate limit이라 1차 요청 시각 +10.5s 대기 후 발사). 현위치가 뷰포트 안이면 `origin` 자동 전송 |
+| `/ai-route` | `RequireAuth > AiRoutePage` | AI 경로추천 (MSG-488). 로그인 전용 — 서버가 익명 POST를 401(2403)로 막는다. 카드 클릭만 `moveTo`(줌 불변). **제출은 항상 1km 축척으로 정규화한 뒤 나간다**(MSG-489 §11 — 현재 줌이 `MAP_SCALE_1KM_ZOOM`이 아니면 줌을 먼저 맞추고 대기, 대기 중에도 로딩 표시). **응답 `mentionedArea`가 있으면 확인 없이 자동 이동 + 1km 축척 고정 + 토스트 + 2차 자동 재요청 1회**(서버 10초 rate limit이라 1차 mutate 시각 +10.5s 대기 + 목표 뷰포트 도달 후 발사). 결과 도착 뒤에는 재정규화·재요청이 없어 자유 확대 가능. 현위치가 뷰포트 안이면 `origin` 자동 전송. **정착 대기가 상한(3s)에 만료됐는데 뷰포트가 서버 상한(한 변 0.5도)을 넘으면 요청을 보내지 않고 에러 안내로 종결한다**(MSG-489 §12 — 숨은 탭에서는 상한 타이머 자체를 걸지 않는다). **이 섹션에서는 다른 섹션의 저줌 집계 클러스터 마커가 보이지 않는다**(MapShell 경로 게이트, MSG-489 §12) |
 | `/upload` | `SectionPanel` 스텁 | 실제 업로드는 모달 |
 | `/dex/:tab?` | `RequireAuth > DexPanel` | 탭이 URL 정본 (`/dex`·`/dex/badges`·`/dex/history` — MSG-414), 비로그인 시 홈+로그인 모달 (MSG-328) |
 | `/profile` | `RequireAuth > ProfilePanel` | 로그아웃 시 홈+로그인 모달 |
@@ -32,12 +32,12 @@
 - **map-home** — `MapHomePage` + ui/: `MapCanvas`(네이버 지도+오버레이), `MapControls`, `RegionPanel`(기본 분기 — 행정동 헤더+격자 카드 리스트+전체 지역 모드. **비로그인도 같은 구성 — 로그인 유도 분기는 MSG-474에서 제거**), `RegionGridCard`, `RegionListView`, `RegionReloadButton`("{행정동} 장소 불러오기" 재검색 pill), `HomeSearchBox`(장소·격자 검색+인기 검색어 드롭다운 — 격자 섹션은 MSG-412, 선택 시 이동+`emphasizeCell` 하이라이트), `RetryNotice`(실패+재시도 행 공용), `CellActionRow`, `HomeCellDetailPanel`, `FeedVideoCard`, `FeedVideoList`(격자 상세·테마 피드 공용), `ThemeChip`/`ThemeChipsBar`/`ThemeFeedPanel`, `naver-sdk-loader.ts`(SDK 격리 경계), `use-escape-close.ts`, `use-home-entry-lifecycle.ts` · MSG-451 신설 뷰-레이어 훅 3종: `use-home-chip-entry.ts`(칩 진입 — 줌+확정 후 최근접 이동), `use-home-panel-state.ts`(패널 분기+불러오기 대상), `use-home-close-handlers.ts`(미니 패널 우선 닫기)
 - **dex** — `DexPanel` + ui/: `DexProfileHeader`, `DexStatCards`, `DexTabs`, `RegionProgress`, `RecentRegionRow`(동 단위 행), `BadgeTabBody`(+대표 뱃지 편집모드 — MSG-413), `BadgeMedal`(메달 아트 + 편집모드 선택 표시), `FeaturedProfilePreview`(대표 뱃지 프로필 미리보기 카드), `GalleryTabBody`(격자 그룹+1열), `GalleryVideoCard`, `RecordTabBody`(기록 탭 본문 — 헤더+"전체 보기 ›"+메타+24주 잔디, MSG-414), `UploadGrassGrid`(잔디 카드 sm/lg 공용 — 월·요일 라벨·범례·sr-only 요약), `UploadHistoryModal`(1년 53주 모달 — DialogShell 960px), `DexTabErrorState`(구 BadgeErrorState — 탭 공용 통합) · 스모크 공용: `dex-fetch-stub.ts`, `dex-test-harness.tsx`
 - **profile** — `ProfilePanel` + ui/: `ProfileHeader`(대표 뱃지 ≥1개면 메타 줄을 pill 행으로 대체 — ADHOC-featured-badge-header), `ActivityCard`, `SettingRow`, `SettingToggleRow`(ui-web Switch 행 — "알림 받기", MSG-408) · `NotificationSettingsPanel`(388px 알림 설정 상세 — 로딩/오류 게이트+그룹 2개 토글 5행+각주, MSG-409) + ui/: `NotificationToggleRow`(label↔Switch 배선·행 단위 busy), `PermissionBanner`(수신 불가 시 안내 — CTA는 408 use-push-toggle ON 재사용, 미지원은 CTA 없음)
-- **ai-route** (MSG-488 신설) — `AiRoutePage`(388px `aside` — `SectionPanel` 미사용, 제목 헤더 강제 회피) + ui/: `RouteInputCard`(textarea 500자 + 제출), `RouteEmptyState`, `RouteSuggestionChips`(서면 기준 예시 2문구 FE 고정), `RouteResultHeader`, `RouteLoadingList`(ui-web `Skeleton` 3장), `RouteResultList`, `RouteStopCard`(순번 뱃지·kind 태그·표시명·reason), `RouteWalkConnector`("도보 약 Nm"), `RoutePartialBanner`(결과 부족 — 문구 FE 고정, 서버 `notice`는 null 여부 신호로만), `RouteErrorNotice`(ui-web `RetryNotice` 래핑 + 14503 분기), `use-route-legs.ts`, `use-ai-route-overlay-publish.ts`(map-overlay-store 게시/해제 — 언마운트 `clear()`). MSG-489 추가: `use-ai-route-auto-move.ts`(제출·0.5도 정규화·현위치 1회 측위·출발지 판정·mentionedArea 자동 이동(`moveTo`+`zoomTo(MAP_SCALE_1KM_ZOOM)`)·2차 재요청 예약을 한 훅이 소유 — `bounds` 참조 변경 AND `requestedAt+10.5s` 경과 시 발사), `RouteToastHost.tsx`(ui-web `Toast` dark + `useAutoDismissToast` 3초 — 스토어 `movedAreaName` 전이로 표시), `RouteInputCard`에 `originActive` prop("현재 위치에서 출발" 행 — 결과 상태에선 숨기고 버튼 문구 "현재 위치에서 다시 짜기"로만 알림)
+- **ai-route** (MSG-488 신설) — `AiRoutePage`(388px `aside` — `SectionPanel` 미사용, 제목 헤더 강제 회피) + ui/: `RouteInputCard`(textarea 500자 + 제출), `RouteEmptyState`, `RouteSuggestionChips`(서면 기준 예시 2문구 FE 고정), `RouteResultHeader`, `RouteLoadingList`(ui-web `Skeleton` 3장), `RouteResultList`, `RouteStopCard`(순번 뱃지·kind 태그·표시명·reason), `RouteWalkConnector`("도보 약 Nm"), `RoutePartialBanner`(결과 부족 — 문구 FE 고정, 서버 `notice`는 null 여부 신호로만), `RouteErrorNotice`(ui-web `RetryNotice` 래핑 + 14503 분기), `use-route-legs.ts`, `use-ai-route-overlay-publish.ts`(map-overlay-store 게시/해제 — 언마운트 `clear()`). MSG-489 추가: `use-ai-route-auto-move.ts`(제출·**항상 1km 정규화**·현위치 1회 측위·출발지 판정·mentionedArea 자동 이동(`moveTo`+`zoomTo(MAP_SCALE_1KM_ZOOM)`)·2차 재요청 예약을 한 훅이 소유 — 정규화는 줌이 목표 단에 도달하면 1차 발사, 2차는 **목표 뷰포트 도달** AND `requestedAt+10.5s` 경과 시 발사, 두 대기 모두 `VIEWPORT_SETTLE_TIMEOUT_MS`=3s 상한으로 반드시 종결(영구 로딩 금지)), `RouteToastHost.tsx`(ui-web `Toast` dark + `useAutoDismissToast` 3초 — 스토어 `movedAreaName` 전이로 표시), `RouteInputCard`에 `originActive` prop("현재 위치에서 출발" 행 — 결과 상태에선 숨기고 버튼 문구 "현재 위치에서 다시 짜기"로만 알림)
 - **oauth-callback** — `KakaoCallbackPage` (ui/ 없음)
 
 ## widgets/ (5)
 
-- **map-shell** — `MapShell`(지도 인스턴스 라우트 전환 유지), `SidebarCollapseHandle`, `use-map-shell.ts`(지도 명령 API, 뷰-레이어 훅), `map-overlay-store.ts`, `sidebar-store.ts`, `grid-click-routing.ts`(순수 함수, RN 재사용 대상). `map-overlay-store`에 `onRouteWaypointClick` 슬롯(MSG-488 — MapShell이 MapCanvas로 중계)
+- **map-shell** — `MapShell`(지도 인스턴스 라우트 전환 유지), `SidebarCollapseHandle`, `use-map-shell.ts`(지도 명령 API, 뷰-레이어 훅), `map-overlay-store.ts`, `sidebar-store.ts`, `grid-click-routing.ts`(순수 함수, RN 재사용 대상), `cluster-route-gate.ts`(`gateRouteClusters` — `/ai-route`에서 저줌 집계 마커 3종을 걷는 경로 게이트, MSG-489 §12). `map-overlay-store`에 `onRouteWaypointClick` 슬롯(MSG-488 — MapShell이 MapCanvas로 중계)
 - **cell-detail** — `CellDetailSheet`, `CellMoreMenu`(Radix DropdownMenu) · model/: `cell-detail`, `cell-detail-store` (MSG-328에서 구 features/explore로부터 이동 — 소비처가 이 위젯과 pages/dex뿐). `ReportDialog`·`ReportReasonSelect`·`model/report`는 MSG-411에서 features/video-actions로 이동. 주의: CellDetailSheet·CellMoreMenu는 현재 어느 라우트에서도 미렌더(MSG-327/328 배선 누락 — 존치 결정, 정리는 후속 판단)
 - **video-mini-panel** — `VideoMiniPanel`(실 재생 + 헤더 더보기(⋯) mine 분기 — 내 영상: 공개·삭제 / 타인: 신고, MSG-411), `VideoOwnerMeta` (MSG-327에서 pages/map-home으로부터 이동 — 홈·도감 공용, pages→pages import 회피)
 - **section-panel** — `SectionPanel`(네비 섹션 공통 388px 패널)
@@ -53,7 +53,7 @@
 - **notifications** (MSG-408 신설) — config: `firebase`(Firebase config·VAPID 공개키 상수 정본 — VITE_ env 예외, 사용자 승인 2026-08-17) · model: `push-support`(지원 판별 순수), `push-sync`(재등록/로테이션 전이 + SW URL 조립 순수), `push-toggle`(토글 표시 파생 순수 — granted && 보관 토큰), `push-token-store`(보관 토큰 반응형, 저장 계층 `shared/storage.fcmTokenStorage`), `push-notice-store`(토글 denied/error 안내 단일 슬롯 — PR #60 리뷰 3) · api: `messaging`(firebase 동적 import 격리 경계 — 테스트 모킹 지점), `use-push-token-sync`(셸 상주 자동 동기화 — 기존 등록자 한정), `use-foreground-messages`(onMessage → 통지) · **MSG-477 ①에서 삭제** — 알림 설정 화면(MSG-409)이 걷히며 `preference-catalog`·`preference-cache`·`permission-banner`·`use-preferences-query`·`use-preference-mutation`·`use-push-toggle`이 소비처 0으로 함께 제거됐다(웹 푸시 **신규 등록 진입점 소멸** — 기존 등록자 동기화·수신 표시는 유지). `model/push-toggle`(표시 파생 순수)은 모바일 parity가 동적 import하므로 존치 · ui: `PushNoticeHost`(AppLayout 셸 분기 상주 — 동기화 배선 + 포그라운드·토글 안내 우하단 단일 스택). SW: `public/firebase-messaging-sw.js`(config는 쿼리스트링 전달, gstatic CDN compat)
 - **profile** — model: `profile-edit`, `profile-format`, `profile-modal-store`(모달 열림 — 사이드레일 초기화가 읽는다), `profile-image`(업로드 순수 로직), `upload-profile-image`(오케스트레이션 포트), `use-profile-image-upload`(웹 포트 훅), `use-profile-query`, `location-consent`(게이트 판정 순수 — RN 재사용 대상)·`use-location-consent-gate`(MSG-407) · api: `use-profile-mutations`(닉네임·위치동의 PUT·이미지 DELETE) · ui: `ProfileEditModal`, `DeleteAccountModal`, `LocationConsentScreen`(전면 동의 화면 — AppLayout 조건 렌더, MSG-407)
 - **video-actions** (MSG-411 신설) — model: `video-menu`(공개 옵션 2종·shouldPatchVisibility 같은 값 미발사·삭제 카드 문구 파생 순수 — RN 재사용 대상), `use-auto-dismiss-toast`(3초 자동 소멸 토스트 공유 훅 — PR #62 리뷰로 3곳 중복 추출, 동일 문구 연속 설정 타이머 재시작 보장), `report`(widgets/cell-detail에서 이동 — REPORT_REASONS·canSubmitReport + `toServerReportReason` FE 3종→서버 enum·`reportFailureNotice` 11409/409 중복 분기) · api: `use-video-mutations`(`useDeleteVideo` 도감·격자 무효화 + upload `invalidateGridQueries` cross-feature 재사용, `useSetVideoVisibility`, `useReportVideo`) · ui: `VideoMoreMenu`(Radix DropdownMenu 복합 소유 — 삭제 확인 모달·신고 모달·실패 토스트 동봉, mine 분기 + "영상 교체" 항목 → upload `openReplaceModal`, MSG-415), `VideoDeleteConfirmDialog`(danger confirm — 대상 카드 실데이터), `ReportDialog`·`ReportReasonSelect`(이동 + 실 POST). 진입점: 도감 `GalleryVideoCard` ⋯ + 미니 패널 헤더 ⋯
-- **ai-route** (MSG-488 신설) — model: `ai-route-store`(요청·결과·선택 상태, 플랫폼 중립 — 지도 SDK 미import), `route-request`(뷰포트 DTO 변환·trim 1~500 제출 판정), `route-point-view`(표시명 `[zoneName+zoneCell] · [regionName]` non-null join · kind 태그 매핑 — 미지 kind는 태그 없음, `EVENT`·`MISSION_FESTIVAL` 둘 다 `theme-festival`), `route-legs`(이웃 좌표 **직선** 구간 거리 — 실보행 경로는 MSG-490), `route-error`(developCode 14400/14401/14429/14502/14503 + 401(2403) → UI 반응 7행), `route-overlay`(points → `RouteOverlay` + `StyledCellOverlay[]` 순수 파생), **MSG-489 추가**: `route-origin`(`resolveRouteOrigin` — 현위치 ∈ bounds면 origin, 밖/미확보/bounds null이면 null), `route-mentioned-area`(`resolveAutoMove` — `mentionedArea` non-null이면 `kind` 무관 이동, `alreadyMoved`면 차단(2차 무시) · `movedToastTitle` 받침 판정 조사), `route-request` 확장(`origin` 병합·`needsSpanNormalize` 0.5도·`submitLabel`·`secondaryDelayMs`/`SECONDARY_MIN_INTERVAL_MS`=10.5s), `ai-route-store` 사이클 플래그 5종(`autoMoved`·`originSent`·`movedAreaName`·`secondaryPending`·`requestedAt`) · api: `use-route-recommend`(`recommendMutation` 래핑 + `unwrapEnvelope`; MSG-489 — `onSuccess`가 1차/2차를 갈라 이동 필요 시 결과 미게시 + 2차 예약, `secondary` 옵션) · ui/ 없음(UI는 pages/ai-route). **MSG-489·490 확장점 주석이 심겨 있다** — 소유권 경계는 `docs/spec/MSG-488.md` §4-2
+- **ai-route** (MSG-488 신설) — model: `ai-route-store`(요청·결과·선택 상태, 플랫폼 중립 — 지도 SDK 미import), `route-request`(뷰포트 DTO 변환·trim 1~500 제출 판정·`needsZoomNormalize`/`reachedTargetViewport`/`exceedsViewportSpan` — 서버 뷰포트 상한 0.5도 최종 가드는 MSG-489 §12에서 부활), `route-point-view`(표시명 `[zoneName+zoneCell] · [regionName]` non-null join · kind 태그 매핑 — 미지 kind는 태그 없음, `EVENT`·`MISSION_FESTIVAL` 둘 다 `theme-festival`), `route-legs`(이웃 좌표 **직선** 구간 거리 — 실보행 경로는 MSG-490), `route-error`(developCode 14400/14401/14429/14502/14503 + 401(2403) → UI 반응 7행), `route-overlay`(points → `RouteOverlay` + `StyledCellOverlay[]` 순수 파생), **MSG-489 추가**: `route-origin`(`resolveRouteOrigin` — 현위치 ∈ bounds면 origin, 밖/미확보/bounds null이면 null), `route-mentioned-area`(`resolveAutoMove` — `mentionedArea` non-null이면 `kind` 무관 이동, `alreadyMoved`면 차단(2차 무시) · `movedToastTitle` 받침 판정 조사), `route-request` 확장(`origin` 병합·`needsZoomNormalize`(항상 1km — 목표 줌 단은 뷰-레이어가 주입, `features/map-home` 미import)·`reachedTargetViewport`(2차 발사 게이트)·`VIEWPORT_SETTLE_TIMEOUT_MS`·`submitLabel`·`secondaryDelayMs`/`SECONDARY_MIN_INTERVAL_MS`=10.5s — **§11에서 0.5도 판정 `needsSpanNormalize`·`MAX_VIEWPORT_SPAN_DEG` 폐기**), `ai-route-store` 사이클 플래그 6종(`autoMoved`·`originSent`·`movedAreaName`·`secondaryPending`·`normalizePending`·`requestedAt`) · api: `use-route-recommend`(`recommendMutation` 래핑 + `unwrapEnvelope`; MSG-489 — `onSuccess`가 1차/2차를 갈라 이동 필요 시 결과 미게시 + 2차 예약, `secondary` 옵션) · ui/ 없음(UI는 pages/ai-route). **MSG-489·490 확장점 주석이 심겨 있다** — 소유권 경계는 `docs/spec/MSG-488.md` §4-2
 - **upload** — model: `upload-wizard`(스텝 전이), `upload-orchestration`(presign→S3 PUT→확정 상태머신), `upload-validation`, `highlight-selection`(+훅), `video-trim`, `ready-poll`(READY 반영 폴링 — 통지 아님), `upload-modal-store`(+`replaceTarget`·`openReplaceModal` — 교체 모드, MSG-415), `use-upload-location`, `presign-purpose`, `wizard-mode`(모드별 문구·격자 라벨 순수, MSG-415) · api: `use-upload-mutations`(`useConfirmUpload` + `useReplaceVideo` — finalize만 `PUT /api/videos/{videoId}`·lat/lng 미전송 미러, MSG-415), `s3-upload`, `ffmpeg-trim`(ffmpeg.wasm), `invalidate-grid-queries`, `invalidate-upload-surfaces`(확정·교체·READY 공용 무효화 집합 — 재생·격자·도감·잔디), `start-ready-refresh`(확정 후 READY 전이에서 같은 집합 재무효화) · ui: `UploadModal`+`use-upload-wizard`, `SelectStep`/`HighlightStep`/`PreviewStep`, `SegmentList`/`SegmentRow`/`SegmentTrimmer`, `UploadDropzone`, `VideoPreview`, `AnalyzingModal`. **블러 경로(폴링·토스트·확인 모달) 전량 삭제 — 서버 블러 중단, MSG-476.** `PreviewStep`에 공개 범위 라디오(전체 공개/나만 보기 — video-actions `VISIBILITY_OPTIONS` 재사용, radix-ui RadioGroup) → 확정 body `visibility` 전송
 
 ## entities/ (5)
@@ -162,4 +162,4 @@
 - MSG-475: [웹] 줌아웃 행정 단위 집계 마커 리디자인 + 핫구역 행정 단위 집계 신설 — ① 원형 3단(size-17/20/23 + `border-3 border-background` 흰 링) 마커를 Figma `15221:20097` **말풍선**으로 교체: 라운드 10·패딩 6/12/7·링 없음·`shadow-raised`·2줄(지역명 `text-fm-label` 백 85% / 개수 `text-fm-heading font-bold` 백), 채움은 Figma 정확 일치 토큰 **`bg-secondary`**(#0071E3 — 종전 `bg-primary` #0066CC에서 이동). `CLUSTER_UNIT_SIZE_CLASS` 삭제로 **단위별 크기 3단이 사라지고** 폭만 지명 길이에 hug된다(브라우저 실측 DONG 63×48·SIGUNGU 66×48 — 높이 동일). ② 축제·팝업 칩 활성 중에는 같은 마크업에 채움만 `bg-theme-festival`/`bg-theme-popup`으로 갈린다(MSG-451 ① 규칙 — 새 색·타이포 토큰 0, `design-tokens` diff 0). ③ **핫구역 칩 저줌 집계 신설** — `use-hotzone-aggregation-query`(`GET /api/hotzones/aggregation`, BE MSG-466)를 미션 집계와 같은 축척 표·같은 상한(동 1°·구 4°·시 10° `clampBoundsToSpan`)·같은 bbox 정본(**뷰포트** — 저줌엔 "장소 불러오기"가 없어 확정 영역으로는 갱신 수단이 없다)으로 배선하고, `toHotZoneClusterMarkers`(접두 `hot-{unit}-{regionCode}`, `theme: "hot"`)로 붉은 말풍선을 띄운다. **인증 게이트 없음**(사용자별 값 없음 — MSG-463 익명 선례). `occupancy-visibility.hotCellsVisible` 신설 + `use-home-overlays` 배선으로 저줌에서 개별 핫 격자를 걷어 마커와 상호 배타를 만든다(종전엔 `gateFillCells`가 색 있는 테마 셀을 저줌에도 남겨 점으로 뭉개졌다). 집계 소스는 **칩 기준 택일**(핫 / 축제·팝업 / 칩 없음+로그인 도감) — 두 종류가 한 지도에 서지 않는다. ④ **`gridIds` 교집합 좁힘은 승인 결정으로 미구현** — 시/구 클릭은 여전히 집계 구간에 내리고 DONG 클릭 후 패널은 이미 확정 행정동으로 걸러지는데 서버가 집계·개별의 판정 집합 동일을 보장해 효과가 null 버킷뿐이다(MSG-451 `missionIds` 후속 미룸과 같은 처리). ⑤ `MARKER_MERGE_PX`(68/80/92)는 **값 불변**(주석만 갱신) — 말풍선(약 61×49, 폭 가변)과 근거가 어긋나지만 모바일 parity 테스트가 리터럴로 고정하고 RN 렌더가 원 지름으로 소비한다. 재보정은 RN 렌더 교체 티켓과 함께. **명세 재생성 안 함** — `getHotZoneAggregates`·`HotZoneRegionAggregateResponseDto`가 MSG-445 스냅샷에 이미 들어와 있었다(티켓 [참고]의 "로컬 스냅샷에 없음"이 스테일). 생성물 4파일 diff 0줄로 병렬 MSG-474와의 충돌 창을 닫았다. **`apps/mobile` diff 0줄** — 웹 `region-cluster-overlay` 변경을 타입 확장·함수 신설의 **추가만**으로 묶어 parity 3종이 모바일 무수정 통과(신규 필드는 `theme`처럼 조건부 스프레드라야 `toEqual`이 안 깨진다). **모바일 화면은 이 티켓 후 두 가지가 벌어진다** — 마커 형태(원형 3단 vs 말풍선)와 핫 칩 저줌 표시(모바일은 격자 낱개 유지, 집계 훅 없음): 별도 [모바일] 티켓 몫. 검증 실측: 브라우저 계산 스타일 전건 일치·칩 5상태 택일·드릴다운 줌 2건·**AC 13 정합(부전2동 마커 1 = 격자 줌 붉은 셀 1)**·콘솔 에러 0, e2e `cluster-zoom-gate` 무수정 2/2, 웹 1289+모바일 982 전건. 확인불가 1건 — 미판정 버킷(`regionCode` null)이 실데이터에 0건(전국 SIDO 프로브 실측)이라 단위 테스트로 대체. nose 신규 9패밀리(신설 훅·테스트 ↔ 도감·미션 형제) baseline 등재 — 3형제 훅은 게이트 조건·envelope·placeholder 정책이 9개 지점에서 갈려 공통 추출이 부적합(nose 자신의 9파라미터 판정, MSG-476 선례). **등재 시 무관 흡수 1건(`profile-edit-modal.smoke` ↔ `envelope-response` — develop에도 있던 hidden 패밀리)을 되돌렸다**(MSG-476 교훈). 참고: 흰 글자 대비가 hot 3.6:1·popup 2.2:1로 WCAG 미달이나 MSG-451부터 승계된 테마 토큰 규칙이자 Figma 정본 값 — 디자인 차원 후속 거리.
 - MSG-474: 비로그인 지도 홈 개방 — QA 3건(최초 진입 로그인 안내만 뜸 / "장소 불러오기" 미작동 / 칩 최근접 이동 안 됨)의 뿌리는 하나였다: 역지오코딩이 비로그인에서 게이트돼 **확정(commit)이 영영 생기지 않음** → `committedBounds`가 부트스트랩 초기 뷰포트에 고정 → 칩 bbox가 좁고 `currentRegion` null이라 불러오기 버튼 미생성. 티켓이 지목한 `use-nearest-entry`는 무관했다(그 훅의 center는 `viewportCenter`라 비로그인에도 null 아님). **게이트 해제 3곳**(`MapHomePage`·`RegionPanel`·`use-committed-region` — 마지막은 티켓 미기재였으나 최초 확정의 실제 소스)으로 3건이 함께 풀렸고 `use-chip-entry`·`use-nearest-entry`·`region-reload`는 **무수정** 회귀 통과. ① `RegionPanel` 로그인 유도 분기 통삭제 → 헤더·격자 카드·"전체 보기"·전체 지역 무한 스크롤이 비로그인에도 열린다(**MSG-463 확정 1을 뒤집음** — 당시 근거 "데이터원이 로그인 전용"이 explore 익명 200으로 소멸, 사용자 승인). ② 비로그인 격자 상세는 `grids/{gridId}`(응답이 occupied·내 영상 수 = 사용자별이라 익명 401이 **설계상 정상**)를 부르지 않고 **진입점 응답의 이름 재료로 조립** — `deriveHomeCellDetail`을 `viewerAuthenticated` 판별식 유니언(로그인=cell 필수 / 비로그인=entryNaming 필수)으로 확장, 비로그인은 subtitle null·"내 점령" 배지 없음. ③ 인증 **true→false 전이**에서 `QueryProvider` 한 곳이 `queryClient.clear()` — 티켓의 "쿼리 키에 인증 반영"은 생성 키에 인증 축이 없고 로그인은 이미 clear 중(로그아웃만 누락)이라 키 확장 10곳+ 대신 전이 구독 1곳을 택했다. ④ **스펙 인벤토리 밖 401 경로 2건을 구현 중 발견·차단**: `use-grid-names-query`(코스 스팟 이름 = `grids/{id}` N회)·dex `use-region-videos-query`(`collections/videos` — 비로그인 확정 지역이 생기며 처음 활성화). **실측이 범위를 두 번 바꿨다**: 티켓의 "BE 선행 전부 배포 확인"과 달리 1차 익명 curl에서 `regions/{code}/grids`·`videos/{id}`·`explore`가 401(요구 2·5·재생 블로커) → 사용자가 권한 재배포 → 2차 실측 200으로 요구 5건 전부 성립. **`api:generate` 미실행** — 라이브 `/v3/api-docs`와 레포 스냅샷이 **바이트 동일**(권한만 열리고 계약 무변경)이라 생성물 4파일 diff 0, MSG-475와의 충돌 우려도 소멸(구현 중 발견된 생성물 재생성분은 `FriendPreviewResponseDto.relation`=MSG-391 친구 기능으로 무관 → HEAD 복원). **AC 14(최종 방어선) 통과**: 비로그인 전 과정(진입→전체 보기→이동→불러오기→칩 3종→격자 상세→코스 상세→재생) `/api/` 실호출 전건 200·**401 0건·reissue 0건**·금지 7종 0건. **재작업 1회차**: ① 모바일 `home-cell-detail.parity.test.ts`가 웹 파생 함수를 구 시그니처로 동적 import해 깨짐 — 빌더가 `--filter web`만 돌려 놓쳤고 루트 게이트가 잡았다(**MSG-476과 동일 재발** — 웹 파생 함수를 바꾸는 티켓은 모바일 패리티 앵커를 먼저 조회할 것), 타입까지 새 계약에 묶어 다음 드리프트를 typecheck가 잡게 함 ② e2e `consent-gate-popstate`가 익명 렌더 증거로 삭제 대상인 "로그인" 버튼을 단정 → 확정 행정동 heading으로 교체(게이트 본래 단정 무변경) ③ nose 신규 6패밀리 개별 검토 후 추출 대상 0건 판정·베이스라인 재등재. **BE 환류 2건**: 코스 스팟(`CourseSpotDto`)이 좌표만 줘 비로그인 코스 스팟 상세에 행정동 줄 없음(AC 11 부분, FE로 메울 수 없음) · dev 재생 미디어가 S3 키를 `https%3A//dev.local/seed/….m3u8`로 저장해 403(AC 12 프레임 미표시 — FE 계약은 성립, 시드 데이터 결함). 확인불가 2건은 로그인 상태 브라우저 회귀(카카오 세션 부재, MSG-463 선례)
 - MSG-488: [웹] AI 경로추천 페이지 신설 (`/ai-route`) — 자연어 문장 → `POST /api/routes/recommend` → 좌측 388px 패널 카드 리스트 + 지도 오버레이(번호 마커·격자 초록 틴트·이웃 직선). **라우트명은 티켓 가칭 `/route`에서 `/ai-route`로 변경**(사용자 승인) — 코드베이스에 `route`가 이미 3중 의미(`ROUTES` react-router 상수 · `ThemeId "route"` = 기존 코스 칩 "경로추천"으로 같은 초록 `theme-route`까지 공유 · `map-overlay-store.routes`)라 동음이의를 피했다. **로그인 전용** — 2026-08-28 익명 POST 실측이 `401 {developCode:2403}`이라 `RequireAuth` + 레일 항목 비로그인 클릭 시 `login-modal-store` 게이트. **결과 도착 시 지도를 이동·확대하지 않는다**(카드 클릭만 `moveTo`, 줌 불변) — 사용자가 보던 범위를 뺏지 않는 것이 이 티켓의 계약이고, 자동 이동은 MSG-489 몫. **재사용 성과: 신규 렌더 코드가 거의 없다** — `map-overlay-store`에 이미 `routes`(폴리라인 + 번호 경유지)·`cells`(색·빗금) 슬롯이 있어 MapShell→MapCanvas 렌더 경로를 통째로 썼고, MapCanvas 추가분은 경유지 `onClick` 슬롯 + `active` 강조뿐(`onRouteWaypointClick` 미제공이면 기존 코스 마커는 비클릭 그대로). 오버레이 파생은 순수 함수 `route-overlay.ts`에 두어 RN 경계 유지(`features/`·`model/`에 `naver` import 0건). 승격 2건: ui-web **`Skeleton`** 신설(레포 첫 스켈레톤 — 착수 전제였던 "GalleryTabBody가 첫 사용처"는 실측 오류였다. `GallerySkeleton`은 `DotsLoader` 래퍼이고 MSG-403이 의도적으로 도트로 통일한 자리라 미접촉), **`RetryNotice`**를 `pages/map-home/ui/` → ui-web 이동(재사용 시 pages→pages import가 되므로 — 소비 8파일은 import 한 줄씩만 변경). 마커 스타일은 Figma 정본(28px `size-7` + `border-2 border-background` + `shadow-raised`)으로 갱신했고 `routeMarkerContent` 공유상 **기존 코스 칩 경유지 마커도 함께 바뀌는 것을 사용자가 승인**(두 마커가 같은 초록이라 통일이 낫다는 판단 — `markerStyle` 분기 미생성). 결과 부족 배너는 **FE 고정 문구**이고 서버 `notice`는 null 여부 신호로만 쓴다(문자열 미노출을 `not.toContain`으로 고정), 0곳이면 카드·오버레이 없이 배너만. **웨이브 2 병렬 머지를 위해 파일 소유권을 설계 산출물로 명시**(정본 `docs/spec/MSG-488.md` §4-2): 489(상태·요청·입력카드 계열)와 490(구간거리·오버레이 기하·walk-paths 계열)의 **교차 파일 0건**, 공유 파일 `AiRoutePage.tsx`도 489만 2줄·490은 0줄, 셸·렌더·라우트·레일·ui-web은 488이 완결(둘 다 0줄). 확장점 주석 3종을 지정 위치에 심었고 489·490 신규 예정 파일은 하나도 만들지 않았다. **검증 실측**: 남아 있던 리프레시 쿠키로 실계정 자동 재발급이 돼 **실 API 8곳 응답**으로 브라우저 검증 — 지도 미이동(축척바 100m 불변) · 8→3→2→0곳 4회 연속 갱신 잔상 0 · 도감 왕복 후 복원 + **재요청 0회** · 실패 7경로 전건 · Figma 4프레임 오탐 목록 밖 편차 0 · 콘솔 에러 0. 확인불가 1건 — 빗금(점령 격자 교집합)이 실데이터에 발생하지 않아 육안 불가, 단위 테스트로 대체. a11y 지적 1건 즉시 반영: `RouteResultHeader`(`role="status"`)가 자체 `role="status"`를 가진 `DotsLoader`를 감싸 낭독이 실제로 중복돼(`"동선 찾는 중 동선 찾는 중"`) 도트를 `aria-hidden`으로 감쌌다(ui-web 무수정). **nose 중복 게이트는 착수 전부터 red**였고 근원이 이 티켓 자신의 웨이브 0 openapi 커밋(`107aa59`)이라 재등재했다 — 검증자가 `git archive HEAD`로 워크트리 밖에 풀어 재현해 HEAD 시점 3패밀리가 빌더 지목 id와 일치함을 독립 확인(숨어든 진짜 중복 0). **알려진 한계**: `gateFillCells`가 `zoom < 16`에서 채움 셀을 버려 넓게 본 상태에서 요청하면 격자 초록 틴트가 안 보인다(마커·선은 남음) — MSG-489의 1km 축척 고정이 해소한다. **489 선행 경고**: "지도 위 현재 위치 점"을 그릴 슬롯이 `MapCanvasProps`에 없어(`MapLabelOverlay`는 텍스트 pill, `waypoints`는 번호 뱃지) 489가 "488 완결·489 0줄"로 선언된 `MapCanvas.tsx`를 다시 열 공산이 크다 — 489∥490 병렬성 자체는 안 깨진다. **스펙 각주 누락 1건**: Figma 결과·결과 부족 프레임 양쪽에 "축제, 팝업, 코스, 행사 정보와…" 각주가 있는데 스펙은 로딩 화면에만 기재 — 디자인 정본을 따라 양쪽에 렌더.
-- MSG-489: [웹] AI 경로추천 — `mentionedArea` 자동 이동·1km 축척 고정·2차 자동 재요청·출발지(origin) 자동 판정. **웨이브 2 = 490(walk-paths)과 동시 진행** — `docs/spec/MSG-488.md` §4-2 소유권 표의 489열만 접촉, 접촉 금지 15경로 diff 0줄(검증자 감사), `MapCanvas.tsx` 0줄(현재 위치 점은 **Figma 12402·13139에 노드가 없어 제외** — 488의 "489가 MapCanvas를 다시 열 공산" 경고는 디자인 근거가 없었다). **착수 전 실측 2건이 설계를 결정했다**: ① 2차 자동 재요청은 서버 10초 rate limit **예외가 아니다**(로그인 세션 연속 호출 → 두 번째 `429/14429`, 1차 요청 시작 +11s는 200, `Retry-After` 없음) → 1차 `requestedAt` 기준 `10.5s` 잔여 대기 후 발사, 대기·2차 중 패널은 로딩·1차 결과 미게시, 2차 mentionedArea 무시(1회 한정), 2차 14429면 기존 에러 매핑. 브라우저 실측 간격 11,174ms·recommend 정확히 2회. ② `shared/geolocation.getCurrentPosition()`이 **권한 거부를 삼키고 서면 좌표를 돌려줘** 거부 사용자에게도 origin이 전송되는 오판정 → 가산 export `getCurrentPositionOrNull`(사용자 승인, 기존 소비 3곳 무수정). **488 "알려진 한계" 정정**: `gateFillCells`는 `zoom<16`에서 *색 있는 셀을 남기는* 필터이고 AI 경로 셀은 전부 `theme-route` 색이라 게이트를 **통과한다**(zoom 13에서 폴리곤 8개 DOM 실측, `fill=#34C759`) — 다만 1km 축척에선 셀이 6~7px이라 28px 마커에 가려 육안으로는 안 보인다. "1km 고정이 해소한다"는 서술은 성립하지 않으며 이는 홈과 동일한 저줌 공통 동작으로 수용(`MAP_SCALE_1KM_ZOOM`=13 < `GRID_MIN_ZOOM`=16). **설계 결정**: 제출·정규화·측위·이동·2차 예약을 훅 하나(`use-ai-route-auto-move`)가 소유해 `AiRoutePage.tsx`가 스펙 "2줄" 상한을 -w 기준 +14/−12로 넘겼다(제출 로직 7줄이 페이지에서 빠짐 — 490은 이 파일 0줄이라 병렬성 불변); 2차 발사는 `bounds` **참조 변경** AND 시간 경과 두 조건(이동 직후 즉시 쏘면 옛 bounds, `ZOOM_OUT`은 중심이 옛 뷰포트 안이라 중심 판정만으론 못 막음); 예약 플래그를 스토어에 둬 대기 중 섹션 이탈·StrictMode 2회 실행에서도 영구 로딩·중복 발사 없음; 토스트 조사는 받침 판정 순수 함수("서면으로", ㄹ 받침 예외 포함). 0.5도 예방(뷰포트 한 변 >0.5°면 중심 기준 1km로 먼저 맞추고 요청, 토스트 없음) 실측: span 0.7° 제출 → 요청 1회·14401 없음. ui-web `Toast` dark가 Figma 15675:3267과 1:1이라 승격 0건, Figma 편차 0(computed style 실측). **검증 실측**: 수용 기준 28개(L19+S9) 전건 통과·확인불가 0, Chrome 위치 권한 granted + 실좌표가 서면 안이라 S1 "안 → 표시"를 브라우저에서 직접 판정, 토스트 3초 소멸, 2차 로딩 전 구간 1차 잔상 0, 콘솔 0. 중복 게이트 재등재 +11/−6 전부 489 변경 파일 포함(무관 흡수 0), `setGeolocation` 3복제는 `src/test/geolocation.ts`로 추출. **후속 후보**: 0.5도 정규화 대기 중(네이버 다단 줌 애니메이션이 `idle`을 늦게 내 실측 14.2초) 로딩 피드백 없음 — 정규화 대기에도 로딩 상태를 켜면 해소; 2차 인스턴스에 `onLoginRequired` 미부착(1차 성공 직후 세션 만료 경로는 수용 기준 밖).
+- MSG-489: [웹] AI 경로추천 — `mentionedArea` 자동 이동·1km 축척 고정·2차 자동 재요청·출발지(origin) 자동 판정. **웨이브 2 = 490(walk-paths)과 동시 진행** — `docs/spec/MSG-488.md` §4-2 소유권 표의 489열만 접촉, 접촉 금지 15경로 diff 0줄(검증자 감사), `MapCanvas.tsx` 0줄(현재 위치 점은 **Figma 12402·13139에 노드가 없어 제외** — 488의 "489가 MapCanvas를 다시 열 공산" 경고는 디자인 근거가 없었다). **착수 전 실측 2건이 설계를 결정했다**: ① 2차 자동 재요청은 서버 10초 rate limit **예외가 아니다**(로그인 세션 연속 호출 → 두 번째 `429/14429`, 1차 요청 시작 +11s는 200, `Retry-After` 없음) → 1차 `requestedAt` 기준 `10.5s` 잔여 대기 후 발사, 대기·2차 중 패널은 로딩·1차 결과 미게시, 2차 mentionedArea 무시(1회 한정), 2차 14429면 기존 에러 매핑. 브라우저 실측 간격 11,174ms·recommend 정확히 2회. ② `shared/geolocation.getCurrentPosition()`이 **권한 거부를 삼키고 서면 좌표를 돌려줘** 거부 사용자에게도 origin이 전송되는 오판정 → 가산 export `getCurrentPositionOrNull`(사용자 승인, 기존 소비 3곳 무수정). **488 "알려진 한계" 정정**: `gateFillCells`는 `zoom<16`에서 *색 있는 셀을 남기는* 필터이고 AI 경로 셀은 전부 `theme-route` 색이라 게이트를 **통과한다**(zoom 13에서 폴리곤 8개 DOM 실측, `fill=#34C759`) — 다만 1km 축척에선 셀이 6~7px이라 28px 마커에 가려 육안으로는 안 보인다. "1km 고정이 해소한다"는 서술은 성립하지 않으며 이는 홈과 동일한 저줌 공통 동작으로 수용(`MAP_SCALE_1KM_ZOOM`=13 < `GRID_MIN_ZOOM`=16). **설계 결정**: 제출·정규화·측위·이동·2차 예약을 훅 하나(`use-ai-route-auto-move`)가 소유해 `AiRoutePage.tsx`가 스펙 "2줄" 상한을 -w 기준 +14/−12로 넘겼다(제출 로직 7줄이 페이지에서 빠짐 — 490은 이 파일 0줄이라 병렬성 불변); 2차 발사는 `bounds` **참조 변경** AND 시간 경과 두 조건(이동 직후 즉시 쏘면 옛 bounds, `ZOOM_OUT`은 중심이 옛 뷰포트 안이라 중심 판정만으론 못 막음); 예약 플래그를 스토어에 둬 대기 중 섹션 이탈·StrictMode 2회 실행에서도 영구 로딩·중복 발사 없음; 토스트 조사는 받침 판정 순수 함수("서면으로", ㄹ 받침 예외 포함). 0.5도 예방(뷰포트 한 변 >0.5°면 중심 기준 1km로 먼저 맞추고 요청, 토스트 없음) 실측: span 0.7° 제출 → 요청 1회·14401 없음 — **이 규칙은 아래 §11 후속 변경에서 폐기됐다(현재는 항상 1km 정규화)**. ui-web `Toast` dark가 Figma 15675:3267과 1:1이라 승격 0건, Figma 편차 0(computed style 실측). **검증 실측**: 수용 기준 28개(L19+S9) 전건 통과·확인불가 0, Chrome 위치 권한 granted + 실좌표가 서면 안이라 S1 "안 → 표시"를 브라우저에서 직접 판정, 토스트 3초 소멸, 2차 로딩 전 구간 1차 잔상 0, 콘솔 0. 중복 게이트 재등재 +11/−6 전부 489 변경 파일 포함(무관 흡수 0), `setGeolocation` 3복제는 `src/test/geolocation.ts`로 추출. **후속 변경(2026-08-29, 승인 — 스펙 §11)**: 사용자 지시로 **제출 시 항상 1km 정규화**로 바꾸고 0.5도 규칙(A2·`needsSpanNormalize`·`MAX_VIEWPORT_SPAN_DEG`·L12)을 **폐기**했다 — 항상 1km면 서버 상한 14401이 구조적으로 불가능해 0.5도 판정이 죽은 조건이 된다. 이미 1km면 줌 명령을 내지 않는다(같은 값으로 `zoomTo`하면 `idle`이 안 와 요청이 영영 안 나간다). 정규화 대기에도 로딩을 켜되(`startNormalize`) `requestedAt`은 **mutate 시점**에만 찍는다(대기가 10초 창을 먹으면 2차가 조기 발사돼 14429). 2차 발사 조건은 `bounds` 참조 변경 → **목표 뷰포트 도달**(`reachedTargetViewport` — 참조 변경 AND 줌이 목표 단)로 좁혀 진행 중 지도 조작이 2차를 오염시키지 않게 했고, **지도 잠금은 하지 않는다**(사용자 결정 — ui-web·MapShell·MapCanvas 계속 0줄). 좁힌 대가인 "목표를 영영 벗어나는" 경로는 두 대기 모두 `VIEWPORT_SETTLE_TIMEOUT_MS`=3s 상한으로 종결시켜 **영구 로딩을 테스트로 금지**(L22·L24). 결과 상태에서는 뷰포트가 바뀌어도 recommend가 안 나가 자유 확대 가능(L25 회귀 고정 — 1km에서 셀 6~7px이라 육안 미식별이던 지점이 여기서 해소). 접촉 파일 7개(+`nose.baseline.json`), `AiRoutePage.tsx` 0줄, 490 소유 파일 0줄. **재작업 1회차(2026-08-29 §12)**: 검증이 백그라운드 탭 경로에서 **14401 재현**을 잡았다 — 숨은 탭은 rAF가 멈춰 `idle`이 안 오는데 3s 상한이 옛 뷰포트(1.94°×4.75°)로 발사했다. §11이 지웠던 서버 상한 판정을 **발사 직전 최종 가드**(`exceedsViewportSpan`)로 되살려 `send()` 한 곳에서 막고, 못 보내면 `abortPending`으로 **에러 안내 종결**(영구 로딩·확정 400 둘 다 금지), 숨은 탭에서는 상한 타이머를 걸지 않는다. §11 D10의 "항상 1km면 14401 구조적 불가능" 서술은 정정됐다(정상 경로 한정). 상한 3s는 실측(줌 전이 269~729ms) 근거로 유지. **같은 회차에 사용자 지시로 `/ai-route`에서 다른 섹션 집계 클러스터 마커를 숨겼다** — `MapShell.tsx`는 MSG-488이 완결 선언한 파일이나 사용자 명시 지시이고 490도 0줄이라 병렬 충돌 없음(예외 기록). **잔여 후속 후보**: 2차 인스턴스에 `onLoginRequired` 미부착(1차 성공 직후 세션 만료 경로는 수용 기준 밖).
diff --git a/docs/decisions/DECISIONS.md b/docs/decisions/DECISIONS.md
index 23fda76e..3f38e2a1 100644
--- a/docs/decisions/DECISIONS.md
+++ b/docs/decisions/DECISIONS.md
@@ -424,3 +424,14 @@
 | 2026-08-28 | MSG-489 | 결정: 2차 재요청 발사 조건을 "`viewport-store.bounds` **참조 변경** + `requestedAt + 10.5s` 경과" 두 조건 AND로 두고, 예약 상태(`secondaryPending`)를 스토어에 둔다 | 대안 ①이동 명령 직후 즉시 mutate: 옛 bounds로 쏜다(스펙 R3) ②목표 중심이 bounds 안인지로만 판정: `kind=ZOOM_OUT`은 중심이 이미 옛 뷰포트 안이라 즉시 통과해 R3를 못 막는다 ③예약을 훅 로컬 ref로: 대기 중 섹션 이탈 시 예약이 소실돼 패널이 영구 로딩으로 남는다. 스토어에 두면 재진입이 예약을 이어받고, `onMutate`가 끄므로 중복 발사도 같은 플래그로 막힌다 |
 | 2026-08-28 | MSG-489 | 결정: 토스트 제목의 조사를 리터럴 "(으)로"가 아니라 **받침 판정 순수 함수**로 확정한다("부산 서면으로 이동했어요"). 스펙 L10이 인용한 문자열은 기획 표기 관례로 판단 | 대안 ①L10 문자열 그대로 렌더: 사용자에게 "(으)로"가 그대로 보인다 ②서버가 조사를 실어 주기: 계약 변경이 필요하고 이 티켓은 "서버 API는 그대로"가 전제. ㄹ 받침이 "로"를 쓰는 예외까지 3케이스로 고정했다(오케스트레이터 지시) |
 | 2026-08-28 | MSG-489 | 결정: 결과 상태(`status === "result"`)에서는 "현재 위치에서 출발" 표시 행을 숨기고 버튼 문구로만 출발지를 알린다 | Figma 15666:13139(origin 결과)에 그 행이 없고 스펙 §8 오탐 방지 5가 "의도된 동작"으로 못박았다. 라이브 판정(`현위치 ∈ 현재 bounds`)만 쓰면 결과 화면에서도 계속 떠 Figma와 어긋난다 |
+| 2026-08-29 | MSG-489 | 결정(§11 후속): 제출 시 **항상 1km 축척으로 정규화**하고(현재 줌이 `MAP_SCALE_1KM_ZOOM`이 아니면 줌만 먼저 내고 대기), 0.5도 상한 판정(`MAX_VIEWPORT_SPAN_DEG`·`needsSpanNormalize`)과 그 테스트(L12)를 **폐기**한다 | 사용자 지시("추천할려면 1km로 이동해주고 해당 위치에서만 추천"). 항상 1km면 서버 뷰포트 상한(14401)이 구조적으로 불가능해 0.5도 판정은 죽은 조건이 된다 — 두 규칙을 병존시키면 "언제 정규화되는가"가 두 갈래로 갈려 재현·설명이 어렵다. 이미 1km면 줌 명령을 **내지 않는다**: 목표와 같은 값으로 `zoomTo`하면 지도가 `idle`을 내지 않아 요청이 영영 안 나간다(L21) |
+| 2026-08-29 | MSG-489 | 결정(§11 후속): 정규화 대기 중에도 로딩 상태를 켜되(`startNormalize`), rate-limit 기준 시각 `requestedAt`은 **실제 mutate 시점**에만 기록한다 | 대안 ①`startRequest`를 제출 클릭 시점에 호출: 로딩은 켜지지만 정규화 대기(실측 최대 수 초)가 서버 10초 창을 잡아먹어 2차가 조기 발사되고 14429가 난다 ②대기 중 로딩을 켜지 않기: MSG-489 검증이 실측한 14.2초 무피드백이 그대로 남는다. 스토어 액션을 둘로 나눠 "로딩 시작"과 "요청 시각 기록"을 분리했다 |
+| 2026-08-29 | MSG-489 | 결정(§11 후속): 2차 발사 조건을 "bounds 참조 변경"에서 "**목표 뷰포트 도달**"(`reachedTargetViewport` — 참조 변경 AND 줌이 목표 단)로 좁히고, 지도는 잠그지 않는다 | 진행 중 사용자가 지도를 만지면 옛 조건은 그 조작 뷰포트로 2차를 쏜다. 대안 ①진행 중 지도 잠금(ZoomControl·MapShell 비활성): 사용자가 명시적으로 기각했고 489 소유권 표의 접촉 금지 파일을 열어야 해 MSG-490 병렬성도 깨진다 |
+| 2026-08-29 | MSG-489 | 결정(§11 후속): 두 대기(정규화·2차) 모두 `VIEWPORT_SETTLE_TIMEOUT_MS`(3s) 상한을 두고 목표 도달 실패 경로에서도 현재 뷰포트로 1회 발사한다 — 영구 로딩 금지를 테스트로 고정(L22·L24) | 도달 판정을 좁힌 대가로 "사용자가 대기 중 줌을 되돌려 목표를 영영 벗어나는" 경로가 생겼고, 그 경로에서 패널이 로딩에 갇힌다. 지도를 잠그지 않기로 한 이상 조작은 항상 가능하므로 출구는 시간 상한뿐이다. 대안 ①도달할 때까지 무한 대기: 영구 로딩 ②줌이 벗어나면 즉시 실패 처리: 사용자가 방금 본 화면으로 추천을 받는 편이 낫고, 실패 화면은 서버 오류와 구분이 안 된다 |
+| 2026-08-29 | MSG-489 | 발견(§12 재작업): §11의 "항상 1km면 14401은 **구조적으로 불가능**" 전제가 검증 실측으로 반증됐다 — 숨은 탭에서는 rAF가 멈춰 `idle`이 오지 않아 뷰포트가 옛 값에 머무는데, D13이 신설한 3s 상한 출구가 그 값(1.9379° × 4.7461°)으로 그대로 발사해 400 `14401`을 맞았다. D10이 지운 상한 가드가 바로 그 출구의 유일한 방어선이었다 | 같은 §11 안에서 D10(정규화 트리거 일원화)과 D13(종결 보장 출구 신설)이 서로를 무효화했다. 교훈: **정규화로 값을 보장한다**는 논증은 그 정규화를 건너뛰는 탈출 경로가 생기는 순간 깨진다 — 값 보장은 정규화가 아니라 **발사 직전 최종 가드**에 둬야 한다 |
+| 2026-08-29 | MSG-489 | 결정(§12): 서버 뷰포트 상한 판정을 `exceedsViewportSpan({ viewport, maxSpanDeg })`으로 되살리되 **정규화 트리거가 아니라 `send()` 한 곳의 최종 가드**로 두고, 걸리면 보내지 않고 `abortPending`으로 에러 안내 종결한다(영구 로딩·확정 400 동시 금지) | `send()`가 이 훅의 유일한 발사 지점이라 네 경로(즉시·정규화 대기·상한 만료·2차)가 전부 통과한다. 대안 ①목표 줌 기준으로 중심에서 span 파생(검증 1안): span이 컨테이너 픽셀·위도에 의존해 지도 밖에서 재현 불가하고 지도가 실제로 그 범위에 있지도 않다 ②bounds를 0.5도로 잘라 발송: 요청은 통과하나 D10("항상 1km")을 깨고 사용자가 보지 않은 55km 범위를 추천한다 ③두 `fire()`에 각각 검사: 경로가 늘 때마다 빠뜨릴 수 있어 이번 결함 구조가 그대로 재발한다 |
+| 2026-08-29 | MSG-489 | 결정(§12): 숨은 탭(`document.visibilityState !== "visible"`)에서는 정착 대기 상한 타이머를 **걸지 않고** 복귀 시 다시 3초를 잰다. 가시성 구독은 뷰-레이어 훅 지역 `useDocumentVisible`에만 두고 순수 모델은 모른다 | 숨은 탭은 rAF가 멈춰 지도가 정착할 수 없으므로 대기 자체가 무의미하고, 상한만 소모돼 옛 뷰포트 발사를 유발한다. 이미 목표에 도달한 뒤의 2차 대기(서버 10초 창)는 지도와 무관하므로 숨은 채로도 계속 잰다. 대안 ①`shared/` 가시성 어댑터 신설: 사용처 1곳뿐이라 성급한 공통화(두 번째 사용처에서 승격) ②순수 모델에서 `document` 참조: RN 경계·oxlint 위반 |
+| 2026-08-29 | MSG-489 | 결정(§12): `VIEWPORT_SETTLE_TIMEOUT_MS`를 3,000ms로 **유지**한다 — 검증 실측 줌 애니메이션은 16→13 269ms · 10→13 296ms · 10→16 729ms이고, §11이 근거로 삼았던 "정규화 대기 14.2초"는 백그라운드 탭 rAF 정지 아티팩트였다(같은 전이가 숨은 탭 11,162ms / 전면 탭 316ms) | 낮추면(예 1,200ms) 정착 실패 경로가 넓어져 결함 창이 커지고, 높이면 정착 실패 시 사용자 대기가 길어진다. 부수 교훈: **비활성 탭에서 잰 지도 타이밍은 전부 무효** — 계측 전 `visibilityState`와 rAF fps를 먼저 확인한다 |
+| 2026-08-29 | MSG-489 | 결정(§12, 사용자 지시): `/ai-route`에서 다른 섹션의 저줌 집계 클러스터 마커 3종을 숨긴다 — `MapShell`이 파생한 `clusters`에 `gateRouteClusters(clusters, pathname)`를 적용(파생 훅은 무수정). MSG-488이 완결 선언한 `MapShell.tsx`를 여는 **소유권 예외**를 이 한 게이트에 한정해 기록한다 | 집계 마커는 줌 16(100m) 미만에서만 존재하는 층이라 경로 게이트 하나로 사용자 지시("100m보다 커지면 안 보이게")가 전부 충족된다 — 줌 분기 추가는 불필요. 대안 ①집계 훅 3종에 라우트 조건 추가: `features/map-home`이 라우트를 알게 되고 다른 섹션 회귀 위험 ②`MapCanvas`에서 숨김: 접촉 금지 파일이고 지도 경계에 라우트 지식이 들어간다. MSG-490도 이 파일 0줄이라 병렬 머지 충돌 없음 |
+| 2026-08-29 | MSG-489 | 결정: 14429(요청 과다) 안내를 서버와 같은 문장 `"요청이 너무 잦습니다. 잠시 후 다시 시도해주세요"`로 교체한다(FE 고정 문구 상수 — 서버 응답 문자열을 렌더하는 것이 아니다) | 종전 `"잠시 후 다시 시도해 주세요"`는 사유를 알려주지 않아, 재시도를 연속으로 누른 사용자가 같은 안내만 반복해 본다(사용자 실사용 보고). 대안 ①서버 `message` 패스스루: MSG-488 §1-5의 FE 고정 문구 정책이 깨지고 임의 서버 문자열이 화면에 그대로 나간다 ②클라이언트 쿨다운 타이머로 버튼을 잠금: MSG-488 Q7에서 이미 기각한 범위 |
+
diff --git a/docs/spec/MSG-489.md b/docs/spec/MSG-489.md
index 792fc27e..9b953052 100644
--- a/docs/spec/MSG-489.md
+++ b/docs/spec/MSG-489.md
@@ -268,3 +268,114 @@ Figma 정본: 섹션 15666:12401 — `15666:12402`(대기 + 출발 표시) · `1
 - 2차 인스턴스에 `onLoginRequired` 미부착 — 1차 성공 직후 세션 만료 시 로그인 모달 없이 입력 대기로 복귀.
 - `features/dex/use-region-stat-query.ts`의 private `useCurrentCoords`와 이 티켓 동명 훅이 구조상 3복제(baseline 등재) — 공통화하려면 dex의 "조회 전 null 대기" 계약을 tri-state로 변경 필요.
 - 자동 이동 순간 축척 바(`role="status"`)가 "1km"를 토스트와 함께 낭독(내용 일치, 중복 낭독은 아님).
+
+---
+
+## 11. 후속 변경 (2026-08-29, 사용자 지시 — 승인 완료)
+
+> 지시 원문: "추천할려면 1km로 이동해주고 해당 위치에서만 추천가능하게 해준다음에 결과가 나오면 확대할 수 있게 해줘"
+> 승인 델타 정본: `_workspace/MSG-489/01_spec.md` §11 (D10~D14 · L20~L25 · S10~S12) · 빌드 리포트: `_workspace/MSG-489/02b_build_report.md`
+> §1~§10은 그대로 두되, **아래와 충돌하는 항목(A2·L12·0.5도)은 폐기됐다**.
+
+### 확정 (D10~D14)
+
+| # | 결정 |
+|---|---|
+| D10 | **제출 시 항상 1km 정규화** — 현재 줌이 `MAP_SCALE_1KM_ZOOM`이 아니면 줌을 먼저 맞추고 새 뷰포트가 반영된 뒤 요청한다. "다시 짜기"도 같은 경로. 기존 A2(0.5도 초과 시에만)는 흡수·폐기 |
+| D11 | **정규화 대기 중 로딩 표시** — 클릭 즉시 로딩. 단 `requestedAt`은 **실제 mutate 시점**에만 기록(대기가 10초 창을 먹으면 2차 조기 발사 → 14429) |
+| D12 | **진행 중 지도 잠금 없음** — ui-web·`MapShell`·`MapCanvas` 0줄 유지. 대신 2차 발사 조건을 "목표 뷰포트 도달"로 좁혀 방어 |
+| D13 | **2차는 반드시 종결** — 목표 도달 판정이 실패하는 경로에서도 대기 창 경과 후 현재 뷰포트로 1회 발사. 영구 로딩 금지 |
+| D14 | **결과 후 자유 확대** — 결과 도착 뒤 재정규화·재요청 없음. 확대해 격자 틴트·경로를 들여다볼 수 있다(§8 R1의 "1km에서 셀 6~7px 육안 미식별"이 여기서 해소) |
+
+### 폐기 항목
+
+| 폐기 | 대체 | 사유 |
+|---|---|---|
+| `MAX_VIEWPORT_SPAN_DEG` = 0.5 · `needsSpanNormalize` (§6 A2) | `needsZoomNormalize({ zoom, targetZoom })` | 항상 1km면 서버 뷰포트 상한(14401)이 구조적으로 불가능 — 0.5도 판정은 죽은 조건이 된다. 두 규칙 병존은 "언제 정규화되는가"를 두 갈래로 갈라 재현·설명을 어렵게 한다 |
+| L12 (0.5도 경계·null 3케이스) | L20~L24 | 위와 동일. 테스트도 함께 삭제 |
+| "2차는 `bounds` 참조 변경 시 발사" (§10 대안 표) | `reachedTargetViewport` — 참조 변경 **AND** 줌이 목표 단 | 진행 중 사용자가 지도를 만지면 그 조작 뷰포트로 2차가 나간다 |
+
+### 추가 수용 기준 (L20~L25 · S10~S12)
+
+로직 — L20 1km가 아니면 요청 없이 줌 명령만 · L21 이미 1km면 줌 명령 **없이** 즉시 발사(같은 값 `zoomTo`는 `idle`을 안 내 요청이 영영 안 나간다) · L22 목표 도달 시 정확히 1회(StrictMode 2회 실행 포함) · L23 클릭 즉시 로딩 + `requestedAt`은 mutate 시점 · L24 2차는 목표 도달 후, 도달 실패해도 창 경과 후 현재 뷰포트로 1회 · L25 결과 상태의 뷰포트 변경은 요청을 유발하지 않음.
+화면 — S10 줌 16·줌 10 양쪽에서 제출 → 1km로 맞춰진 뒤 요청 1회 · S11 클릭~결과 구간 로딩 끊김 없음 · S12 결과 후 확대 시 오버레이 유지·recommend 추가 0.
+
+### 구현 (커밋 `42e5b8b` 위의 후속 커밋)
+
+- `route-request.ts` — `needsZoomNormalize`(내림 비교: 축척 라벨이 내림 기준이라 13.4도 "1km") · `reachedTargetViewport`(bounds 참조 교체 AND 목표 줌, `boundsAtCommand === null`이면 재진입으로 보고 도달 처리 — A7) · `VIEWPORT_SETTLE_TIMEOUT_MS`(3s). **목표 줌 단은 파라미터로 받는다** — `features/ai-route`가 `features/map-home`을 import하지 않게 뷰-레이어 훅이 `MAP_SCALE_1KM_ZOOM`을 주입한다.
+- `ai-route-store.ts` — 사이클 플래그 6번째 `normalizePending` + 액션 `startNormalize()`(로딩만 켜고 `requestedAt` 미기록). `startRequest`(= `onMutate`)가 `clearedCycle()`로 끈다.
+- `use-ai-route-auto-move.ts` — `submit()`이 줌을 보고 분기, 정규화 이펙트와 2차 이펙트 모두 `VIEWPORT_SETTLE_TIMEOUT_MS` 상한으로 종결. 두 이펙트의 중복 발사 방어는 스토어 플래그 `getState()` 재확인(기존 2차 패턴 그대로 — TanStack `onMutate`가 `mutate()` 안에서 동기 실행되는 것이 A7 테스트로 이미 입증됨).
+- `AiRoutePage.tsx` **0줄** — 훅 API(`submit`·`originActive`)와 `status` 계약이 그대로라 배선 변경이 없다. 490 소유 파일도 0줄.
+- 테스트 픽스처 갱신 2건: 훅 테스트·패널 스모크의 `useViewportStore` 초기값에 `zoom: MAP_SCALE_1KM_ZOOM` 추가 — D10 이후 "제출이 즉시 발사되는 상태"의 전제가 바뀌었다(단정은 손대지 않음).
+
+### 검토한 대안 (기각 사유)
+
+| 판단 | 채택 | 기각한 대안 |
+|---|---|---|
+| 정규화 범위 | 항상 1km | 0.5도 규칙 유지 + 1km 이동 병행 → 정규화 트리거가 두 갈래로 갈리고 사용자 지시("해당 위치에서만 추천")를 만족하지 못한다 |
+| 로딩 시작 시점 | `startNormalize`(로딩만) → `startRequest`(mutate) 2단 | 클릭 시점에 `startRequest` 호출 → `requestedAt`이 앞당겨져 10초 창을 대기가 먹고 2차가 조기 발사(14429) |
+| 정규화 대기 플래그 | 스토어 `normalizePending` | ①훅 로컬 `useRef` → 이펙트가 재실행되지 않아 종결 상한 타이머를 걸 시점이 없고, 대기 중 이탈 시 예약이 소실된다 ②`useState` → 스토어와 로딩 상태가 이중화된다 |
+| 2차 발사 게이트 | `reachedTargetViewport` 순수 함수(줌·bounds 파라미터) | ①bounds 참조 변경만 → 진행 중 조작 뷰포트로 발사 ②지도 잠금 → 사용자 기각 + 접촉 금지 파일을 열어야 함 |
+| 도달 실패 출구 | 3s 상한 후 현재 뷰포트로 발사 | ①무한 대기 → 영구 로딩 ②에러 처리 → 사용자가 방금 본 화면으로 추천받는 편이 낫고, 서버 오류와 구분이 안 된다 |
+| 목표 줌 상수 전달 | 뷰-레이어 훅이 파라미터 주입 | `route-request.ts`가 `map-scale`을 직접 import → `features/ai-route` → `features/map-home` cross-feature 의존 신설 |
+
+---
+
+## 12. 재작업 + 클러스터 숨김 (2026-08-29 — 검증 결함 1건 · 사용자 신규 지시 1건)
+
+> 입력: `_workspace/MSG-489/03b_verify_report.md`(§11 검증 — 결함 재현·계측) · 사용자 지시(2026-08-29)
+> 빌드 리포트: `_workspace/MSG-489/02c_build_report.md` (`02_`·`02b_`는 무수정)
+
+### 12-1. 결함 — D13 탈출 경로가 정규화를 건너뛰어 14401을 만들었다
+
+**재현**(검증 실측): `/ai-route`에서 줌 9(축척 16km)로 정착 → 문장 제출 → **3초 안에 탭을 백그라운드로 전환**.
+숨은 탭에서는 `requestAnimationFrame`이 멈춰(측정 0.5~1fps) 네이버 지도가 줌 애니메이션도 `idle`도 진행하지 않는다.
+`viewport-store.bounds`가 옛 값에 머문 채 `VIEWPORT_SETTLE_TIMEOUT_MS`가 3,320ms에 만료돼 **1.9379° × 4.7461°** 뷰포트로 요청이 나갔고, HTTP 400 `developCode 14401`. 지도는 이미 1km인데 패널만 "지도를 조금 더 확대하거나…" 안내가 떠 화면과 안내가 모순됐다. 본체 수용 기준 **S8 위반**.
+
+**근인**: §11 D10이 "항상 1km면 14401은 구조적으로 불가능"이라며 `MAX_VIEWPORT_SPAN_DEG`·`needsSpanNormalize`를 폐기했는데, 같은 §11이 신설한 D13의 종결 출구(상한 만료 발사)는 그 정규화를 **건너뛴다**. 지워진 상한 판정이 그 경로의 유일한 방어선이었다 — D10과 D13이 서로를 무효화했다.
+
+### 12-2. §11 D10 서술 정정 (폐기 이력 정정)
+
+| §11 문면 | 정정 |
+|---|---|
+| "항상 1km면 서버 뷰포트 상한(14401)이 **구조적으로 불가능**해 별도 판정이 필요 없다" | **반증됨.** 정상 경로에서만 참이다. D13의 상한 만료 출구·정착 실패 경로는 정규화를 거치지 않으므로 별도 가드가 필요하다 |
+| `MAX_VIEWPORT_SPAN_DEG` 폐기 | **부분 철회** — 상수와 판정을 되살렸다. 단 **정규화 트리거로는 복귀하지 않는다**(그 역할은 `needsZoomNormalize`가 유지). 발사 직전 최종 가드 전용이다 |
+| `needsSpanNormalize(bounds)` 폐기 | 폐기 유지 — 되살린 것은 이름·시그니처가 다른 `exceedsViewportSpan({ viewport, maxSpanDeg })`이고, bounds를 잘라 보내는 동작은 없다 |
+
+### 12-3. 수정 (계약 3항)
+
+| 계약 | 구현 |
+|---|---|
+| 상한 초과 요청은 **어떤 경로로도** 나가지 않는다 | `use-ai-route-auto-move.ts`의 `send()`를 **유일한 발사 지점**으로 명시하고, 조립된 body의 `viewport`에 `exceedsViewportSpan`을 적용해 초과 시 `mutate`를 호출하지 않는다(boolean 반환). 즉시·정규화 대기·상한 만료·2차 네 경로가 모두 이 함수를 지난다 |
+| 패널이 로딩에 갇히지 않는다 (D13 유지) | 보내지 못한 경로는 스토어 `abortPending(VIEWPORT_TOO_WIDE_NOTICE)`로 **명시적 에러 화면**으로 종결한다 — 두 대기 플래그(`normalizePending`·`secondaryPending`)를 함께 풀고 `RouteErrorNotice`의 "다시 시도"로 사용자가 재요청할 수 있다. 영구 로딩도, 확정 400도 아니다 |
+| 숨은 탭에서 상한을 소모하지 않는다 | 뷰-레이어 훅 지역 `useDocumentVisible()` — `document.hidden` 동안에는 정착 상한 타이머를 **걸지 않고**, 복귀 시 다시 3초를 잰다. 이미 도달한 뒤의 2차 대기(서버 10초 창)는 가시성과 무관하게 계속 잰다 |
+
+- **`VIEWPORT_SETTLE_TIMEOUT_MS`는 3,000ms 유지.** 검증 실측 줌 애니메이션은 16→13 **269ms** · 10→13 **296ms** · 10→16 **729ms**로 여유 ≈4배다. §11이 근거로 삼은 "14.2초"는 백그라운드 탭 rAF 정지 아티팩트로 판명됐다(같은 전이가 숨은 탭 11,162ms / 전면 탭 316ms). 낮추면 결함 창이 넓어진다.
+- 순수 판정(`MAX_VIEWPORT_SPAN_DEG`·`exceedsViewportSpan`)은 `route-request.ts`에 두고 상한 값은 파라미터 주입 — `features/ai-route` → `features/map-home` import 0 유지. 가시성(`document`)은 뷰-레이어 훅에만 둔다(RN 경계).
+
+### 12-4. 클러스터 숨김 (사용자 신규 지시)
+
+> 지시 원문: "ai 경로 추천인 상태에서는 다른 애들 클러스터링 된 것들 안보이게 해 / 한마디로 줌레벨 100m보다 커지면 더 이상 지도상에서 안 보이게 하라는 뜻이야"
+
+- `widgets/map-shell/cluster-route-gate.ts`의 `gateRouteClusters(clusters, pathname)` — `pathname === ROUTES.aiRoute`면 빈 배열. `MapShell`이 파생한 `clusters`에만 적용하고 `MapCanvas`에 `visibleClusters`를 내린다. 파생 훅(집계 쿼리 3종)은 손대지 않아 **다른 섹션 영향 0**이다.
+- **"100m보다 커지면"은 이 게이트 하나로 전부 충족된다**: 대상 3종(지역 점령 집계 `toRegionClusterMarkers` · 미션 집계 · 핫구역 집계)은 줌 16(100m) **미만에서만** 존재하는 층이고 16 이상에서는 격자 채움으로 전환되므로, 줌 분기를 따로 둘 필요가 없다. `/ai-route`는 칩이 없어 지역 점령 집계가 그려지던 자리다.
+- **소유권 이탈**: `widgets/map-shell/MapShell.tsx`는 MSG-488이 "완결 · 489·490 0줄"로 선언한 파일이다. **사용자가 이 변경을 명시 지시**했고 MSG-490도 이 파일 0줄이라 병렬 머지 충돌은 없다. 이번 예외는 이 한 파일·이 한 게이트에 한정한다(`MapCanvas.tsx`·`map-overlay-store.ts`·`use-map-shell.ts`·`packages/ui-web/*`는 계속 0줄).
+
+### 12-5. 검토한 대안 (기각 사유)
+
+| 판단 | 채택 | 기각한 대안 |
+|---|---|---|
+| 상한 만료 시 과대 뷰포트 처리 | 보내지 않고 안내로 종결 | ①**목표 줌 기준으로 중심에서 span 파생**(검증 1안) → span은 컨테이너 픽셀 크기·위도에 의존해 지도 밖에서 재현할 수 없고, 지도가 실제로 그 범위에 있지도 않아 결과가 화면과 어긋난다 ②bounds를 0.5도로 **잘라서** 발송 → 요청은 통과하나 D10("항상 1km")을 깨고 사용자가 보지 않은 55km 범위를 추천하게 된다 |
+| 가드 위치 | `send()` 1곳(유일 발사 지점) | ①두 `fire()`에 각각 검사 → 경로가 늘 때마다 빠뜨릴 수 있다(이번 결함의 재발 구조) ②`buildRecommendBody`에 상한 파라미터 추가 → MSG-488이 커밋한 L9 테스트 전건을 고쳐야 하고, "본문 조립"과 "발사 가능"이 한 함수에 섞인다 |
+| 종결 방식 | `abortPending` 신설(에러 + 두 대기 해제) | ①기존 `fail()` 재사용 → 대기 플래그가 남아 같은 뷰포트로 재발사된다 ②`cancelNormalize()` + `fail()` 2회 호출 → 중간 상태(로딩인데 대기 없음)가 한 프레임 노출된다 |
+| 가시성 처리 위치 | 뷰-레이어 훅 지역 `useDocumentVisible` | ①`shared/` 어댑터 신설 → 사용처 1곳뿐이라 성급한 공통화(두 번째 사용처에서 승격) ②순수 모델에서 `document` 참조 → RN 경계·oxlint 위반 |
+| 상한 값 | 3,000ms 유지 | ①1,200ms로 축소 → 실측 최대 729ms 대비 여유가 줄어 정착 실패 경로(=결함 창)가 넓어진다 ②확대 → 정착 실패 시 사용자가 더 오래 기다린다 |
+| 클러스터 숨김 지점 | `MapShell`의 파생 결과 게이트 | ①집계 훅 3종에 라우트 조건 추가 → `features/map-home`이 라우트를 알게 되고 다른 섹션에 회귀 위험 ②`MapCanvas`에서 숨김 → 접촉 금지 파일이고 지도 경계에 라우트 지식이 들어간다 |
+
+### 12-5. 14429 문구 교체 (2026-08-29, 사용자 지시)
+
+**지시**: "다시 시도 연속으로 보내면 이렇게만 뜨는데(잠시 후 다시 시도해 주세요), 요청이 너무 잦습니다… 응답으로 이게 오거든 이 문구로 그대로 내보내줘도 될 거 같아"
+
+`route-error.ts`의 `14429` 안내를 `"잠시 후 다시 시도해 주세요"` → **`"요청이 너무 잦습니다. 잠시 후 다시 시도해주세요"`**(서버 응답과 동일 문장)로 교체. 종전 문구는 "왜 막혔는지"를 알려주지 않아, 재시도를 연속으로 누른 사용자가 같은 안내만 반복해서 보게 된다.
+
+**서버 문자열을 렌더하지는 않는다** — MSG-488 §1-5가 세운 "FE 고정 문구, 서버 `notice`는 신호로만" 정책을 유지하고 같은 문장을 FE 상수로 둔다(임의 서버 문자열 렌더 금지). 띄어쓰기는 서버 원문("다시 시도해주세요")을 그대로 따랐다 — 지시가 "그대로"였고, 한 화면에 다른 안내와 동시에 노출되지 않는다.
diff --git a/nose.baseline.json b/nose.baseline.json
index ce4c8a67..b84965b2 100644
--- a/nose.baseline.json
+++ b/nose.baseline.json
@@ -3,45 +3,6 @@
   "tool": "nose",
   "baseline_kind": "accepted-duplication",
   "families": [
-    {
-      "id": "00808d9b5575efb1",
-      "note": "repeated across 3 directories — extract a shared abstraction — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
-      "members": [
-        {
-          "id": "90e09c10001a26a6",
-          "source_digest": "fnv1a64:e2a201eaffda69a6",
-          "file": "apps/web/src/features/profile/ui/location-consent-screen.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 57,
-          "end_line": 60,
-          "kind": "Function",
-          "name": "ctaButton",
-          "is_fragment": false
-        },
-        {
-          "id": "1ca1d4cba9ea2264",
-          "source_digest": "fnv1a64:6142afa96ac5438d",
-          "file": "apps/web/src/features/upload/ui/upload-wizard-flow.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 162,
-          "end_line": 163,
-          "kind": "Function",
-          "name": "nextButton",
-          "is_fragment": false
-        },
-        {
-          "id": "6f023ab90eecf86d",
-          "source_digest": "fnv1a64:0122952205f67179",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 66,
-          "end_line": 67,
-          "kind": "Function",
-          "name": "submitButton",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "0132e006eea42261",
       "note": "repeated across 4 directories — extract a shared abstraction — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -586,45 +547,6 @@
         }
       ]
     },
-    {
-      "id": "0d15ac9750167195",
-      "note": "consolidate `useCurrentCoords` — 3 copies",
-      "members": [
-        {
-          "id": "03e4a3726e2129d0",
-          "source_digest": "fnv1a64:e05f46d1da962eed",
-          "file": "apps/mobile/src/features/dex/model/use-region-stat-query.ts",
-          "lang": "typescript",
-          "start_line": 52,
-          "end_line": 66,
-          "kind": "Function",
-          "name": "useCurrentCoords",
-          "is_fragment": false
-        },
-        {
-          "id": "d0650e039bb8b528",
-          "source_digest": "fnv1a64:eacffa5f717fb5c0",
-          "file": "apps/web/src/features/dex/model/use-region-stat-query.ts",
-          "lang": "typescript",
-          "start_line": 52,
-          "end_line": 66,
-          "kind": "Function",
-          "name": "useCurrentCoords",
-          "is_fragment": false
-        },
-        {
-          "id": "b06efc7841d809a9",
-          "source_digest": "fnv1a64:55053a666cf480a0",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
-          "lang": "typescript",
-          "start_line": 32,
-          "end_line": 46,
-          "kind": "Function",
-          "name": "useCurrentCoords",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "0db5d8ac0316501d",
       "note": "consolidate `div` — 2 copies",
@@ -2347,6 +2269,52 @@
         }
       ]
     },
+    {
+      "id": "25ae55e7a487529d",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "7947a50a956c7ef8",
+          "source_digest": "fnv1a64:148271fb2dfcbd5f",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 220,
+          "end_line": 238,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "8913f9ceaffcf103",
+          "source_digest": "fnv1a64:4ffc419943892caf",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 205,
+          "end_line": 218,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "948a761c9d5c2a31",
+          "source_digest": "fnv1a64:c6fd29b1c441f0fb",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 240,
+          "end_line": 253,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "f77ab17872279a46",
+          "source_digest": "fnv1a64:1d70ef71f9a62dc3",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 255,
+          "end_line": 264,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "25bade182c8be5d8",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -3340,6 +3308,45 @@
         }
       ]
     },
+    {
+      "id": "3aaf6c67a1d322e3",
+      "note": "repeated across 3 directories — extract a shared abstraction — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "90e09c10001a26a6",
+          "source_digest": "fnv1a64:e2a201eaffda69a6",
+          "file": "apps/web/src/features/profile/ui/location-consent-screen.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 57,
+          "end_line": 60,
+          "kind": "Function",
+          "name": "ctaButton",
+          "is_fragment": false
+        },
+        {
+          "id": "1ca1d4cba9ea2264",
+          "source_digest": "fnv1a64:6142afa96ac5438d",
+          "file": "apps/web/src/features/upload/ui/upload-wizard-flow.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 162,
+          "end_line": 163,
+          "kind": "Function",
+          "name": "nextButton",
+          "is_fragment": false
+        },
+        {
+          "id": "bcfbf0257732dc87",
+          "source_digest": "fnv1a64:0122952205f67179",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 67,
+          "end_line": 68,
+          "kind": "Function",
+          "name": "submitButton",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "3c3c04fe3d64c1b7",
       "note": "duplicated across 2 directories — extract a method from the repeated block — high-parameter (8 varying spots): divergence readability; a smaller helper for the invariant core may fit better",
@@ -7615,32 +7622,6 @@
         }
       ]
     },
-    {
-      "id": "8abb8e8f76b002ea",
-      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
-      "members": [
-        {
-          "id": "8b458a7f106aba2c",
-          "source_digest": "fnv1a64:a7befad4bbcc9e51",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 210,
-          "end_line": 216,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "8f705544028b7013",
-          "source_digest": "fnv1a64:5d981aa860b0f991",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 95,
-          "end_line": 100,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "8af2a1b250789430",
       "note": "duplicated across 2 directories — extract a method from the repeated block — high-parameter (8 varying spots): divergence readability; a smaller helper for the invariant core may fit better",
@@ -7667,52 +7648,6 @@
         }
       ]
     },
-    {
-      "id": "8afa0cca113362a2",
-      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
-      "members": [
-        {
-          "id": "df726660d85787d8",
-          "source_digest": "fnv1a64:8a5dedc597e4d063",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 147,
-          "end_line": 169,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "3cd2ccf369a89dc9",
-          "source_digest": "fnv1a64:4ffc419943892caf",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 132,
-          "end_line": 145,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "5eb8663201e0e57b",
-          "source_digest": "fnv1a64:c6fd29b1c441f0fb",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 171,
-          "end_line": 184,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "e8ead66416159899",
-          "source_digest": "fnv1a64:1d70ef71f9a62dc3",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 186,
-          "end_line": 195,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "8b66ba605ad513fe",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -9160,6 +9095,32 @@
         }
       ]
     },
+    {
+      "id": "a252be9d2d9e2ca1",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "7351965584f6818f",
+          "source_digest": "fnv1a64:af1dfa16d6e4b263",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 175,
+          "end_line": 181,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "655f1c0ad0c9c9bb",
+          "source_digest": "fnv1a64:87d172a612855854",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 297,
+          "end_line": 303,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "a2a047f79f111a95",
       "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -10306,6 +10267,45 @@
         }
       ]
     },
+    {
+      "id": "b2cca4c3caff91e1",
+      "note": "consolidate `useCurrentCoords` — 3 copies",
+      "members": [
+        {
+          "id": "03e4a3726e2129d0",
+          "source_digest": "fnv1a64:e05f46d1da962eed",
+          "file": "apps/mobile/src/features/dex/model/use-region-stat-query.ts",
+          "lang": "typescript",
+          "start_line": 52,
+          "end_line": 66,
+          "kind": "Function",
+          "name": "useCurrentCoords",
+          "is_fragment": false
+        },
+        {
+          "id": "d0650e039bb8b528",
+          "source_digest": "fnv1a64:eacffa5f717fb5c0",
+          "file": "apps/web/src/features/dex/model/use-region-stat-query.ts",
+          "lang": "typescript",
+          "start_line": 52,
+          "end_line": 66,
+          "kind": "Function",
+          "name": "useCurrentCoords",
+          "is_fragment": false
+        },
+        {
+          "id": "470d22055eea927d",
+          "source_digest": "fnv1a64:55053a666cf480a0",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
+          "lang": "typescript",
+          "start_line": 43,
+          "end_line": 57,
+          "kind": "Function",
+          "name": "useCurrentCoords",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "b3694a4690fa9219",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -10538,32 +10538,6 @@
         }
       ]
     },
-    {
-      "id": "b7c5d4be692af391",
-      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
-      "members": [
-        {
-          "id": "3c2fdd18bb9e357b",
-          "source_digest": "fnv1a64:af1dfa16d6e4b263",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 172,
-          "end_line": 178,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "f39b5eb33fac205f",
-          "source_digest": "fnv1a64:87d172a612855854",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 294,
-          "end_line": 300,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "b7d50ca769a15da0",
       "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -10591,7 +10565,7 @@
       ]
     },
     {
-      "id": "b84a763f515a1ef8",
+      "id": "b84607ddbaeb04d8",
       "note": "consolidate `routes` — 3 copies",
       "members": [
         {
@@ -10606,12 +10580,12 @@
           "is_fragment": false
         },
         {
-          "id": "2b8338fdedd913cc",
+          "id": "22dd7e0c2187b7ac",
           "source_digest": "fnv1a64:f7d16498dfc8f3d3",
           "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
           "lang": "typescript",
-          "start_line": 73,
-          "end_line": 77,
+          "start_line": 82,
+          "end_line": 86,
           "kind": "Block",
           "name": "routes",
           "is_fragment": false
@@ -10657,6 +10631,32 @@
         }
       ]
     },
+    {
+      "id": "ba91d4a2c4677bdc",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "08963fa1a1250e80",
+          "source_digest": "fnv1a64:a7befad4bbcc9e51",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 282,
+          "end_line": 288,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "e005b977dfc5a049",
+          "source_digest": "fnv1a64:5d981aa860b0f991",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 104,
+          "end_line": 109,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "baacdd8d65657ca5",
       "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -12679,34 +12679,6 @@
         }
       ]
     },
-    {
-      "id": "dcf4f8cf0d982209",
-      "note": "consolidate `queryclientprovider` — 2 copies",
-      "members": [
-        {
-          "id": "0780b43894e117d8",
-          "source_digest": "fnv1a64:1f0bc9fdfa24bb86",
-          "file": "apps/web/src/pages/dex/dex-test-harness.tsx",
-          "lang": "typescript",
-          "start_line": 27,
-          "end_line": 50,
-          "kind": "Block",
-          "name": "queryclientprovider",
-          "is_fragment": false
-        },
-        {
-          "id": "67b416873ad71f32",
-          "source_digest": "fnv1a64:1cd1acf6e127984b",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 67,
-          "end_line": 79,
-          "kind": "Block",
-          "name": "queryclientprovider",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "dcf705c8f9235ea0",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -13236,6 +13208,34 @@
         }
       ]
     },
+    {
+      "id": "e2ccbeaed40ff899",
+      "note": "consolidate `queryclientprovider` — 2 copies",
+      "members": [
+        {
+          "id": "0780b43894e117d8",
+          "source_digest": "fnv1a64:1f0bc9fdfa24bb86",
+          "file": "apps/web/src/pages/dex/dex-test-harness.tsx",
+          "lang": "typescript",
+          "start_line": 27,
+          "end_line": 50,
+          "kind": "Block",
+          "name": "queryclientprovider",
+          "is_fragment": false
+        },
+        {
+          "id": "19269a88e9c927c2",
+          "source_digest": "fnv1a64:1cd1acf6e127984b",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 76,
+          "end_line": 88,
+          "kind": "Block",
+          "name": "queryclientprovider",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "e2eb13fd951d9636",
       "note": "consolidate `span` — 2 copies",
@@ -13264,6 +13264,42 @@
         }
       ]
     },
+    {
+      "id": "e4029f513ef518fd",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "8a63a58ebe683889",
+          "source_digest": "fnv1a64:a07e14e88600b7f0",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 201,
+          "end_line": 221,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "726376414e245ec0",
+          "source_digest": "fnv1a64:3e2b07f8237196b4",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 223,
+          "end_line": 240,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "a6750488e8628b64",
+          "source_digest": "fnv1a64:fd95561cb55b726f",
+          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
+          "lang": "typescript",
+          "start_line": 174,
+          "end_line": 185,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "e427188f95a173e0",
       "note": "duplicated across 2 directories — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -13662,6 +13698,32 @@
         }
       ]
     },
+    {
+      "id": "f0b68aff23f94d8c",
+      "note": "local duplication — extract a method from the repeated block",
+      "members": [
+        {
+          "id": "3792025dbf418c0e",
+          "source_digest": "fnv1a64:d6525215b91d02c8",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
+          "lang": "typescript",
+          "start_line": 170,
+          "end_line": 174,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "8bcc9543c7695d3d",
+          "source_digest": "fnv1a64:e6f47b6bc6da04f2",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
+          "lang": "typescript",
+          "start_line": 191,
+          "end_line": 194,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "f12bf75ada2a762f",
       "note": "1 site reimplements `boxAt` — call the existing helper (apps/web/src/features/map-home/model/use-nearest-entry.test.tsx)",
@@ -13922,42 +13984,6 @@
         }
       ]
     },
-    {
-      "id": "f4d91cd257a2171d",
-      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
-      "members": [
-        {
-          "id": "9fc87c7873336c19",
-          "source_digest": "fnv1a64:a07e14e88600b7f0",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 198,
-          "end_line": 218,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "0c8b0cdf17c3ac46",
-          "source_digest": "fnv1a64:3e2b07f8237196b4",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 220,
-          "end_line": 237,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "89d6ef56a89b6e62",
-          "source_digest": "fnv1a64:fd95561cb55b726f",
-          "file": "apps/web/src/pages/ai-route/ai-route-panel.smoke.test.tsx",
-          "lang": "typescript",
-          "start_line": 171,
-          "end_line": 182,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "f5430579f4f967e5",
       "note": "duplicated across 2 directories — extract a method from the repeated block",

From 8368b1f89499d1850b852223527a3a082300a159 Mon Sep 17 00:00:00 2001
From: gyuhochoime <cjg1999@naver.com>
Date: Sat, 29 Aug 2026 15:38:04 +0900
Subject: [PATCH 3/6] =?UTF-8?q?MSG-489=20chore:=20=EC=9B=B9=20=EC=8B=A4?=
 =?UTF-8?q?=EB=8F=99=EC=9E=91=20=EA=B2=80=EC=A6=9D=EC=97=90=20=ED=83=AD=20?=
 =?UTF-8?q?=EA=B0=80=EC=8B=9C=EC=84=B1=C2=B7rAF=20=ED=94=84=EB=A0=88?=
 =?UTF-8?q?=EC=9E=84=EB=A5=A0=20=EC=A0=84=EC=A0=9C=20=EC=A1=B0=EA=B1=B4=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

브라우저 자동화 탭이 백그라운드면 rAF가 0.5~1fps로 얼어 계측이 35배까지 부풀려진다(같은 줌 전이가 숨은 탭 11,162ms · 전면 탭 316ms). 그 값이 "정규화 대기 14.2초 무피드백"이라는 리포트 문장과 후속 권장까지 만들어 냈고, 더 나쁜 것은 숨은 탭에서는 지도가 idle을 내지 않아 동작 자체가 달라진다는 점이다 — 오염된 계측이 실제 결함(14401)을 가리고 있었다. 계측 신뢰성을 검증자의 주의력이 아니라 절차의 전제 조건으로 내린다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QkrsSVoDCWaPAV45gzKpZX
---
 .claude/skills/page-verification/SKILL.md | 4 ++++
 CLAUDE.md                                 | 2 +-
 docs/HARNESS_CHANGELOG.md                 | 1 +
 3 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/.claude/skills/page-verification/SKILL.md b/.claude/skills/page-verification/SKILL.md
index fe88c0d2..828466e1 100644
--- a/.claude/skills/page-verification/SKILL.md
+++ b/.claude/skills/page-verification/SKILL.md
@@ -63,6 +63,10 @@ pnpm openapi-ts && git diff --exit-code apps/web/src/shared/api/generated  # 생
 #### 3-A. 웹 (apps/web · packages/ui-web)
 
 1. `pnpm dev`로 dev 서버 실행 (백그라운드)
+1-1. **시간을 재기 전에 탭이 살아 있는지부터 확인한다** — 브라우저 자동화 탭은 기본적으로 백그라운드일 수 있고, 그러면 `requestAnimationFrame`이 초당 0.5~1회로 죽어 **지도 애니메이션·전이·디바운스 계측이 10~40배로 부풀려진다**. 계측형 기준(대기 시간·타임아웃·연속 호출 간격)이 하나라도 있으면 다음을 먼저 실측해 리포트에 남긴다:
+   - `document.visibilityState === "visible"`, 아니면 탭을 전면으로 올린 뒤 재확인 (`osascript -e 'tell application "Google Chrome" to activate'` 등)
+   - rAF 프레임률 1초 표본 — 60fps 이상이어야 계측이 유효하다
+   숨은 탭에서 잰 숫자는 **버리고 다시 잰다**. 지도가 `idle`을 내지 않아 뷰포트 스토어가 옛 값에 머무는 등 **동작 자체가 달라지는** 경로도 있다 (MSG-489 — "정규화 대기 14.2초"가 이 아티팩트였고, 같은 전이가 전면 탭에서 316ms였다. 그 오염된 숫자 뒤에 실제 결함이 숨어 있었다)
 2. 화면형 수용 기준을 하나씩 브라우저에서 재현하고 관찰한다. 브라우저 자동화 도구가 있으면 스크린샷을 `_workspace/MSG-{번호}/screenshots/`에 남기고, 자동화가 불가하면 리포트에 "스크린샷 미보존(사유)"를 명시한다 — 조용히 생략하지 않는다
 3. **Figma 대조**: 스펙에 Figma 노드가 있으면 해당 노드 스크린샷(`get_screenshot`)과 렌더 결과를 나란히 놓고 구조·간격·색·타이포를 비교한다. 스펙의 "오탐 방지/의도된 편차" 목록에 있는 차이는 결함이 아니다 — 목록에 없는 차이만 실패 후보로 올린다
 4. **a11y 점검** (변경된 UI 범위만):
diff --git a/CLAUDE.md b/CLAUDE.md
index 0e4864e7..27261ac6 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -28,8 +28,8 @@ pnpm 모노레포 — apps/web(React 19 + Vite) + apps/mobile(Expo, 대부분 
 **변경 이력 (최근 5행 이내 — 전체는 `docs/HARNESS_CHANGELOG.md`, 밀려난 행은 그리로 이관):**
 | 날짜 | 변경 내용 | 대상 | 사유 |
 |------|----------|------|------|
+| 2026-08-29 | 웹 실동작 검증(3-A)에 **탭 가시성·rAF 프레임률 전제 조건** 신설 — 계측형 기준이 있으면 `document.visibilityState`와 rAF 표본을 먼저 실측하고, 숨은 탭에서 잰 숫자는 버리고 다시 잰다 | skills/page-verification | MSG-489 후속 — 브라우저 자동화 탭이 백그라운드였고 rAF가 **0.5~1fps로 정지**해 있었다. 같은 줌 전이가 숨은 탭 11,162ms · 전면 탭 316ms로 **35배** 부풀려졌고, 그 값이 "정규화 대기 14.2초 무피드백"이라는 리포트 문장과 후속 티켓 권장까지 만들어 냈다. 더 나쁜 것은 **동작 자체가 달라진다**는 점이다 — 숨은 탭에서는 네이버 지도가 `idle`을 내지 않아 뷰포트 스토어가 옛 값에 머물고, 그 상태에서 D13 타임아웃이 발화해 정규화되지 않은 뷰포트(1.9°×4.7°)로 요청이 나가 서버 400(14401)이 재현됐다. 즉 오염된 계측이 실제 결함을 가리고 있었다. 계측 신뢰성은 검증자 개인의 주의력이 아니라 절차의 전제 조건으로 내린다 |
 | 2026-08-28 | react-doctor `js-tosorted-immutable` 규칙 off 선언 + **규칙 설정이 v0.9.3 스캐너에 안 먹는다는 실측 기록** | doctor.config.json, CLAUDE.md | MSG-488 PR #104 리뷰 — **두 도구가 정반대를 지시하고 있었다**: react-doctor는 `[...arr].sort()`를 `toSorted()`로 바꾸라 하고, `.oxlintrc.json:84`는 `toSorted`를 error로 금지한다(Hermes 미구현 — MSG-427에서 지도 홈을 마운트 즉시 크래시시킨 그 API). oxlint 금지가 `apps/mobile`·`packages/ui-native` 한정이라 **웹 파일에서는 react-doctor만 말하고 게이트 6종이 아무것도 안 잡는다**. 비용은 실측된다: 웹 프로덕션 `toSorted` 6곳 중 모바일 이식본이 있는 **5곳 전부**가 손으로 `[...].sort()`로 되돌려져 Hermes 주석을 달고 있고(`hot-region-summary`·`course`·`use-multi-grid-videos-query`·`region-cluster-overlay`·`gallery-groups`), 뒤 둘은 MSG-427 사고로 지목된 바로 그 파일들이다(주석 2회로도 못 막혔던 자리). 지적 대상 `route-legs.ts:6`은 스스로 `(RN 재사용 대상)`이라 선언한다. 규칙의 근거도 사실과 다르다 — `toSorted()`도 새 배열을 할당하므로 "복사 없이 정렬"이 아니다. **단, 이 설정은 현재 무효다(실측)**: v0.9.3에서 `rules list`·`rules explain`은 `off`로 보고하고 공식 `react-doctor rules disable`이 쓴 것도 같은 내용인데, 스캐너는 규칙을 그대로 보고한다(레포 루트·`apps/web` cwd 양쪽, `ignore.tags`도 동일하게 무시). **기존 `js-combine-iterations: off`도 같은 이유로 무효였다.** 따라서 실효 방어선은 이 행의 기록이고, 설정은 도구가 고쳐지면 자동으로 듣도록 선언만 남긴다. **후속 후보**: oxlint 금지를 레포 전역으로 승격하면 이식 세금이 원천 제거되나 기존 웹 6곳 수정이 따르므로 별도 티켓 |
 | 2026-08-24 | claude-review 완주 검증 판정을 **PR 코멘트 마커 grep → 액션 execution output 3단 판정**(① 파일 존재 → ② 마지막 result `is_error=false && subtype=success` → ③ 게시 도구 호출 증거: `gh pr comment` Bash 또는 `update_claude_comment`)으로 교체, 마커는 warning 강등(프롬프트 지시 존치·1줄 보정), 실패 사유별 구분 `::error::`+실측값 출력 | .github/workflows/claude-review.yml | MSG-465 — PR #89 af67beb 오탐: 리뷰가 정상 완주했는데 봇이 진행 코멘트에 요약을 이어 붙이며 SHA 마커를 생략해 검증 스텝이 실패 표시. 판정이 봇의 그때그때 코멘트 작성 방식에 좌우되던 것을 액션 산출물(전사) 기준으로 분리 — MSG-403 원 사고(정상 종료·요약 미게시, `is_error=false`·`num_turns=17` 실측이라 result 판정만으론 통과)는 ③ 게시 증거가 계속 잡는다. 잔여 창(체크리스트만 갱신 후 침묵 종료)은 마커 warning으로 관찰, 재발 실측 시 후속 조임 |
 | 2026-08-21 | codex 리뷰 **실행 경로를 Bash companion 하나로 확정** + 시점을 커밋 직전 → **push 전**으로 이동 | skills/fillmap-page-dev | MSG-451 사고 — 종전 문구가 "`/codex:review` **또는** companion 서브커맨드"로 두 경로를 동등 나열해 세션마다 선택이 갈렸다. 8/17~19 세션은 companion으로 정상 실행했으나(워크트리 state 실측 15건), 이번 세션은 슬래시 커맨드를 시도했다가 `disable-model-invocation`에 막히자 **그대로 건너뛰어 커밋 4개가 리뷰 없이 진행**됐다. 선택지를 주면 막힌 쪽을 고른 세션이 스킵한다 — 명령줄을 스킬에 그대로 박았다. 시점은 커밋이 로컬이라 되돌리기 싸고 중간 커밋 리뷰가 곧 폐기될 코드를 반복해 보기 때문(MSG-451은 뒤 커밋이 앞 결정을 뒤집었다). **조사 과정 교훈**: 메인 레포 state만 보고 "8/13 이후 리뷰 0건"으로 단정했다가 워크트리별 state에서 15건을 발견해 정정 — 워크트리 병렬 작업에서는 저장소 단위 상태가 흩어진다 |
 | 2026-08-21 | 검증 스킬 실동작 경로를 **대상 앱**으로 분기 — 3-A(웹 브라우저) / 3-B(모바일 Android dev client) 신설, 모바일 확인불가 판정 기준·리포트 형식 명문화, 실기 런북(`docs/MOBILE_RUNBOOK.md`)과 원커맨드 스크립트(`pnpm --filter mobile android:dev`) 신설 | skills/page-verification, skills/fillmap-page-dev, docs/MOBILE_RUNBOOK.md, apps/mobile/scripts | MSG-449 — 절차 3이 `pnpm dev` + 브라우저로만 쓰여 있어 모바일 티켓에 대응 절차가 없었고, 웨이브 0~3(MSG-419~431)이 전부 정적 게이트(vitest·typecheck·lint)만으로 통과했다. 2026-08-20 실기 시도에서 함정 6가지(임베디드 번들 로더·스킴 충돌·8081 콜드 스타트 복귀·페어링 포트 만료·`--device`는 모델명·새 네이티브 의존성 prebuild)에 순차로 걸렸는데 전부 재발할 문제라 문서가 아니라 검증 경로 자체로 내린다. 후속 모바일 티켓이 이 절차로 검증한다 |
-| 2026-08-19 | 모바일 런타임(Hermes) 미구현 API 차단 규칙 신설 — `apps/mobile`·`packages/ui-native` 한정 `no-restricted-properties`(`toSorted`·`toReversed`·`toSpliced`·`Object.groupBy`·`Map.groupBy`·`Promise.withResolvers`) + `no-restricted-globals`(`structuredClone`) | .oxlintrc.json | MSG-427 실기 사고 — 웹에서 포팅한 `toSorted` 3곳이 지도 홈을 마운트 즉시 크래시시켰는데 **게이트 6종이 전부 통과**했다(vitest는 Node에서 돌아 메서드가 존재하고, typecheck는 `lib`에 ES2023이 있다). 같은 함정이 `gallery-groups.ts`·`region-cluster-overlay.ts`에 두 번 주석으로 문서화돼 있었는데도 재발해, 주석으로는 못 막는 것이 실증됐다. 웹→모바일 포팅이 계속되는 한(MSG-428 등) 재발 창이 열려 있어 기계 게이트로 내린다 (MSG-298·386 좌시프트 원칙) |
diff --git a/docs/HARNESS_CHANGELOG.md b/docs/HARNESS_CHANGELOG.md
index fdd7c927..d64b41be 100644
--- a/docs/HARNESS_CHANGELOG.md
+++ b/docs/HARNESS_CHANGELOG.md
@@ -5,6 +5,7 @@ CLAUDE.md에는 최근 5행만 유지하고, 행이 밀려나면 이 파일로 
 
 | 날짜 | 변경 내용 | 대상 | 사유 |
 |------|----------|------|------|
+| 2026-08-19 | 모바일 런타임(Hermes) 미구현 API 차단 규칙 신설 — `apps/mobile`·`packages/ui-native` 한정 `no-restricted-properties`(`toSorted`·`toReversed`·`toSpliced`·`Object.groupBy`·`Map.groupBy`·`Promise.withResolvers`) + `no-restricted-globals`(`structuredClone`) | .oxlintrc.json | MSG-427 실기 사고 — 웹에서 포팅한 `toSorted` 3곳이 지도 홈을 마운트 즉시 크래시시켰는데 **게이트 6종이 전부 통과**했다(vitest는 Node에서 돌아 메서드가 존재하고, typecheck는 `lib`에 ES2023이 있다). 같은 함정이 `gallery-groups.ts`·`region-cluster-overlay.ts`에 두 번 주석으로 문서화돼 있었는데도 재발해, 주석으로는 못 막는 것이 실증됐다. 웹→모바일 포팅이 계속되는 한(MSG-428 등) 재발 창이 열려 있어 기계 게이트로 내린다 (MSG-298·386 좌시프트 원칙) |
 | 2026-08-13 | 검증 풀 게이트에 openapi-ts 드리프트 검사 추가(5종→6종), hey-api는 루트 devDep+TS ~6.0.3 peer로 이전 | skills/page-verification·page-implementation, agents 2종, package.json | MSG-386 CI 실패 환류 — CI에만 있던 드리프트 게이트가 검증 스킬에 없어 hey-api TS 7 비호환을 로컬이 못 잡음 (MSG-298 좌시프트 원칙 누락 보수) |
 | 2026-08-13 | task-retro 산출 경로 변경 — docs/retro/(레포) → ~/fillmaphtml/(레포 밖, 커밋 없음) | skills/task-retro, skills/fillmap-page-dev, CLAUDE.md | 사용자 결정 — 회고는 개인 학습 자산, 레포 스테이징분은 사용자가 되돌림 |
 | 2026-08-13 | 테스트 템플릿 신설 — 유형 선택 매트릭스(로직/스토어/쿼리 훅/스모크/흐름)와 단정 범위, test-first에 템플릿 선택 의무화, 검증 감사에 템플릿 부합 추가 | skills/page-implementation(+references/test-templates.md), skills/page-verification | MSG-380 — 템플릿 없는 TDD가 무의미 테스트를 양산(사용자 보고). Testing Trophy·공식 가이드 리서치 기반 |

From c0cf7d2fe8df5958e763bcac40ae84fdf638af93 Mon Sep 17 00:00:00 2001
From: gyuhochoime <cjg1999@naver.com>
Date: Sat, 29 Aug 2026 16:12:10 +0900
Subject: [PATCH 4/6] =?UTF-8?q?MSG-489=20fix:=20[=EC=9B=B9]=20AI=20?=
 =?UTF-8?q?=EA=B2=BD=EB=A1=9C=EC=B6=94=EC=B2=9C=20=E2=80=94=202=EC=B0=A8?=
 =?UTF-8?q?=20=EC=9A=94=EC=B2=AD=20=EB=A1=9C=EA=B7=B8=EC=9D=B8=20=EC=B2=98?=
 =?UTF-8?q?=EB=A6=AC=20=EB=B6=80=EC=B0=A9=20+=20=EC=A0=95=EC=B0=A9=20?=
 =?UTF-8?q?=EC=83=81=ED=95=9C=20=EB=AC=B4=ED=95=9C=20=EC=97=B0=EA=B8=B0=20?=
 =?UTF-8?q?=EC=B0=A8=EB=8B=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

codex 리뷰(push 전 게이트) 지적 2건 반영.

- [P1] 2차 요청 인스턴스에 onLoginRequired가 없어, 1차 성공과 지연된 2차 사이에 세션이 만료되면 401에도 로그인 모달이 뜨지 않았다. secondary 옵션은 onMutate만 분기하고 onError는 공통 경로라 콜백 주입 한 줄로 1·2차 동작이 같아진다. 문서에 "알려진 한계"로 적혀 있던 서술은 결함이었음을 명시하고 정정
- [P2] 목표 뷰포트 미도달 상태에서 bounds·zoom이 갱신될 때마다 이펙트가 재실행되며 상한 타이머를 처음부터 다시 걸어, 사용자가 계속 패닝하면 2차가 무한정 연기되고 패널이 로딩에 갇혔다 — §11 D13(영구 로딩 금지) 정면 위반. 지적은 2차만 짚었으나 정규화 대기도 같은 구조여서 함께 고쳤다
- 마감을 대기 사이클당 1회만 계산하는 순수 함수 advanceSettleDeadline 신설 — 이펙트 재실행은 남은 시간만 스케줄하고, remaining <= 0이면 타이머 없이 즉시 종결한다(setTimeout(fire, 0)은 다음 cleanup에 취소될 창이 남는다)
- 가시성 공존: 마감이 hiddenSince를 기억해 복귀 시 숨어 있던 만큼 뒤로 밀린다(= 가시 시간만 소모). 숨은 동안 타이머를 걸지 않는 §12 동작과 도달 후 서버 10초 창은 그대로
- 실타이머 실측: 정규화 대기 반복 패닝 3,116ms · 2차 대기 3,168ms · 숨김 복귀 후 <2,200ms 종결. RED 단계에서 패닝 3시나리오 전부 미발사(무한)로 결함 재현
- 게이트 6종 green(web 1481 tests). 브라우저 실동작 4건은 확인불가 — 검증 시점에 탭이 hidden 고정(rAF 정지)이고 로그인 세션이 만료돼 있었다

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QkrsSVoDCWaPAV45gzKpZX
---
 .../ai-route/model/route-request.test.ts      | 114 +++++++
 .../features/ai-route/model/route-request.ts  |  54 ++++
 .../ui/use-ai-route-auto-move.test.tsx        | 147 ++++++++-
 .../ai-route/ui/use-ai-route-auto-move.ts     | 113 ++++++-
 docs/STATUS.md                                |   2 +-
 docs/decisions/DECISIONS.md                   |   2 +
 docs/spec/MSG-489.md                          |  55 +++-
 nose.baseline.json                            | 300 ++++++++++--------
 8 files changed, 624 insertions(+), 163 deletions(-)

diff --git a/apps/web/src/features/ai-route/model/route-request.test.ts b/apps/web/src/features/ai-route/model/route-request.test.ts
index a9019610..752dc83b 100644
--- a/apps/web/src/features/ai-route/model/route-request.test.ts
+++ b/apps/web/src/features/ai-route/model/route-request.test.ts
@@ -2,6 +2,7 @@ import { describe, expect, it } from "vitest";
 import type { Bounds } from "@/entities/cell";
 import {
   MAX_ROUTE_TEXT_LENGTH,
+  advanceSettleDeadline,
   MAX_VIEWPORT_SPAN_DEG,
   SECONDARY_MIN_INTERVAL_MS,
   buildRecommendBody,
@@ -297,3 +298,116 @@ describe("secondaryDelayMs — 2차 자동 재요청 대기 (Q2 안 B)", () => {
     expect(secondaryDelayMs({ requestedAt: null, now: 4_000 })).toBe(0);
   });
 });
+
+describe("advanceSettleDeadline — 가시 시간만 소모하는 정착 마감 (§13 P2)", () => {
+  const TIMEOUT = 3_000;
+
+  it("첫 호출이 마감을 확정한다 — 상한만큼 남은 채로 시작한다", () => {
+    const { deadline, remainingMs } = advanceSettleDeadline({
+      deadline: null,
+      now: 1_000,
+      visible: true,
+      timeoutMs: TIMEOUT,
+    });
+
+    expect(deadline).toEqual({ deadlineAt: 4_000, hiddenSince: null });
+    expect(remainingMs).toBe(TIMEOUT);
+  });
+
+  it("이미 선 마감은 다시 계산하지 않는다 — 재호출은 남은 시간만 돌려준다", () => {
+    const first = advanceSettleDeadline({
+      deadline: null,
+      now: 1_000,
+      visible: true,
+      timeoutMs: TIMEOUT,
+    });
+    // 대기 중 뷰포트가 갱신돼 이펙트가 여러 번 재실행되는 상황
+    const second = advanceSettleDeadline({
+      deadline: first.deadline,
+      now: 2_500,
+      visible: true,
+      timeoutMs: TIMEOUT,
+    });
+    const third = advanceSettleDeadline({
+      deadline: second.deadline,
+      now: 3_800,
+      visible: true,
+      timeoutMs: TIMEOUT,
+    });
+
+    expect(second.remainingMs).toBe(1_500);
+    expect(third.remainingMs).toBe(200);
+    expect(third.deadline.deadlineAt).toBe(4_000);
+  });
+
+  it("마감이 지나면 0이다 — 호출부가 즉시 종결 경로를 탄다 (D13)", () => {
+    const started = advanceSettleDeadline({
+      deadline: null,
+      now: 1_000,
+      visible: true,
+      timeoutMs: TIMEOUT,
+    });
+
+    expect(
+      advanceSettleDeadline({
+        deadline: started.deadline,
+        now: 9_000,
+        visible: true,
+        timeoutMs: TIMEOUT,
+      }).remainingMs,
+    ).toBe(0);
+  });
+
+  it("숨은 구간은 마감에서 제외된다 — 복귀 시 그만큼 마감이 밀린다 (§12)", () => {
+    const started = advanceSettleDeadline({
+      deadline: null,
+      now: 1_000,
+      visible: true,
+      timeoutMs: TIMEOUT,
+    });
+    // 1초 소모한 뒤 탭이 숨는다
+    const hidden = advanceSettleDeadline({
+      deadline: started.deadline,
+      now: 2_000,
+      visible: false,
+      timeoutMs: TIMEOUT,
+    });
+    // 숨은 채 5초가 더 흘러도 마감은 그대로 밀려 있다
+    const stillHidden = advanceSettleDeadline({
+      deadline: hidden.deadline,
+      now: 7_000,
+      visible: false,
+      timeoutMs: TIMEOUT,
+    });
+    const resumed = advanceSettleDeadline({
+      deadline: stillHidden.deadline,
+      now: 7_000,
+      visible: true,
+      timeoutMs: TIMEOUT,
+    });
+
+    expect(hidden.deadline.hiddenSince).toBe(2_000);
+    // 숨김 시작 시각은 첫 숨김 관측으로 고정된다 — 재실행이 구간을 잘게 쪼개지 않는다
+    expect(stillHidden.deadline.hiddenSince).toBe(2_000);
+    // 남은 상한은 숨기 직전 그대로(2초)이고, 마감은 숨은 5초만큼 뒤로 간다
+    expect(resumed.remainingMs).toBe(2_000);
+    expect(resumed.deadline).toEqual({ deadlineAt: 9_000, hiddenSince: null });
+  });
+
+  it("숨은 채로 시작하면 그 시점부터 숨김 구간이다 — 상한을 소모하지 않는다", () => {
+    const started = advanceSettleDeadline({
+      deadline: null,
+      now: 1_000,
+      visible: false,
+      timeoutMs: TIMEOUT,
+    });
+    const resumed = advanceSettleDeadline({
+      deadline: started.deadline,
+      now: 11_000,
+      visible: true,
+      timeoutMs: TIMEOUT,
+    });
+
+    expect(resumed.remainingMs).toBe(TIMEOUT);
+  });
+});
diff --git a/apps/web/src/features/ai-route/model/route-request.ts b/apps/web/src/features/ai-route/model/route-request.ts
index c6944e44..e483932b 100644
--- a/apps/web/src/features/ai-route/model/route-request.ts
+++ b/apps/web/src/features/ai-route/model/route-request.ts
@@ -133,6 +133,60 @@ export const reachedTargetViewport = ({
  */
 export const VIEWPORT_SETTLE_TIMEOUT_MS = 3_000;
 
+/** 대기 사이클 1회의 마감 — 호출부(뷰-레이어 훅)가 ref에 들고 다닌다 */
+export interface SettleDeadline {
+  /** 절대 마감 시각(ms) — 숨은 구간만큼 뒤로 밀린다 */
+  deadlineAt: number;
+  /** 현재 숨김 구간이 시작된 시각. 보이는 중이면 null */
+  hiddenSince: number | null;
+}
+
+/**
+ * 정착 대기의 남은 상한 (codex 리뷰 P2 — §13).
+ *
+ * 대기 이펙트는 `bounds`·`zoom`이 갱신될 때마다 재실행되는데, 그때마다 상한을 처음부터
+ * 다시 재면 사용자가 계속 패닝·줌하는 동안 종결이 **무한히 연기**돼 패널이 로딩에 갇힌다
+ * (D13 "영구 로딩 금지" 위반). 그래서 마감은 사이클당 **한 번만** 정하고(`deadline === null`인
+ * 첫 호출), 이후 재실행은 남은 시간만 돌려받아 그만큼만 다시 스케줄한다. 0이면 즉시 종결이다.
+ *
+ * 다만 마감은 **가시 상태에서 흐른 시간**만 소모한다 (§12) — 숨은 탭은 rAF가 멈춰 지도가
+ * 정착할 수 없으므로 그 구간을 세면 갱신되지 않은 옛 뷰포트로 발사돼 14401을 맞는다.
+ * 숨은 동안 마감을 정지시키는 대신 **복귀 시 숨어 있던 만큼 마감을 뒤로 민다**(같은 결과이고
+ * 상태가 두 값뿐이다). 시각(`now`)과 가시성은 파라미터로 받는다 — 이 모듈은 시계도 `document`도
+ * 모른다(RN 경계).
+ */
+export const advanceSettleDeadline = ({
+  deadline,
+  now,
+  visible,
+  timeoutMs,
+}: {
+  /** 진행 중인 대기의 마감. null이면 이번 호출이 이 사이클의 첫 예약이다 */
+  deadline: SettleDeadline | null;
+  now: number;
+  visible: boolean;
+  timeoutMs: number;
+}): { deadline: SettleDeadline; remainingMs: number } => {
+  const next = ((): SettleDeadline => {
+    if (deadline === null) {
+      return { deadlineAt: now + timeoutMs, hiddenSince: visible ? null : now };
+    }
+    if (!visible) {
+      // 숨김 시작 시각은 첫 관측으로 고정한다 — 재실행이 구간을 잘게 쪼개면 안 된다
+      return deadline.hiddenSince === null
+        ? { ...deadline, hiddenSince: now }
+        : deadline;
+    }
+    if (deadline.hiddenSince === null) return deadline;
+    return {
+      deadlineAt: deadline.deadlineAt + (now - deadline.hiddenSince),
+      hiddenSince: null,
+    };
+  })();
+
+  return { deadline: next, remainingMs: Math.max(0, next.deadlineAt - now) };
+};
+
 /** 제출 버튼 문구 (L13·D9) — 출발지를 실어 보낸 결과 화면만 "현재 위치에서" 접두가 붙는다 */
 export const submitLabel = ({
   status,
diff --git a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx
index aa23867a..dd7c958b 100644
--- a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx
+++ b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx
@@ -13,7 +13,7 @@ import {
 import { MAP_SCALE_1KM_ZOOM } from "@/features/map-home/model/map-scale";
 import { useViewportStore } from "@/features/map-home/model/viewport-store";
 import type { MentionedAreaDto } from "@/shared/api/generated";
-import { envelopeResponse } from "@/test/envelope-response";
+import { envelopeResponse, errorEnvelope } from "@/test/envelope-response";
 import { allowPositionAt, setGeolocation } from "@/test/geolocation";
 import { ROUTE_POINTS } from "@/test/route-points";
 import { stubFetch } from "@/test/stub-fetch";
@@ -100,11 +100,10 @@ const stubBothWithMentionedArea = () =>
   );
 
 /** 렌더 → 현위치 확보 대기 → 제출. 제출 전 줌은 각 시나리오가 세팅한다 */
-const renderAndSubmit = async () => {
-  const rendered = renderHook(
-    () => useAiRouteAutoMove({ onLoginRequired: vi.fn() }),
-    { wrapper },
-  );
+const renderAndSubmit = async (onLoginRequired = vi.fn()) => {
+  const rendered = renderHook(() => useAiRouteAutoMove({ onLoginRequired }), {
+    wrapper,
+  });
 
   await waitFor(() => expect(rendered.result.current.originActive).toBe(true));
   act(() => rendered.result.current.submit());
@@ -113,8 +112,8 @@ const renderAndSubmit = async () => {
 };
 
 /** 제출 → 자동 이동 명령 도착까지 */
-const submitAndAwaitMove = async () => {
-  const rendered = await renderAndSubmit();
+const submitAndAwaitMove = async (onLoginRequired = vi.fn()) => {
+  const rendered = await renderAndSubmit(onLoginRequired);
   await waitFor(() => expect(moveTo).toHaveBeenCalledTimes(1));
 
   return rendered;
@@ -174,6 +173,40 @@ const setVisibility = (state: DocumentVisibilityState) => {
   });
 };
 
+/** 목표(1km)를 벗어난 줌 — 이 줌으로 갱신하는 한 도달 판정은 영영 성립하지 않는다 */
+const OFF_TARGET_ZOOM = 16;
+
+/** 사용자가 지도를 조금씩 미는 상황 — 갱신마다 두 대기 이펙트가 재실행된다 */
+const pannedBounds = (step: number): Bounds => ({
+  sw: { lat: 35.1521 + step * 0.001, lng: 129.0537 + step * 0.001 },
+  ne: { lat: 35.1662 + step * 0.001, lng: 129.0712 + step * 0.001 },
+});
+
+/**
+ * `intervalMs`마다 뷰포트를 갱신하며 `until()`이 참이 될 때까지 기다린다 (§13 P2 재현).
+ * 참이 된 시점까지 걸린 ms를 돌려주고, `times`번 안에 참이 안 되면 Infinity —
+ * 상한이 갱신마다 초기화되면(결함) 영원히 참이 되지 않는다.
+ */
+const panUntil = async ({
+  times,
+  intervalMs = 200,
+  until,
+}: {
+  times: number;
+  intervalMs?: number;
+  until: () => boolean;
+}): Promise<number> => {
+  const startedAt = Date.now();
+  for (let step = 1; step <= times; step += 1) {
+    settleViewport(pannedBounds(step), OFF_TARGET_ZOOM);
+    await act(async () => {
+      await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    });
+    if (until()) return Date.now() - startedAt;
+  }
+  return Number.POSITIVE_INFINITY;
+};
+
 /** 정착 상한을 실제로 넘겨 본다 — 이 훅의 대기는 실타이머 기반이다 */
 const waitPastSettleTimeout = async () => {
   await act(async () => {
@@ -449,3 +482,101 @@ describe("서버 뷰포트 상한 가드와 탭 가시성 (§12 — 14401 재현
     expect(useAiRouteStore.getState().secondaryPending).toBe(false);
   });
 });
+
+describe("codex 리뷰 반영 — 2차 인증 처리와 대기 마감 (§13)", () => {
+  /** 1차는 이동 신호, 2차는 세션 만료 — 1차 성공과 지연된 2차 사이에 세션이 끊긴 경우 */
+  const stubSecondaryUnauthorized = () => {
+    let call = 0;
+    return stubFetch(() => {
+      call += 1;
+      return call === 1
+        ? envelopeResponse({
+            points: ROUTE_POINTS,
+            notice: null,
+            mentionedArea: MENTIONED_AREA,
+          })
+        : errorEnvelope(2403, "인증이 필요합니다", 401);
+    });
+  };
+
+  it("2차가 401이면 1차와 똑같이 로그인 모달 콜백이 호출된다 (§13 P1)", async () => {
+    const received = stubSecondaryUnauthorized();
+    const onLoginRequired = vi.fn();
+
+    await submitAndAwaitMove(onLoginRequired);
+    settleNewViewport();
+
+    await waitFor(() => expect(received).toHaveLength(2));
+    await waitFor(() => expect(onLoginRequired).toHaveBeenCalledTimes(1));
+    // 로그인 필요는 에러 화면 없이 입력 대기로 돌아간다 (§1-3)
+    expect(useAiRouteStore.getState().status).toBe("idle");
+  });
+
+  it("정규화 대기 중 뷰포트가 반복 갱신돼도 최초 예약 상한 안에 종결한다 (§13 P2 — D13)", async () => {
+    const received = stubBothWithMentionedArea();
+    useViewportStore.setState({
+      bounds: BOUNDS_BEFORE,
+      zoom: OFF_TARGET_ZOOM,
+    });
+
+    await renderAndSubmit();
+    expect(received).toHaveLength(0);
+
+    // 사용자가 계속 패닝한다 — 갱신마다 상한을 다시 재면 요청이 영영 안 나간다
+    const elapsed = await panUntil({
+      times: 30,
+      until: () => received.length > 0,
+    });
+
+    expect(elapsed).toBeLessThan(VIEWPORT_SETTLE_TIMEOUT_MS + 1_500);
+    expect(useAiRouteStore.getState().normalizePending).toBe(false);
+  }, 20_000);
+
+  it("2차 대기 중 뷰포트가 반복 갱신돼도 최초 예약 상한 안에 종결한다 (§13 P2 — D13)", async () => {
+    const received = stubBothWithMentionedArea();
+
+    await submitAndAwaitMove();
+    act(() =>
+      useAiRouteStore.setState({
+        requestedAt: Date.now() - SECONDARY_MIN_INTERVAL_MS,
+      }),
+    );
+
+    const elapsed = await panUntil({
+      times: 30,
+      until: () => received.length > 1,
+    });
+
+    expect(elapsed).toBeLessThan(VIEWPORT_SETTLE_TIMEOUT_MS + 1_500);
+    expect(useAiRouteStore.getState().secondaryPending).toBe(false);
+  }, 20_000);
+
+  it("숨은 구간은 마감에서 제외되고 복귀 후 남은 시간만 기다린다 (§13 P2 + §12 가시성)", async () => {
+    const received = stubBothWithMentionedArea();
+    useViewportStore.setState({
+      bounds: BOUNDS_BEFORE,
+      zoom: OFF_TARGET_ZOOM,
+    });
+
+    await renderAndSubmit();
+
+    // ① 가시 상태로 상한의 절반가량을 소모한다 (약 1.7초)
+    expect(await panUntil({ times: 8, until: () => received.length > 0 })).toBe(
+      Number.POSITIVE_INFINITY,
+    );
+
+    // ② 숨은 동안에는 지도가 정착하지 못하므로 마감이 흐르지 않는다 (§12)
+    setVisibility("hidden");
+    await panUntil({ times: 12, until: () => received.length > 0 });
+    expect(received).toHaveLength(0);
+
+    // ③ 복귀 후에는 **남은 시간만** 기다린다 — 상한을 처음부터 다시 재면 3초가 걸린다
+    setVisibility("visible");
+    const afterReturn = await panUntil({
+      times: 20,
+      until: () => received.length > 0,
+    });
+
+    expect(afterReturn).toBeLessThan(2_200);
+  }, 30_000);
+});
diff --git a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts
index c7ea31c0..8c8f5383 100644
--- a/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts
+++ b/apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts
@@ -7,7 +7,9 @@ import { VIEWPORT_TOO_WIDE_NOTICE } from "@/features/ai-route/model/route-error"
 import { resolveRouteOrigin } from "@/features/ai-route/model/route-origin";
 import {
   MAX_VIEWPORT_SPAN_DEG,
+  type SettleDeadline,
   VIEWPORT_SETTLE_TIMEOUT_MS,
+  advanceSettleDeadline,
   buildRecommendBody,
   exceedsViewportSpan,
   needsZoomNormalize,
@@ -34,6 +36,9 @@ import { useMapShell } from "@/widgets/map-shell/use-map-shell";
  *
  * 두 대기(정규화·2차) 모두 **반드시 종결한다** — 목표 도달 판정이 성립하지 않는 경로에서도
  * `VIEWPORT_SETTLE_TIMEOUT_MS` 뒤에는 현재 뷰포트로 보낸다. 패널이 로딩에 갇히면 안 된다 (D13).
+ * 그 상한은 **대기 사이클당 절대 마감 한 번**이다(`advanceSettleDeadline`) — 이펙트가
+ * 뷰포트 갱신마다 재실행돼도 남은 시간만 다시 잴 뿐이라, 사용자가 계속 패닝해도 종결이
+ * 밀리지 않는다. 단 마감은 가시 구간만 소모한다 (§13·§12).
  * 단 그 출구가 **서버 상한을 넘는 뷰포트를 쏘면 확정 400(14401)** 이라, 발사는 전부
  * `send()` 하나를 거치고 상한을 넘으면 보내는 대신 안내로 종결한다 (§12).
  * 결과 상태에서는 두 대기 플래그가 모두 꺼져 있어 뷰포트가 바뀌어도 요청이 나가지 않는다 (D14·L25).
@@ -79,6 +84,38 @@ const useDocumentVisible = (): boolean => {
   return visible;
 };
 
+/**
+ * 대기 사이클 1회의 정착 마감을 들고 있는다 (§13) — 판정은 `advanceSettleDeadline`이 소유하고
+ * 여기에는 ref 보관과 시계(`Date.now`) 주입만 남는다.
+ *
+ * `remainingMs`는 이펙트가 재실행될 때마다 호출된다: 첫 호출이 마감을 정하고 이후에는 남은
+ * 시간만 돌려주므로, 뷰포트가 아무리 자주 갱신돼도 종결이 밀리지 않는다. 대기가 끝나면
+ * (예약 플래그가 내려가면) `reset()`으로 다음 사이클에 새 상한을 준다.
+ */
+const useSettleDeadline = (visible: boolean) => {
+  const deadlineRef = useRef<SettleDeadline | null>(null);
+
+  const remainingMs = useCallback(
+    (now: number): number => {
+      const advanced = advanceSettleDeadline({
+        deadline: deadlineRef.current,
+        now,
+        visible,
+        timeoutMs: VIEWPORT_SETTLE_TIMEOUT_MS,
+      });
+      deadlineRef.current = advanced.deadline;
+      return advanced.remainingMs;
+    },
+    [visible],
+  );
+
+  const reset = useCallback(() => {
+    deadlineRef.current = null;
+  }, []);
+
+  return { remainingMs, reset };
+};
+
 interface AiRouteAutoMove {
   /** 제출 — 축척이 1km 단이 아니면 줌을 먼저 맞추고 새 뷰포트가 반영된 뒤 보낸다 (D10) */
   submit: () => void;
@@ -102,6 +139,11 @@ export const useAiRouteAutoMove = ({
   const abortPending = useAiRouteStore((s) => s.abortPending);
 
   const visible = useDocumentVisible();
+  // 두 대기는 각자의 마감을 갖는다 — 사이클이 겹치지 않아도 상한이 서로 섞이면 안 된다
+  const { remainingMs: normalizeRemainingMs, reset: resetNormalizeDeadline } =
+    useSettleDeadline(visible);
+  const { remainingMs: secondaryRemainingMs, reset: resetSecondaryDeadline } =
+    useSettleDeadline(visible);
   const coords = useCurrentCoords();
   const origin = useMemo(
     () => resolveRouteOrigin({ coords, bounds }),
@@ -125,7 +167,13 @@ export const useAiRouteAutoMove = ({
     onLoginRequired,
     onAutoMove,
   });
-  const { mutate: sendSecondary } = useRouteRecommend({ secondary: true });
+  // 1차와 같은 인증 처리를 붙인다 — 1차 성공과 지연된 2차(서버 10초 창) 사이에 세션이
+  // 만료되면 2차가 401을 받는데, 콜백이 없으면 패널만 입력 대기로 돌아가고 로그인 모달이
+  // 뜨지 않는다(codex 리뷰 P1 — 사용자는 왜 결과가 사라졌는지 알 수 없다).
+  const { mutate: sendSecondary } = useRouteRecommend({
+    secondary: true,
+    onLoginRequired,
+  });
 
   /**
    * 이 훅의 **유일한 발사 지점** — 어떤 경로(즉시·정규화 대기·2차·상한 만료)로 와도
@@ -163,7 +211,10 @@ export const useAiRouteAutoMove = ({
   }, [zoom, zoomTo, startNormalize, send, sendPrimary]);
 
   useEffect(() => {
-    if (!normalizePending) return;
+    if (!normalizePending) {
+      resetNormalizeDeadline();
+      return;
+    }
 
     // 예약이 이미 소비됐으면 쏘지 않는다 — StrictMode(dev)의 이펙트 2회 실행 방어.
     // 첫 실행의 `onMutate`(startRequest)가 플래그를 끄므로 두 번째 실행은 여기서 멈춘다 (L22).
@@ -177,15 +228,34 @@ export const useAiRouteAutoMove = ({
       fire();
       return;
     }
-    // 숨은 탭에서는 지도가 정착하지 않는다 — 상한을 소모하지 않고 복귀 시 다시 잰다 (§12)
+    // 대기 중 사용자가 줌을 되돌리면 목표에 영영 닿지 않는다 — 상한을 두고 종결한다 (D13).
+    // 마감은 이 사이클에서 한 번만 서고, 재실행은 **남은 시간만** 다시 잰다 (§13).
+    const remaining = normalizeRemainingMs(Date.now());
+    // 숨은 탭에서는 지도가 정착하지 않는다 — 그 구간은 마감에서 빠진다 (§12)
     if (!visible) return;
-    // 대기 중 사용자가 줌을 되돌리면 목표에 영영 닿지 않는다 — 상한을 두고 종결한다 (D13)
-    const timer = setTimeout(fire, VIEWPORT_SETTLE_TIMEOUT_MS);
+    if (remaining <= 0) {
+      fire();
+      return;
+    }
+    const timer = setTimeout(fire, remaining);
     return () => clearTimeout(timer);
-  }, [normalizePending, zoom, visible, send, sendPrimary, abortPending]);
+  }, [
+    normalizePending,
+    zoom,
+    visible,
+    send,
+    sendPrimary,
+    abortPending,
+    normalizeRemainingMs,
+    resetNormalizeDeadline,
+  ]);
 
   useEffect(() => {
-    if (!secondaryPending || bounds === null) return;
+    if (!secondaryPending) {
+      resetSecondaryDeadline();
+      return;
+    }
+    if (bounds === null) return;
 
     // 예약 소비 여부는 스토어가 정본이다 — 위 정규화 이펙트와 같은 StrictMode 방어
     const fire = () => {
@@ -202,18 +272,27 @@ export const useAiRouteAutoMove = ({
     });
     // 서버 재요청 제한(14429)은 자동 재요청도 예외가 아니다 — 남은 창만큼 로딩을 유지한다 (Q2)
     const delay = secondaryDelayMs({ requestedAt, now: Date.now() });
-    if (reached && delay <= 0) {
+    // 이미 도달했으면 남은 것은 서버 10초 창뿐이다 — 지도와 무관하므로 숨은 채로도 계속 잰다 (§12)
+    if (reached) {
+      if (delay <= 0) {
+        fire();
+        return;
+      }
+      const windowTimer = setTimeout(fire, delay);
+      return () => clearTimeout(windowTimer);
+    }
+    // 도달 실패 경로에서도 마감이 지나면 현재 뷰포트로 1회 보낸다 — 영구 로딩 금지 (D13·L24).
+    // 마감은 이 사이클에서 한 번만 서고 재실행은 남은 시간만 잰다 — 갱신마다 다시 재면
+    // 사용자가 계속 지도를 만지는 동안 2차가 무한히 연기된다 (§13).
+    const remaining = secondaryRemainingMs(Date.now());
+    // 도달 대기 중 탭이 숨으면 지도가 정착하지 않는다 — 그 구간은 마감에서 빠진다 (§12)
+    if (!visible) return;
+    const wait = Math.max(delay, remaining);
+    if (wait <= 0) {
       fire();
       return;
     }
-    // 도달 대기 중 탭이 숨으면 지도가 정착하지 않는다 — 상한을 소모하지 않는다 (§12).
-    // 이미 도달했으면 남은 것은 서버 10초 창뿐이라 숨은 채로도 계속 잰다.
-    if (!reached && !visible) return;
-    // 도달 실패 경로에서도 창 경과 후에는 현재 뷰포트로 1회 보낸다 — 영구 로딩 금지 (D13·L24)
-    const timer = setTimeout(
-      fire,
-      reached ? delay : Math.max(delay, VIEWPORT_SETTLE_TIMEOUT_MS),
-    );
+    const timer = setTimeout(fire, wait);
     // 재제출·언마운트·뷰포트 재갱신 시 예약을 취소한다 (Q2 — 대기 중 이탈)
     return () => clearTimeout(timer);
   }, [
@@ -225,6 +304,8 @@ export const useAiRouteAutoMove = ({
     send,
     sendSecondary,
     abortPending,
+    secondaryRemainingMs,
+    resetSecondaryDeadline,
   ]);
 
   return { submit, originActive: origin !== null };
diff --git a/docs/STATUS.md b/docs/STATUS.md
index 0b5e1e65..5e0eea74 100644
--- a/docs/STATUS.md
+++ b/docs/STATUS.md
@@ -162,4 +162,4 @@
 - MSG-475: [웹] 줌아웃 행정 단위 집계 마커 리디자인 + 핫구역 행정 단위 집계 신설 — ① 원형 3단(size-17/20/23 + `border-3 border-background` 흰 링) 마커를 Figma `15221:20097` **말풍선**으로 교체: 라운드 10·패딩 6/12/7·링 없음·`shadow-raised`·2줄(지역명 `text-fm-label` 백 85% / 개수 `text-fm-heading font-bold` 백), 채움은 Figma 정확 일치 토큰 **`bg-secondary`**(#0071E3 — 종전 `bg-primary` #0066CC에서 이동). `CLUSTER_UNIT_SIZE_CLASS` 삭제로 **단위별 크기 3단이 사라지고** 폭만 지명 길이에 hug된다(브라우저 실측 DONG 63×48·SIGUNGU 66×48 — 높이 동일). ② 축제·팝업 칩 활성 중에는 같은 마크업에 채움만 `bg-theme-festival`/`bg-theme-popup`으로 갈린다(MSG-451 ① 규칙 — 새 색·타이포 토큰 0, `design-tokens` diff 0). ③ **핫구역 칩 저줌 집계 신설** — `use-hotzone-aggregation-query`(`GET /api/hotzones/aggregation`, BE MSG-466)를 미션 집계와 같은 축척 표·같은 상한(동 1°·구 4°·시 10° `clampBoundsToSpan`)·같은 bbox 정본(**뷰포트** — 저줌엔 "장소 불러오기"가 없어 확정 영역으로는 갱신 수단이 없다)으로 배선하고, `toHotZoneClusterMarkers`(접두 `hot-{unit}-{regionCode}`, `theme: "hot"`)로 붉은 말풍선을 띄운다. **인증 게이트 없음**(사용자별 값 없음 — MSG-463 익명 선례). `occupancy-visibility.hotCellsVisible` 신설 + `use-home-overlays` 배선으로 저줌에서 개별 핫 격자를 걷어 마커와 상호 배타를 만든다(종전엔 `gateFillCells`가 색 있는 테마 셀을 저줌에도 남겨 점으로 뭉개졌다). 집계 소스는 **칩 기준 택일**(핫 / 축제·팝업 / 칩 없음+로그인 도감) — 두 종류가 한 지도에 서지 않는다. ④ **`gridIds` 교집합 좁힘은 승인 결정으로 미구현** — 시/구 클릭은 여전히 집계 구간에 내리고 DONG 클릭 후 패널은 이미 확정 행정동으로 걸러지는데 서버가 집계·개별의 판정 집합 동일을 보장해 효과가 null 버킷뿐이다(MSG-451 `missionIds` 후속 미룸과 같은 처리). ⑤ `MARKER_MERGE_PX`(68/80/92)는 **값 불변**(주석만 갱신) — 말풍선(약 61×49, 폭 가변)과 근거가 어긋나지만 모바일 parity 테스트가 리터럴로 고정하고 RN 렌더가 원 지름으로 소비한다. 재보정은 RN 렌더 교체 티켓과 함께. **명세 재생성 안 함** — `getHotZoneAggregates`·`HotZoneRegionAggregateResponseDto`가 MSG-445 스냅샷에 이미 들어와 있었다(티켓 [참고]의 "로컬 스냅샷에 없음"이 스테일). 생성물 4파일 diff 0줄로 병렬 MSG-474와의 충돌 창을 닫았다. **`apps/mobile` diff 0줄** — 웹 `region-cluster-overlay` 변경을 타입 확장·함수 신설의 **추가만**으로 묶어 parity 3종이 모바일 무수정 통과(신규 필드는 `theme`처럼 조건부 스프레드라야 `toEqual`이 안 깨진다). **모바일 화면은 이 티켓 후 두 가지가 벌어진다** — 마커 형태(원형 3단 vs 말풍선)와 핫 칩 저줌 표시(모바일은 격자 낱개 유지, 집계 훅 없음): 별도 [모바일] 티켓 몫. 검증 실측: 브라우저 계산 스타일 전건 일치·칩 5상태 택일·드릴다운 줌 2건·**AC 13 정합(부전2동 마커 1 = 격자 줌 붉은 셀 1)**·콘솔 에러 0, e2e `cluster-zoom-gate` 무수정 2/2, 웹 1289+모바일 982 전건. 확인불가 1건 — 미판정 버킷(`regionCode` null)이 실데이터에 0건(전국 SIDO 프로브 실측)이라 단위 테스트로 대체. nose 신규 9패밀리(신설 훅·테스트 ↔ 도감·미션 형제) baseline 등재 — 3형제 훅은 게이트 조건·envelope·placeholder 정책이 9개 지점에서 갈려 공통 추출이 부적합(nose 자신의 9파라미터 판정, MSG-476 선례). **등재 시 무관 흡수 1건(`profile-edit-modal.smoke` ↔ `envelope-response` — develop에도 있던 hidden 패밀리)을 되돌렸다**(MSG-476 교훈). 참고: 흰 글자 대비가 hot 3.6:1·popup 2.2:1로 WCAG 미달이나 MSG-451부터 승계된 테마 토큰 규칙이자 Figma 정본 값 — 디자인 차원 후속 거리.
 - MSG-474: 비로그인 지도 홈 개방 — QA 3건(최초 진입 로그인 안내만 뜸 / "장소 불러오기" 미작동 / 칩 최근접 이동 안 됨)의 뿌리는 하나였다: 역지오코딩이 비로그인에서 게이트돼 **확정(commit)이 영영 생기지 않음** → `committedBounds`가 부트스트랩 초기 뷰포트에 고정 → 칩 bbox가 좁고 `currentRegion` null이라 불러오기 버튼 미생성. 티켓이 지목한 `use-nearest-entry`는 무관했다(그 훅의 center는 `viewportCenter`라 비로그인에도 null 아님). **게이트 해제 3곳**(`MapHomePage`·`RegionPanel`·`use-committed-region` — 마지막은 티켓 미기재였으나 최초 확정의 실제 소스)으로 3건이 함께 풀렸고 `use-chip-entry`·`use-nearest-entry`·`region-reload`는 **무수정** 회귀 통과. ① `RegionPanel` 로그인 유도 분기 통삭제 → 헤더·격자 카드·"전체 보기"·전체 지역 무한 스크롤이 비로그인에도 열린다(**MSG-463 확정 1을 뒤집음** — 당시 근거 "데이터원이 로그인 전용"이 explore 익명 200으로 소멸, 사용자 승인). ② 비로그인 격자 상세는 `grids/{gridId}`(응답이 occupied·내 영상 수 = 사용자별이라 익명 401이 **설계상 정상**)를 부르지 않고 **진입점 응답의 이름 재료로 조립** — `deriveHomeCellDetail`을 `viewerAuthenticated` 판별식 유니언(로그인=cell 필수 / 비로그인=entryNaming 필수)으로 확장, 비로그인은 subtitle null·"내 점령" 배지 없음. ③ 인증 **true→false 전이**에서 `QueryProvider` 한 곳이 `queryClient.clear()` — 티켓의 "쿼리 키에 인증 반영"은 생성 키에 인증 축이 없고 로그인은 이미 clear 중(로그아웃만 누락)이라 키 확장 10곳+ 대신 전이 구독 1곳을 택했다. ④ **스펙 인벤토리 밖 401 경로 2건을 구현 중 발견·차단**: `use-grid-names-query`(코스 스팟 이름 = `grids/{id}` N회)·dex `use-region-videos-query`(`collections/videos` — 비로그인 확정 지역이 생기며 처음 활성화). **실측이 범위를 두 번 바꿨다**: 티켓의 "BE 선행 전부 배포 확인"과 달리 1차 익명 curl에서 `regions/{code}/grids`·`videos/{id}`·`explore`가 401(요구 2·5·재생 블로커) → 사용자가 권한 재배포 → 2차 실측 200으로 요구 5건 전부 성립. **`api:generate` 미실행** — 라이브 `/v3/api-docs`와 레포 스냅샷이 **바이트 동일**(권한만 열리고 계약 무변경)이라 생성물 4파일 diff 0, MSG-475와의 충돌 우려도 소멸(구현 중 발견된 생성물 재생성분은 `FriendPreviewResponseDto.relation`=MSG-391 친구 기능으로 무관 → HEAD 복원). **AC 14(최종 방어선) 통과**: 비로그인 전 과정(진입→전체 보기→이동→불러오기→칩 3종→격자 상세→코스 상세→재생) `/api/` 실호출 전건 200·**401 0건·reissue 0건**·금지 7종 0건. **재작업 1회차**: ① 모바일 `home-cell-detail.parity.test.ts`가 웹 파생 함수를 구 시그니처로 동적 import해 깨짐 — 빌더가 `--filter web`만 돌려 놓쳤고 루트 게이트가 잡았다(**MSG-476과 동일 재발** — 웹 파생 함수를 바꾸는 티켓은 모바일 패리티 앵커를 먼저 조회할 것), 타입까지 새 계약에 묶어 다음 드리프트를 typecheck가 잡게 함 ② e2e `consent-gate-popstate`가 익명 렌더 증거로 삭제 대상인 "로그인" 버튼을 단정 → 확정 행정동 heading으로 교체(게이트 본래 단정 무변경) ③ nose 신규 6패밀리 개별 검토 후 추출 대상 0건 판정·베이스라인 재등재. **BE 환류 2건**: 코스 스팟(`CourseSpotDto`)이 좌표만 줘 비로그인 코스 스팟 상세에 행정동 줄 없음(AC 11 부분, FE로 메울 수 없음) · dev 재생 미디어가 S3 키를 `https%3A//dev.local/seed/….m3u8`로 저장해 403(AC 12 프레임 미표시 — FE 계약은 성립, 시드 데이터 결함). 확인불가 2건은 로그인 상태 브라우저 회귀(카카오 세션 부재, MSG-463 선례)
 - MSG-488: [웹] AI 경로추천 페이지 신설 (`/ai-route`) — 자연어 문장 → `POST /api/routes/recommend` → 좌측 388px 패널 카드 리스트 + 지도 오버레이(번호 마커·격자 초록 틴트·이웃 직선). **라우트명은 티켓 가칭 `/route`에서 `/ai-route`로 변경**(사용자 승인) — 코드베이스에 `route`가 이미 3중 의미(`ROUTES` react-router 상수 · `ThemeId "route"` = 기존 코스 칩 "경로추천"으로 같은 초록 `theme-route`까지 공유 · `map-overlay-store.routes`)라 동음이의를 피했다. **로그인 전용** — 2026-08-28 익명 POST 실측이 `401 {developCode:2403}`이라 `RequireAuth` + 레일 항목 비로그인 클릭 시 `login-modal-store` 게이트. **결과 도착 시 지도를 이동·확대하지 않는다**(카드 클릭만 `moveTo`, 줌 불변) — 사용자가 보던 범위를 뺏지 않는 것이 이 티켓의 계약이고, 자동 이동은 MSG-489 몫. **재사용 성과: 신규 렌더 코드가 거의 없다** — `map-overlay-store`에 이미 `routes`(폴리라인 + 번호 경유지)·`cells`(색·빗금) 슬롯이 있어 MapShell→MapCanvas 렌더 경로를 통째로 썼고, MapCanvas 추가분은 경유지 `onClick` 슬롯 + `active` 강조뿐(`onRouteWaypointClick` 미제공이면 기존 코스 마커는 비클릭 그대로). 오버레이 파생은 순수 함수 `route-overlay.ts`에 두어 RN 경계 유지(`features/`·`model/`에 `naver` import 0건). 승격 2건: ui-web **`Skeleton`** 신설(레포 첫 스켈레톤 — 착수 전제였던 "GalleryTabBody가 첫 사용처"는 실측 오류였다. `GallerySkeleton`은 `DotsLoader` 래퍼이고 MSG-403이 의도적으로 도트로 통일한 자리라 미접촉), **`RetryNotice`**를 `pages/map-home/ui/` → ui-web 이동(재사용 시 pages→pages import가 되므로 — 소비 8파일은 import 한 줄씩만 변경). 마커 스타일은 Figma 정본(28px `size-7` + `border-2 border-background` + `shadow-raised`)으로 갱신했고 `routeMarkerContent` 공유상 **기존 코스 칩 경유지 마커도 함께 바뀌는 것을 사용자가 승인**(두 마커가 같은 초록이라 통일이 낫다는 판단 — `markerStyle` 분기 미생성). 결과 부족 배너는 **FE 고정 문구**이고 서버 `notice`는 null 여부 신호로만 쓴다(문자열 미노출을 `not.toContain`으로 고정), 0곳이면 카드·오버레이 없이 배너만. **웨이브 2 병렬 머지를 위해 파일 소유권을 설계 산출물로 명시**(정본 `docs/spec/MSG-488.md` §4-2): 489(상태·요청·입력카드 계열)와 490(구간거리·오버레이 기하·walk-paths 계열)의 **교차 파일 0건**, 공유 파일 `AiRoutePage.tsx`도 489만 2줄·490은 0줄, 셸·렌더·라우트·레일·ui-web은 488이 완결(둘 다 0줄). 확장점 주석 3종을 지정 위치에 심었고 489·490 신규 예정 파일은 하나도 만들지 않았다. **검증 실측**: 남아 있던 리프레시 쿠키로 실계정 자동 재발급이 돼 **실 API 8곳 응답**으로 브라우저 검증 — 지도 미이동(축척바 100m 불변) · 8→3→2→0곳 4회 연속 갱신 잔상 0 · 도감 왕복 후 복원 + **재요청 0회** · 실패 7경로 전건 · Figma 4프레임 오탐 목록 밖 편차 0 · 콘솔 에러 0. 확인불가 1건 — 빗금(점령 격자 교집합)이 실데이터에 발생하지 않아 육안 불가, 단위 테스트로 대체. a11y 지적 1건 즉시 반영: `RouteResultHeader`(`role="status"`)가 자체 `role="status"`를 가진 `DotsLoader`를 감싸 낭독이 실제로 중복돼(`"동선 찾는 중 동선 찾는 중"`) 도트를 `aria-hidden`으로 감쌌다(ui-web 무수정). **nose 중복 게이트는 착수 전부터 red**였고 근원이 이 티켓 자신의 웨이브 0 openapi 커밋(`107aa59`)이라 재등재했다 — 검증자가 `git archive HEAD`로 워크트리 밖에 풀어 재현해 HEAD 시점 3패밀리가 빌더 지목 id와 일치함을 독립 확인(숨어든 진짜 중복 0). **알려진 한계**: `gateFillCells`가 `zoom < 16`에서 채움 셀을 버려 넓게 본 상태에서 요청하면 격자 초록 틴트가 안 보인다(마커·선은 남음) — MSG-489의 1km 축척 고정이 해소한다. **489 선행 경고**: "지도 위 현재 위치 점"을 그릴 슬롯이 `MapCanvasProps`에 없어(`MapLabelOverlay`는 텍스트 pill, `waypoints`는 번호 뱃지) 489가 "488 완결·489 0줄"로 선언된 `MapCanvas.tsx`를 다시 열 공산이 크다 — 489∥490 병렬성 자체는 안 깨진다. **스펙 각주 누락 1건**: Figma 결과·결과 부족 프레임 양쪽에 "축제, 팝업, 코스, 행사 정보와…" 각주가 있는데 스펙은 로딩 화면에만 기재 — 디자인 정본을 따라 양쪽에 렌더.
-- MSG-489: [웹] AI 경로추천 — `mentionedArea` 자동 이동·1km 축척 고정·2차 자동 재요청·출발지(origin) 자동 판정. **웨이브 2 = 490(walk-paths)과 동시 진행** — `docs/spec/MSG-488.md` §4-2 소유권 표의 489열만 접촉, 접촉 금지 15경로 diff 0줄(검증자 감사), `MapCanvas.tsx` 0줄(현재 위치 점은 **Figma 12402·13139에 노드가 없어 제외** — 488의 "489가 MapCanvas를 다시 열 공산" 경고는 디자인 근거가 없었다). **착수 전 실측 2건이 설계를 결정했다**: ① 2차 자동 재요청은 서버 10초 rate limit **예외가 아니다**(로그인 세션 연속 호출 → 두 번째 `429/14429`, 1차 요청 시작 +11s는 200, `Retry-After` 없음) → 1차 `requestedAt` 기준 `10.5s` 잔여 대기 후 발사, 대기·2차 중 패널은 로딩·1차 결과 미게시, 2차 mentionedArea 무시(1회 한정), 2차 14429면 기존 에러 매핑. 브라우저 실측 간격 11,174ms·recommend 정확히 2회. ② `shared/geolocation.getCurrentPosition()`이 **권한 거부를 삼키고 서면 좌표를 돌려줘** 거부 사용자에게도 origin이 전송되는 오판정 → 가산 export `getCurrentPositionOrNull`(사용자 승인, 기존 소비 3곳 무수정). **488 "알려진 한계" 정정**: `gateFillCells`는 `zoom<16`에서 *색 있는 셀을 남기는* 필터이고 AI 경로 셀은 전부 `theme-route` 색이라 게이트를 **통과한다**(zoom 13에서 폴리곤 8개 DOM 실측, `fill=#34C759`) — 다만 1km 축척에선 셀이 6~7px이라 28px 마커에 가려 육안으로는 안 보인다. "1km 고정이 해소한다"는 서술은 성립하지 않으며 이는 홈과 동일한 저줌 공통 동작으로 수용(`MAP_SCALE_1KM_ZOOM`=13 < `GRID_MIN_ZOOM`=16). **설계 결정**: 제출·정규화·측위·이동·2차 예약을 훅 하나(`use-ai-route-auto-move`)가 소유해 `AiRoutePage.tsx`가 스펙 "2줄" 상한을 -w 기준 +14/−12로 넘겼다(제출 로직 7줄이 페이지에서 빠짐 — 490은 이 파일 0줄이라 병렬성 불변); 2차 발사는 `bounds` **참조 변경** AND 시간 경과 두 조건(이동 직후 즉시 쏘면 옛 bounds, `ZOOM_OUT`은 중심이 옛 뷰포트 안이라 중심 판정만으론 못 막음); 예약 플래그를 스토어에 둬 대기 중 섹션 이탈·StrictMode 2회 실행에서도 영구 로딩·중복 발사 없음; 토스트 조사는 받침 판정 순수 함수("서면으로", ㄹ 받침 예외 포함). 0.5도 예방(뷰포트 한 변 >0.5°면 중심 기준 1km로 먼저 맞추고 요청, 토스트 없음) 실측: span 0.7° 제출 → 요청 1회·14401 없음 — **이 규칙은 아래 §11 후속 변경에서 폐기됐다(현재는 항상 1km 정규화)**. ui-web `Toast` dark가 Figma 15675:3267과 1:1이라 승격 0건, Figma 편차 0(computed style 실측). **검증 실측**: 수용 기준 28개(L19+S9) 전건 통과·확인불가 0, Chrome 위치 권한 granted + 실좌표가 서면 안이라 S1 "안 → 표시"를 브라우저에서 직접 판정, 토스트 3초 소멸, 2차 로딩 전 구간 1차 잔상 0, 콘솔 0. 중복 게이트 재등재 +11/−6 전부 489 변경 파일 포함(무관 흡수 0), `setGeolocation` 3복제는 `src/test/geolocation.ts`로 추출. **후속 변경(2026-08-29, 승인 — 스펙 §11)**: 사용자 지시로 **제출 시 항상 1km 정규화**로 바꾸고 0.5도 규칙(A2·`needsSpanNormalize`·`MAX_VIEWPORT_SPAN_DEG`·L12)을 **폐기**했다 — 항상 1km면 서버 상한 14401이 구조적으로 불가능해 0.5도 판정이 죽은 조건이 된다. 이미 1km면 줌 명령을 내지 않는다(같은 값으로 `zoomTo`하면 `idle`이 안 와 요청이 영영 안 나간다). 정규화 대기에도 로딩을 켜되(`startNormalize`) `requestedAt`은 **mutate 시점**에만 찍는다(대기가 10초 창을 먹으면 2차가 조기 발사돼 14429). 2차 발사 조건은 `bounds` 참조 변경 → **목표 뷰포트 도달**(`reachedTargetViewport` — 참조 변경 AND 줌이 목표 단)로 좁혀 진행 중 지도 조작이 2차를 오염시키지 않게 했고, **지도 잠금은 하지 않는다**(사용자 결정 — ui-web·MapShell·MapCanvas 계속 0줄). 좁힌 대가인 "목표를 영영 벗어나는" 경로는 두 대기 모두 `VIEWPORT_SETTLE_TIMEOUT_MS`=3s 상한으로 종결시켜 **영구 로딩을 테스트로 금지**(L22·L24). 결과 상태에서는 뷰포트가 바뀌어도 recommend가 안 나가 자유 확대 가능(L25 회귀 고정 — 1km에서 셀 6~7px이라 육안 미식별이던 지점이 여기서 해소). 접촉 파일 7개(+`nose.baseline.json`), `AiRoutePage.tsx` 0줄, 490 소유 파일 0줄. **재작업 1회차(2026-08-29 §12)**: 검증이 백그라운드 탭 경로에서 **14401 재현**을 잡았다 — 숨은 탭은 rAF가 멈춰 `idle`이 안 오는데 3s 상한이 옛 뷰포트(1.94°×4.75°)로 발사했다. §11이 지웠던 서버 상한 판정을 **발사 직전 최종 가드**(`exceedsViewportSpan`)로 되살려 `send()` 한 곳에서 막고, 못 보내면 `abortPending`으로 **에러 안내 종결**(영구 로딩·확정 400 둘 다 금지), 숨은 탭에서는 상한 타이머를 걸지 않는다. §11 D10의 "항상 1km면 14401 구조적 불가능" 서술은 정정됐다(정상 경로 한정). 상한 3s는 실측(줌 전이 269~729ms) 근거로 유지. **같은 회차에 사용자 지시로 `/ai-route`에서 다른 섹션 집계 클러스터 마커를 숨겼다** — `MapShell.tsx`는 MSG-488이 완결 선언한 파일이나 사용자 명시 지시이고 490도 0줄이라 병렬 충돌 없음(예외 기록). **잔여 후속 후보**: 2차 인스턴스에 `onLoginRequired` 미부착(1차 성공 직후 세션 만료 경로는 수용 기준 밖).
+- MSG-489: [웹] AI 경로추천 — `mentionedArea` 자동 이동·1km 축척 고정·2차 자동 재요청·출발지(origin) 자동 판정. **웨이브 2 = 490(walk-paths)과 동시 진행** — `docs/spec/MSG-488.md` §4-2 소유권 표의 489열만 접촉, 접촉 금지 15경로 diff 0줄(검증자 감사), `MapCanvas.tsx` 0줄(현재 위치 점은 **Figma 12402·13139에 노드가 없어 제외** — 488의 "489가 MapCanvas를 다시 열 공산" 경고는 디자인 근거가 없었다). **착수 전 실측 2건이 설계를 결정했다**: ① 2차 자동 재요청은 서버 10초 rate limit **예외가 아니다**(로그인 세션 연속 호출 → 두 번째 `429/14429`, 1차 요청 시작 +11s는 200, `Retry-After` 없음) → 1차 `requestedAt` 기준 `10.5s` 잔여 대기 후 발사, 대기·2차 중 패널은 로딩·1차 결과 미게시, 2차 mentionedArea 무시(1회 한정), 2차 14429면 기존 에러 매핑. 브라우저 실측 간격 11,174ms·recommend 정확히 2회. ② `shared/geolocation.getCurrentPosition()`이 **권한 거부를 삼키고 서면 좌표를 돌려줘** 거부 사용자에게도 origin이 전송되는 오판정 → 가산 export `getCurrentPositionOrNull`(사용자 승인, 기존 소비 3곳 무수정). **488 "알려진 한계" 정정**: `gateFillCells`는 `zoom<16`에서 *색 있는 셀을 남기는* 필터이고 AI 경로 셀은 전부 `theme-route` 색이라 게이트를 **통과한다**(zoom 13에서 폴리곤 8개 DOM 실측, `fill=#34C759`) — 다만 1km 축척에선 셀이 6~7px이라 28px 마커에 가려 육안으로는 안 보인다. "1km 고정이 해소한다"는 서술은 성립하지 않으며 이는 홈과 동일한 저줌 공통 동작으로 수용(`MAP_SCALE_1KM_ZOOM`=13 < `GRID_MIN_ZOOM`=16). **설계 결정**: 제출·정규화·측위·이동·2차 예약을 훅 하나(`use-ai-route-auto-move`)가 소유해 `AiRoutePage.tsx`가 스펙 "2줄" 상한을 -w 기준 +14/−12로 넘겼다(제출 로직 7줄이 페이지에서 빠짐 — 490은 이 파일 0줄이라 병렬성 불변); 2차 발사는 `bounds` **참조 변경** AND 시간 경과 두 조건(이동 직후 즉시 쏘면 옛 bounds, `ZOOM_OUT`은 중심이 옛 뷰포트 안이라 중심 판정만으론 못 막음); 예약 플래그를 스토어에 둬 대기 중 섹션 이탈·StrictMode 2회 실행에서도 영구 로딩·중복 발사 없음; 토스트 조사는 받침 판정 순수 함수("서면으로", ㄹ 받침 예외 포함). 0.5도 예방(뷰포트 한 변 >0.5°면 중심 기준 1km로 먼저 맞추고 요청, 토스트 없음) 실측: span 0.7° 제출 → 요청 1회·14401 없음 — **이 규칙은 아래 §11 후속 변경에서 폐기됐다(현재는 항상 1km 정규화)**. ui-web `Toast` dark가 Figma 15675:3267과 1:1이라 승격 0건, Figma 편차 0(computed style 실측). **검증 실측**: 수용 기준 28개(L19+S9) 전건 통과·확인불가 0, Chrome 위치 권한 granted + 실좌표가 서면 안이라 S1 "안 → 표시"를 브라우저에서 직접 판정, 토스트 3초 소멸, 2차 로딩 전 구간 1차 잔상 0, 콘솔 0. 중복 게이트 재등재 +11/−6 전부 489 변경 파일 포함(무관 흡수 0), `setGeolocation` 3복제는 `src/test/geolocation.ts`로 추출. **후속 변경(2026-08-29, 승인 — 스펙 §11)**: 사용자 지시로 **제출 시 항상 1km 정규화**로 바꾸고 0.5도 규칙(A2·`needsSpanNormalize`·`MAX_VIEWPORT_SPAN_DEG`·L12)을 **폐기**했다 — 항상 1km면 서버 상한 14401이 구조적으로 불가능해 0.5도 판정이 죽은 조건이 된다. 이미 1km면 줌 명령을 내지 않는다(같은 값으로 `zoomTo`하면 `idle`이 안 와 요청이 영영 안 나간다). 정규화 대기에도 로딩을 켜되(`startNormalize`) `requestedAt`은 **mutate 시점**에만 찍는다(대기가 10초 창을 먹으면 2차가 조기 발사돼 14429). 2차 발사 조건은 `bounds` 참조 변경 → **목표 뷰포트 도달**(`reachedTargetViewport` — 참조 변경 AND 줌이 목표 단)로 좁혀 진행 중 지도 조작이 2차를 오염시키지 않게 했고, **지도 잠금은 하지 않는다**(사용자 결정 — ui-web·MapShell·MapCanvas 계속 0줄). 좁힌 대가인 "목표를 영영 벗어나는" 경로는 두 대기 모두 `VIEWPORT_SETTLE_TIMEOUT_MS`=3s 상한으로 종결시켜 **영구 로딩을 테스트로 금지**(L22·L24). 결과 상태에서는 뷰포트가 바뀌어도 recommend가 안 나가 자유 확대 가능(L25 회귀 고정 — 1km에서 셀 6~7px이라 육안 미식별이던 지점이 여기서 해소). 접촉 파일 7개(+`nose.baseline.json`), `AiRoutePage.tsx` 0줄, 490 소유 파일 0줄. **재작업 1회차(2026-08-29 §12)**: 검증이 백그라운드 탭 경로에서 **14401 재현**을 잡았다 — 숨은 탭은 rAF가 멈춰 `idle`이 안 오는데 3s 상한이 옛 뷰포트(1.94°×4.75°)로 발사했다. §11이 지웠던 서버 상한 판정을 **발사 직전 최종 가드**(`exceedsViewportSpan`)로 되살려 `send()` 한 곳에서 막고, 못 보내면 `abortPending`으로 **에러 안내 종결**(영구 로딩·확정 400 둘 다 금지), 숨은 탭에서는 상한 타이머를 걸지 않는다. §11 D10의 "항상 1km면 14401 구조적 불가능" 서술은 정정됐다(정상 경로 한정). 상한 3s는 실측(줌 전이 269~729ms) 근거로 유지. **같은 회차에 사용자 지시로 `/ai-route`에서 다른 섹션 집계 클러스터 마커를 숨겼다** — `MapShell.tsx`는 MSG-488이 완결 선언한 파일이나 사용자 명시 지시이고 490도 0줄이라 병렬 충돌 없음(예외 기록). **codex 리뷰 반영(2026-08-29 §13, push 전 게이트)**: ①2차 인스턴스에 `onLoginRequired`를 붙였다 — 1차 성공과 지연된 2차(서버 10초 창) 사이에 세션이 만료되면 401을 받는데 모달이 뜨지 않았다(종전 "후속 후보" 서술은 한계가 아니라 결함이었다). ②**정착 상한이 무한히 밀리는 D13 위반을 고쳤다** — 두 대기 이펙트가 `bounds`·`zoom` 갱신마다 타이머를 처음부터 다시 걸어, 사용자가 계속 패닝하면 종결이 영영 연기됐다(정규화 대기도 동일 구조였다). 상한을 **대기 사이클당 절대 마감 1회**(`advanceSettleDeadline` 순수 함수)로 바꿔 재실행은 **남은 시간만** 스케줄하고 마감이 지났으면 즉시 종결한다. 마감은 **가시 구간만 소모**하고 숨은 구간만큼 뒤로 밀려 §12 가시성 결정과 공존한다. 패닝 반복 시나리오 3건 + 마감 산술 5건을 테스트로 고정(기존 L1~L25 회귀 0).
diff --git a/docs/decisions/DECISIONS.md b/docs/decisions/DECISIONS.md
index 3f38e2a1..4d312b8c 100644
--- a/docs/decisions/DECISIONS.md
+++ b/docs/decisions/DECISIONS.md
@@ -434,4 +434,6 @@
 | 2026-08-29 | MSG-489 | 결정(§12): `VIEWPORT_SETTLE_TIMEOUT_MS`를 3,000ms로 **유지**한다 — 검증 실측 줌 애니메이션은 16→13 269ms · 10→13 296ms · 10→16 729ms이고, §11이 근거로 삼았던 "정규화 대기 14.2초"는 백그라운드 탭 rAF 정지 아티팩트였다(같은 전이가 숨은 탭 11,162ms / 전면 탭 316ms) | 낮추면(예 1,200ms) 정착 실패 경로가 넓어져 결함 창이 커지고, 높이면 정착 실패 시 사용자 대기가 길어진다. 부수 교훈: **비활성 탭에서 잰 지도 타이밍은 전부 무효** — 계측 전 `visibilityState`와 rAF fps를 먼저 확인한다 |
 | 2026-08-29 | MSG-489 | 결정(§12, 사용자 지시): `/ai-route`에서 다른 섹션의 저줌 집계 클러스터 마커 3종을 숨긴다 — `MapShell`이 파생한 `clusters`에 `gateRouteClusters(clusters, pathname)`를 적용(파생 훅은 무수정). MSG-488이 완결 선언한 `MapShell.tsx`를 여는 **소유권 예외**를 이 한 게이트에 한정해 기록한다 | 집계 마커는 줌 16(100m) 미만에서만 존재하는 층이라 경로 게이트 하나로 사용자 지시("100m보다 커지면 안 보이게")가 전부 충족된다 — 줌 분기 추가는 불필요. 대안 ①집계 훅 3종에 라우트 조건 추가: `features/map-home`이 라우트를 알게 되고 다른 섹션 회귀 위험 ②`MapCanvas`에서 숨김: 접촉 금지 파일이고 지도 경계에 라우트 지식이 들어간다. MSG-490도 이 파일 0줄이라 병렬 머지 충돌 없음 |
 | 2026-08-29 | MSG-489 | 결정: 14429(요청 과다) 안내를 서버와 같은 문장 `"요청이 너무 잦습니다. 잠시 후 다시 시도해주세요"`로 교체한다(FE 고정 문구 상수 — 서버 응답 문자열을 렌더하는 것이 아니다) | 종전 `"잠시 후 다시 시도해 주세요"`는 사유를 알려주지 않아, 재시도를 연속으로 누른 사용자가 같은 안내만 반복해 본다(사용자 실사용 보고). 대안 ①서버 `message` 패스스루: MSG-488 §1-5의 FE 고정 문구 정책이 깨지고 임의 서버 문자열이 화면에 그대로 나간다 ②클라이언트 쿨다운 타이머로 버튼을 잠금: MSG-488 Q7에서 이미 기각한 범위 |
+| 2026-08-29 | MSG-489 | 결정(§13, codex 리뷰 P2): 정착 대기 상한을 "이펙트 재실행마다 다시 거는 타이머"에서 **대기 사이클당 절대 마감 1회**(`advanceSettleDeadline` 순수 함수 + 뷰-레이어 훅의 ref)로 바꾼다 — 재실행은 남은 시간만 스케줄하고, 마감이 지났으면 타이머 없이 즉시 종결한다. 마감은 가시 구간만 소모하고 숨은 구간만큼 뒤로 밀린다 | 종전 구조는 `bounds`·`zoom` 갱신마다 상한을 처음부터 다시 재서, 사용자가 계속 패닝하면 2차·정규화가 무한히 연기되고 패널이 로딩에 갇혔다(§11 D13 "영구 로딩 금지" 위반 — 패닝 반복 테스트가 `Infinity`로 재현). 대안 ①이펙트 deps에서 뷰포트 제거: 도달 판정이 갱신을 못 봐 옛 뷰포트로 발사(L18 파기) ②최초 예약 타이머를 재실행에서 안 건드림: 클로저가 옛 `send`를 잡아 예약 시점 뷰포트로 쏜다 ③복귀 시 상한 전체를 다시 재기: 숨김·복귀 반복으로 같은 무한 연기가 재현된다 |
+| 2026-08-29 | MSG-489 | 결정(§13, codex 리뷰 P1): 2차 자동 재요청 인스턴스에도 1차와 같은 `onLoginRequired`를 넘긴다. `docs/spec/MSG-489.md` §10·`docs/STATUS.md`에 "알려진 한계"로 적혀 있던 서술을 결함으로 정정하고 삭제했다 | 지연된 2차(서버 10초 창) 구간에 세션이 만료되면 401에서 패널만 입력 대기로 돌아가고 로그인 모달이 뜨지 않아, 사용자는 결과가 사라진 이유를 알 수 없다. `secondary` 플래그는 요청 **시작** 처리만 가르고 실패 처리는 공통이므로 인증 동작이 요청 순서에 따라 갈릴 이유가 없다 |
 
diff --git a/docs/spec/MSG-489.md b/docs/spec/MSG-489.md
index 9b953052..8ce0ac2e 100644
--- a/docs/spec/MSG-489.md
+++ b/docs/spec/MSG-489.md
@@ -265,7 +265,7 @@ Figma 정본: 섹션 15666:12401 — `15666:12402`(대기 + 출발 표시) · `1
 
 ### 후속 권장 (지라 코멘트 환류 대상)
 - 0.5도 정규화 대기(실측 14.2초 — 네이버 다단 줌 애니메이션이 `idle`을 늦게 냄) 동안 로딩 피드백 없음 — 정규화 대기에도 로딩 상태를 켜면 해소.
-- 2차 인스턴스에 `onLoginRequired` 미부착 — 1차 성공 직후 세션 만료 시 로그인 모달 없이 입력 대기로 복귀.
+- ~~2차 인스턴스에 `onLoginRequired` 미부착 — 1차 성공 직후 세션 만료 시 로그인 모달 없이 입력 대기로 복귀.~~ → **§13에서 반영 완료**(codex 리뷰 P1).
 - `features/dex/use-region-stat-query.ts`의 private `useCurrentCoords`와 이 티켓 동명 훅이 구조상 3복제(baseline 등재) — 공통화하려면 dex의 "조회 전 null 대기" 계약을 tri-state로 변경 필요.
 - 자동 이동 순간 축척 바(`role="status"`)가 "1km"를 토스트와 함께 낭독(내용 일치, 중복 낭독은 아님).
 
@@ -379,3 +379,56 @@ Figma 정본: 섹션 15666:12401 — `15666:12402`(대기 + 출발 표시) · `1
 `route-error.ts`의 `14429` 안내를 `"잠시 후 다시 시도해 주세요"` → **`"요청이 너무 잦습니다. 잠시 후 다시 시도해주세요"`**(서버 응답과 동일 문장)로 교체. 종전 문구는 "왜 막혔는지"를 알려주지 않아, 재시도를 연속으로 누른 사용자가 같은 안내만 반복해서 보게 된다.
 
 **서버 문자열을 렌더하지는 않는다** — MSG-488 §1-5가 세운 "FE 고정 문구, 서버 `notice`는 신호로만" 정책을 유지하고 같은 문장을 FE 상수로 둔다(임의 서버 문자열 렌더 금지). 띄어쓰기는 서버 원문("다시 시도해주세요")을 그대로 따랐다 — 지시가 "그대로"였고, 한 화면에 다른 안내와 동시에 노출되지 않는다.
+
+---
+
+## 13. codex 리뷰 반영 (2026-08-29 — push 전 게이트 지적 2건)
+
+> 입력: codex 리뷰(커밋 `8368b1f` 시점) · 빌드 리포트: `_workspace/MSG-489/02d_build_report.md` (`02_`·`02b_`·`02c_`는 무수정)
+> 접촉 2파일(+테스트 2·중복 베이스라인) — `MapShell.tsx`·`cluster-route-gate.ts` 포함 그 밖의 파일 0줄.
+
+### 13-1. P1 — 2차 요청에 로그인 처리가 안 붙어 있었다
+
+**지적**: `use-ai-route-auto-move.ts`의 2차 mutation 인스턴스가 `useRouteRecommend({ secondary: true })`로만 만들어져 `onLoginRequired`가 없었다. 1차 성공과 **지연된 2차**(서버 10초 창 대기) 사이에 세션이 만료되면 2차가 401(2403)을 받는데, `fail()`이 패널을 입력 대기로 되돌릴 뿐 **로그인 모달이 뜨지 않는다** — 사용자는 결과가 왜 사라졌는지 알 수 없다.
+
+**수정**: 1차와 같은 콜백을 2차 인스턴스에도 넘긴다(`useRouteRecommend({ secondary: true, onLoginRequired })`). `secondary`는 요청 **시작** 처리만 가르는 플래그이고 실패 처리는 원래 공통이라, 인증 실패 동작이 두 요청에서 같아진다.
+
+**문서 정정**: §10 "후속 권장"의 "2차 인스턴스에 `onLoginRequired` 미부착"과 `docs/STATUS.md` MSG-489 줄의 "잔여 후속 후보" 서술은 **알려진 한계가 아니라 결함**이었다 — 반영 완료로 정정했다.
+
+### 13-2. P2 — 2차 정착 상한이 무한히 밀렸다 (D13 계약 위반)
+
+**지적**: 두 대기 이펙트는 `bounds`·`zoom` 갱신마다 재실행되면서 기존 타이머를 지우고 `setTimeout(fire, VIEWPORT_SETTLE_TIMEOUT_MS)`를 **처음부터 다시** 걸었다. 사용자가 계속 패닝·줌하면 목표 미도달 상태에서 종결이 무한히 연기돼 패널이 로딩에 갇힌다 — §11 **D13("영구 로딩 금지")과 정면 충돌**이고, 03c 검증도 이 경로를 짚지 못했다. **정규화 대기(`normalizePending`)도 같은 구조라 같은 결함**이었다(지적은 2차만 지목했으나 확인 결과 동일).
+
+**수정**: 상한을 "재실행마다 다시 재는 타이머"에서 **대기 사이클당 절대 마감 1회**로 바꿨다.
+
+| 계약 | 구현 |
+|---|---|
+| 마감은 사이클당 한 번만 선다 | 순수 함수 `advanceSettleDeadline({ deadline, now, visible, timeoutMs })`(`route-request.ts`) — `deadline === null`인 첫 호출만 `now + timeoutMs`를 정하고, 이후 재실행은 `remainingMs`만 돌려준다. 이펙트는 그 **남은 시간만** 스케줄한다 |
+| 마감이 지났으면 즉시 종결 | `remainingMs === 0`이면 타이머를 걸지 않고 그 자리에서 `fire()` — 갱신이 매 프레임 들어와도 다음 재실행에서 반드시 종결한다(0ms 타이머는 갱신에 다시 취소될 수 있어 동기 발사로 뒀다) |
+| 마감은 **가시 시간**만 소모한다 (§12 유지) | 같은 함수가 `visible: false` 구간을 `hiddenSince`로 기억하고, 복귀 시 숨어 있던 만큼 `deadlineAt`을 뒤로 민다. 숨은 동안에는 종전대로 타이머를 걸지 않는다 |
+| 사이클이 끝나면 마감도 끝난다 | 예약 플래그가 내려간 이펙트 실행에서 `reset()` — 다음 대기는 새 상한을 받는다. 두 대기는 각자의 마감을 갖는다 |
+| 종결은 여전히 두 결과 중 하나 | 유효 요청 1회 발사, 또는 `abortPending(VIEWPORT_TOO_WIDE_NOTICE)`. `send()`의 `exceedsViewportSpan` 가드(§12)는 그대로라 과대 뷰포트(14401)는 어떤 경로로도 나가지 않는다 |
+
+**이미 도달한 뒤의 2차 대기는 손대지 않았다** — 남은 것이 서버 10초 창뿐이라 지도·가시성과 무관하게 계속 잰다(§12 결정 유지). 마감이 걸리는 것은 "도달 실패 대기" 구간뿐이다.
+
+### 13-3. 테스트 (전건 RED 확인 후 통과)
+
+| # | 기준 | 테스트 | RED |
+|---|------|--------|-----|
+| P1 | 2차가 401이면 1차와 똑같이 로그인 모달 콜백이 호출된다 | `use-ai-route-auto-move.test.tsx` — 1차 200(mentionedArea)/2차 401 라우팅 스텁 | 2차는 나갔으나 콜백 0회 |
+| P2-a | 정규화 대기 중 뷰포트가 반복 갱신돼도 최초 예약 상한 안에 종결 | 같은 파일 — 200ms 간격 패닝 최대 30회 주입, 경과 시간 < 상한+1.5s | `Infinity`(30회 6초 동안 미발사) |
+| P2-b | 2차 대기에서 동일 | 같은 파일 | `Infinity` |
+| P2-c | 숨은 구간은 마감에서 제외되고 복귀 후 **남은 시간만** 기다린다 | 같은 파일 — 가시 1.7s 소모 → 숨김 2.4s(발사 0 확인) → 복귀 후 2.2s 안에 종결 | `Infinity` |
+| P2-d | 마감 산술 5건(첫 예약·재호출 비재계산·만료 0·숨김 제외·숨은 채 시작) | `route-request.test.ts` | 함수 부재 |
+
+**회귀 0** — 기존 L1~L25 단정은 한 줄도 약화·삭제하지 않았다. 픽스처 변경 1건: `renderAndSubmit`/`submitAndAwaitMove`가 `onLoginRequired`를 인자로 받도록 기본값과 함께 열었다(기존 호출부 무변경).
+
+### 13-4. 검토한 대안 (기각 사유)
+
+| 판단 | 채택 | 기각한 대안 |
+|---|---|---|
+| 상한 유지 방식 | 사이클당 절대 마감 + 남은 시간 재스케줄 | ①이펙트 deps에서 `bounds`·`zoom` 제거 → 도달 판정 자체가 갱신을 못 봐서 2차가 옛 뷰포트로 나간다(L18 파기) ②최초 예약 시 `setTimeout` 한 번만 걸고 재실행에서 건드리지 않음 → 클로저가 옛 `send`(옛 bounds)를 잡아 발사 시점 뷰포트가 아니라 예약 시점 뷰포트로 쏜다 ③발사 횟수 상한(N회 재스케줄까지) → 시간이 아니라 조작 횟수에 종결이 걸려 계약(D13)을 시간으로 설명할 수 없다 |
+| 숨김 구간 처리 | 복귀 시 마감을 숨은 만큼 **뒤로 밀기** | ①숨김 진입 때 남은 시간을 저장하고 복귀 때 새 마감 계산 → 상태가 두 갈래(마감/잔여)로 갈려 같은 값을 두 번 표현한다 ②가시성 무시하고 절대 마감만 → §12 결함(옛 뷰포트 14401 발사) 재발 ③복귀 시 상한 전체를 새로 재기 → 숨김·복귀를 반복하면 다시 무한 연기가 된다(이번 결함의 변형) |
+| 마감 산술 위치 | 순수 함수(`route-request.ts`) + 뷰-레이어 훅의 ref 보관 | ①훅 안에 산술까지 인라인 → 타이밍 테스트(실타이머 수 초)로만 검증돼 경계값을 못 고정한다 ②스토어에 마감 필드 추가 → 렌더를 유발하지 않는 값이고 사이클 플래그와 수명이 달라 초기화 규칙이 갈라진다 |
+| 두 대기의 마감 공유 | 대기별 독립 인스턴스 2개 | 하나를 공유 → 정규화 종료 후 2차가 남은 상한을 물려받아 사실상 상한이 절반이 된다 |
+| P1 콜백 전달 | 1차와 동일한 `onLoginRequired` 주입 | 2차 전용 분기(예: 조용히 종료) → 인증 실패 동작이 요청 순서에 따라 달라지는 이유가 없다 |
diff --git a/nose.baseline.json b/nose.baseline.json
index b84965b2..2bc981dc 100644
--- a/nose.baseline.json
+++ b/nose.baseline.json
@@ -1495,6 +1495,32 @@
         }
       ]
     },
+    {
+      "id": "18b32dd0fb5416ba",
+      "note": "duplicated across 2 directories — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "dd5d820765c65434",
+          "source_digest": "fnv1a64:e3848ea5585c1663",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 510,
+          "end_line": 533,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "ae5f8a00caa19a17",
+          "source_digest": "fnv1a64:0173170c6733d23e",
+          "file": "apps/web/src/features/ai-route/api/use-route-recommend.test.tsx",
+          "lang": "typescript",
+          "start_line": 95,
+          "end_line": 97,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "18b8fe37fdbfd2b2",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -2269,52 +2295,6 @@
         }
       ]
     },
-    {
-      "id": "25ae55e7a487529d",
-      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
-      "members": [
-        {
-          "id": "7947a50a956c7ef8",
-          "source_digest": "fnv1a64:148271fb2dfcbd5f",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 220,
-          "end_line": 238,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "8913f9ceaffcf103",
-          "source_digest": "fnv1a64:4ffc419943892caf",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 205,
-          "end_line": 218,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "948a761c9d5c2a31",
-          "source_digest": "fnv1a64:c6fd29b1c441f0fb",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 240,
-          "end_line": 253,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "f77ab17872279a46",
-          "source_digest": "fnv1a64:1d70ef71f9a62dc3",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 255,
-          "end_line": 264,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "25bade182c8be5d8",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -6873,6 +6853,45 @@
         }
       ]
     },
+    {
+      "id": "7b52af8761fb7135",
+      "note": "consolidate `useCurrentCoords` — 3 copies",
+      "members": [
+        {
+          "id": "03e4a3726e2129d0",
+          "source_digest": "fnv1a64:e05f46d1da962eed",
+          "file": "apps/mobile/src/features/dex/model/use-region-stat-query.ts",
+          "lang": "typescript",
+          "start_line": 52,
+          "end_line": 66,
+          "kind": "Function",
+          "name": "useCurrentCoords",
+          "is_fragment": false
+        },
+        {
+          "id": "d0650e039bb8b528",
+          "source_digest": "fnv1a64:eacffa5f717fb5c0",
+          "file": "apps/web/src/features/dex/model/use-region-stat-query.ts",
+          "lang": "typescript",
+          "start_line": 52,
+          "end_line": 66,
+          "kind": "Function",
+          "name": "useCurrentCoords",
+          "is_fragment": false
+        },
+        {
+          "id": "7be2f4a8d6298129",
+          "source_digest": "fnv1a64:55053a666cf480a0",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
+          "lang": "typescript",
+          "start_line": 48,
+          "end_line": 62,
+          "kind": "Function",
+          "name": "useCurrentCoords",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "7c75640dbba2f4b4",
       "note": "consolidate `setState` — 2 copies",
@@ -8077,6 +8096,52 @@
         }
       ]
     },
+    {
+      "id": "9127d6caea5b31ef",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "6ebd1d4f0c45a0fd",
+          "source_digest": "fnv1a64:148271fb2dfcbd5f",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 253,
+          "end_line": 271,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "32968f5e9c962a55",
+          "source_digest": "fnv1a64:4ffc419943892caf",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 238,
+          "end_line": 251,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "051e619f1e485923",
+          "source_digest": "fnv1a64:c6fd29b1c441f0fb",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 273,
+          "end_line": 286,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "4c7866d33dedf245",
+          "source_digest": "fnv1a64:1d70ef71f9a62dc3",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 288,
+          "end_line": 297,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "916f3d724def1020",
       "note": "duplicated across 2 directories — extract a helper",
@@ -8609,6 +8674,32 @@
         }
       ]
     },
+    {
+      "id": "98b6b041ff1030cc",
+      "note": "local duplication — extract a method from the repeated block",
+      "members": [
+        {
+          "id": "2b449e20e846de6e",
+          "source_digest": "fnv1a64:d6525215b91d02c8",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
+          "lang": "typescript",
+          "start_line": 221,
+          "end_line": 225,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "13c62cad13b6850d",
+          "source_digest": "fnv1a64:e6f47b6bc6da04f2",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
+          "lang": "typescript",
+          "start_line": 261,
+          "end_line": 264,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "991f64fd937247fd",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -9095,6 +9186,32 @@
         }
       ]
     },
+    {
+      "id": "a1addb935f78f278",
+      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
+      "members": [
+        {
+          "id": "26ab1b79081d1833",
+          "source_digest": "fnv1a64:75903149581218d6",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 554,
+          "end_line": 581,
+          "kind": "Block",
+          "is_fragment": false
+        },
+        {
+          "id": "ca207977568e2544",
+          "source_digest": "fnv1a64:a36f920ddbc4c460",
+          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
+          "lang": "typescript",
+          "start_line": 515,
+          "end_line": 533,
+          "kind": "Block",
+          "is_fragment": false
+        }
+      ]
+    },
     {
       "id": "a252be9d2d9e2ca1",
       "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -10267,45 +10384,6 @@
         }
       ]
     },
-    {
-      "id": "b2cca4c3caff91e1",
-      "note": "consolidate `useCurrentCoords` — 3 copies",
-      "members": [
-        {
-          "id": "03e4a3726e2129d0",
-          "source_digest": "fnv1a64:e05f46d1da962eed",
-          "file": "apps/mobile/src/features/dex/model/use-region-stat-query.ts",
-          "lang": "typescript",
-          "start_line": 52,
-          "end_line": 66,
-          "kind": "Function",
-          "name": "useCurrentCoords",
-          "is_fragment": false
-        },
-        {
-          "id": "d0650e039bb8b528",
-          "source_digest": "fnv1a64:eacffa5f717fb5c0",
-          "file": "apps/web/src/features/dex/model/use-region-stat-query.ts",
-          "lang": "typescript",
-          "start_line": 52,
-          "end_line": 66,
-          "kind": "Function",
-          "name": "useCurrentCoords",
-          "is_fragment": false
-        },
-        {
-          "id": "470d22055eea927d",
-          "source_digest": "fnv1a64:55053a666cf480a0",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
-          "lang": "typescript",
-          "start_line": 43,
-          "end_line": 57,
-          "kind": "Function",
-          "name": "useCurrentCoords",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "b3694a4690fa9219",
       "note": "duplicated across 2 directories — extract a method from the repeated block",
@@ -10631,32 +10709,6 @@
         }
       ]
     },
-    {
-      "id": "ba91d4a2c4677bdc",
-      "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
-      "members": [
-        {
-          "id": "08963fa1a1250e80",
-          "source_digest": "fnv1a64:a7befad4bbcc9e51",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 282,
-          "end_line": 288,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "e005b977dfc5a049",
-          "source_digest": "fnv1a64:5d981aa860b0f991",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.test.tsx",
-          "lang": "typescript",
-          "start_line": 104,
-          "end_line": 109,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "baacdd8d65657ca5",
       "note": "local duplication — extract a method from the repeated block — test scaffolding: consolidate only a genuinely shared fixture/helper, not per-scenario setup",
@@ -13698,32 +13750,6 @@
         }
       ]
     },
-    {
-      "id": "f0b68aff23f94d8c",
-      "note": "local duplication — extract a method from the repeated block",
-      "members": [
-        {
-          "id": "3792025dbf418c0e",
-          "source_digest": "fnv1a64:d6525215b91d02c8",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
-          "lang": "typescript",
-          "start_line": 170,
-          "end_line": 174,
-          "kind": "Block",
-          "is_fragment": false
-        },
-        {
-          "id": "8bcc9543c7695d3d",
-          "source_digest": "fnv1a64:e6f47b6bc6da04f2",
-          "file": "apps/web/src/pages/ai-route/ui/use-ai-route-auto-move.ts",
-          "lang": "typescript",
-          "start_line": 191,
-          "end_line": 194,
-          "kind": "Block",
-          "is_fragment": false
-        }
-      ]
-    },
     {
       "id": "f12bf75ada2a762f",
       "note": "1 site reimplements `boxAt` — call the existing helper (apps/web/src/features/map-home/model/use-nearest-entry.test.tsx)",

From ce02bace93792bc6f1e80d32642d8b474b1e7742 Mon Sep 17 00:00:00 2001
From: gyuhochoime <cjg1999@naver.com>
Date: Sat, 29 Aug 2026 17:30:26 +0900
Subject: [PATCH 5/6] =?UTF-8?q?MSG-489=20docs:=20=EB=B8=8C=EB=9D=BC?=
 =?UTF-8?q?=EC=9A=B0=EC=A0=80=20=EC=8B=A4=EC=B8=A1=204=EA=B1=B4=20?=
 =?UTF-8?q?=EB=B3=B4=EA=B0=95=20=E2=80=94=20=EA=B2=80=EC=A6=9D=203?=
 =?UTF-8?q?=ED=9A=8C=EC=B0=A8=20=ED=99=95=EC=9D=B8=EB=B6=88=EA=B0=80=20?=
 =?UTF-8?q?=ED=95=B4=EC=86=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

검증 3회차는 탭이 hidden 고정(rAF 정지)이고 로그인 세션이 만료돼 실동작을 못 봤다. 전제(visible·121fps)를 충족시켜 재계측한 결과 4건 전건 통과.

- 정규화 315ms(8km→1km, 200)·복구 851ms·2차 간격 10,492ms(드래그 3회 방해에도 연기 없음)
- 계속 방해 시 3,088ms 종결 — recommend 0건, 로딩이 아니라 안내+"다시 시도" (P2 무한 연기 차단과 14401 가드가 같은 시나리오에서 동시 입증)
- 요청 span 전건 0.1211°x0.2966° <= 0.5°, 비200은 의도적 14429 1건뿐
- 14429 화면 문구 "요청이 너무 잦습니다. 잠시 후 다시 시도해주세요" 노출 확인

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QkrsSVoDCWaPAV45gzKpZX
---
 docs/STATUS.md       |  2 +-
 docs/spec/MSG-489.md | 15 +++++++++++++++
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/docs/STATUS.md b/docs/STATUS.md
index 5e0eea74..1eb8181d 100644
--- a/docs/STATUS.md
+++ b/docs/STATUS.md
@@ -162,4 +162,4 @@
 - MSG-475: [웹] 줌아웃 행정 단위 집계 마커 리디자인 + 핫구역 행정 단위 집계 신설 — ① 원형 3단(size-17/20/23 + `border-3 border-background` 흰 링) 마커를 Figma `15221:20097` **말풍선**으로 교체: 라운드 10·패딩 6/12/7·링 없음·`shadow-raised`·2줄(지역명 `text-fm-label` 백 85% / 개수 `text-fm-heading font-bold` 백), 채움은 Figma 정확 일치 토큰 **`bg-secondary`**(#0071E3 — 종전 `bg-primary` #0066CC에서 이동). `CLUSTER_UNIT_SIZE_CLASS` 삭제로 **단위별 크기 3단이 사라지고** 폭만 지명 길이에 hug된다(브라우저 실측 DONG 63×48·SIGUNGU 66×48 — 높이 동일). ② 축제·팝업 칩 활성 중에는 같은 마크업에 채움만 `bg-theme-festival`/`bg-theme-popup`으로 갈린다(MSG-451 ① 규칙 — 새 색·타이포 토큰 0, `design-tokens` diff 0). ③ **핫구역 칩 저줌 집계 신설** — `use-hotzone-aggregation-query`(`GET /api/hotzones/aggregation`, BE MSG-466)를 미션 집계와 같은 축척 표·같은 상한(동 1°·구 4°·시 10° `clampBoundsToSpan`)·같은 bbox 정본(**뷰포트** — 저줌엔 "장소 불러오기"가 없어 확정 영역으로는 갱신 수단이 없다)으로 배선하고, `toHotZoneClusterMarkers`(접두 `hot-{unit}-{regionCode}`, `theme: "hot"`)로 붉은 말풍선을 띄운다. **인증 게이트 없음**(사용자별 값 없음 — MSG-463 익명 선례). `occupancy-visibility.hotCellsVisible` 신설 + `use-home-overlays` 배선으로 저줌에서 개별 핫 격자를 걷어 마커와 상호 배타를 만든다(종전엔 `gateFillCells`가 색 있는 테마 셀을 저줌에도 남겨 점으로 뭉개졌다). 집계 소스는 **칩 기준 택일**(핫 / 축제·팝업 / 칩 없음+로그인 도감) — 두 종류가 한 지도에 서지 않는다. ④ **`gridIds` 교집합 좁힘은 승인 결정으로 미구현** — 시/구 클릭은 여전히 집계 구간에 내리고 DONG 클릭 후 패널은 이미 확정 행정동으로 걸러지는데 서버가 집계·개별의 판정 집합 동일을 보장해 효과가 null 버킷뿐이다(MSG-451 `missionIds` 후속 미룸과 같은 처리). ⑤ `MARKER_MERGE_PX`(68/80/92)는 **값 불변**(주석만 갱신) — 말풍선(약 61×49, 폭 가변)과 근거가 어긋나지만 모바일 parity 테스트가 리터럴로 고정하고 RN 렌더가 원 지름으로 소비한다. 재보정은 RN 렌더 교체 티켓과 함께. **명세 재생성 안 함** — `getHotZoneAggregates`·`HotZoneRegionAggregateResponseDto`가 MSG-445 스냅샷에 이미 들어와 있었다(티켓 [참고]의 "로컬 스냅샷에 없음"이 스테일). 생성물 4파일 diff 0줄로 병렬 MSG-474와의 충돌 창을 닫았다. **`apps/mobile` diff 0줄** — 웹 `region-cluster-overlay` 변경을 타입 확장·함수 신설의 **추가만**으로 묶어 parity 3종이 모바일 무수정 통과(신규 필드는 `theme`처럼 조건부 스프레드라야 `toEqual`이 안 깨진다). **모바일 화면은 이 티켓 후 두 가지가 벌어진다** — 마커 형태(원형 3단 vs 말풍선)와 핫 칩 저줌 표시(모바일은 격자 낱개 유지, 집계 훅 없음): 별도 [모바일] 티켓 몫. 검증 실측: 브라우저 계산 스타일 전건 일치·칩 5상태 택일·드릴다운 줌 2건·**AC 13 정합(부전2동 마커 1 = 격자 줌 붉은 셀 1)**·콘솔 에러 0, e2e `cluster-zoom-gate` 무수정 2/2, 웹 1289+모바일 982 전건. 확인불가 1건 — 미판정 버킷(`regionCode` null)이 실데이터에 0건(전국 SIDO 프로브 실측)이라 단위 테스트로 대체. nose 신규 9패밀리(신설 훅·테스트 ↔ 도감·미션 형제) baseline 등재 — 3형제 훅은 게이트 조건·envelope·placeholder 정책이 9개 지점에서 갈려 공통 추출이 부적합(nose 자신의 9파라미터 판정, MSG-476 선례). **등재 시 무관 흡수 1건(`profile-edit-modal.smoke` ↔ `envelope-response` — develop에도 있던 hidden 패밀리)을 되돌렸다**(MSG-476 교훈). 참고: 흰 글자 대비가 hot 3.6:1·popup 2.2:1로 WCAG 미달이나 MSG-451부터 승계된 테마 토큰 규칙이자 Figma 정본 값 — 디자인 차원 후속 거리.
 - MSG-474: 비로그인 지도 홈 개방 — QA 3건(최초 진입 로그인 안내만 뜸 / "장소 불러오기" 미작동 / 칩 최근접 이동 안 됨)의 뿌리는 하나였다: 역지오코딩이 비로그인에서 게이트돼 **확정(commit)이 영영 생기지 않음** → `committedBounds`가 부트스트랩 초기 뷰포트에 고정 → 칩 bbox가 좁고 `currentRegion` null이라 불러오기 버튼 미생성. 티켓이 지목한 `use-nearest-entry`는 무관했다(그 훅의 center는 `viewportCenter`라 비로그인에도 null 아님). **게이트 해제 3곳**(`MapHomePage`·`RegionPanel`·`use-committed-region` — 마지막은 티켓 미기재였으나 최초 확정의 실제 소스)으로 3건이 함께 풀렸고 `use-chip-entry`·`use-nearest-entry`·`region-reload`는 **무수정** 회귀 통과. ① `RegionPanel` 로그인 유도 분기 통삭제 → 헤더·격자 카드·"전체 보기"·전체 지역 무한 스크롤이 비로그인에도 열린다(**MSG-463 확정 1을 뒤집음** — 당시 근거 "데이터원이 로그인 전용"이 explore 익명 200으로 소멸, 사용자 승인). ② 비로그인 격자 상세는 `grids/{gridId}`(응답이 occupied·내 영상 수 = 사용자별이라 익명 401이 **설계상 정상**)를 부르지 않고 **진입점 응답의 이름 재료로 조립** — `deriveHomeCellDetail`을 `viewerAuthenticated` 판별식 유니언(로그인=cell 필수 / 비로그인=entryNaming 필수)으로 확장, 비로그인은 subtitle null·"내 점령" 배지 없음. ③ 인증 **true→false 전이**에서 `QueryProvider` 한 곳이 `queryClient.clear()` — 티켓의 "쿼리 키에 인증 반영"은 생성 키에 인증 축이 없고 로그인은 이미 clear 중(로그아웃만 누락)이라 키 확장 10곳+ 대신 전이 구독 1곳을 택했다. ④ **스펙 인벤토리 밖 401 경로 2건을 구현 중 발견·차단**: `use-grid-names-query`(코스 스팟 이름 = `grids/{id}` N회)·dex `use-region-videos-query`(`collections/videos` — 비로그인 확정 지역이 생기며 처음 활성화). **실측이 범위를 두 번 바꿨다**: 티켓의 "BE 선행 전부 배포 확인"과 달리 1차 익명 curl에서 `regions/{code}/grids`·`videos/{id}`·`explore`가 401(요구 2·5·재생 블로커) → 사용자가 권한 재배포 → 2차 실측 200으로 요구 5건 전부 성립. **`api:generate` 미실행** — 라이브 `/v3/api-docs`와 레포 스냅샷이 **바이트 동일**(권한만 열리고 계약 무변경)이라 생성물 4파일 diff 0, MSG-475와의 충돌 우려도 소멸(구현 중 발견된 생성물 재생성분은 `FriendPreviewResponseDto.relation`=MSG-391 친구 기능으로 무관 → HEAD 복원). **AC 14(최종 방어선) 통과**: 비로그인 전 과정(진입→전체 보기→이동→불러오기→칩 3종→격자 상세→코스 상세→재생) `/api/` 실호출 전건 200·**401 0건·reissue 0건**·금지 7종 0건. **재작업 1회차**: ① 모바일 `home-cell-detail.parity.test.ts`가 웹 파생 함수를 구 시그니처로 동적 import해 깨짐 — 빌더가 `--filter web`만 돌려 놓쳤고 루트 게이트가 잡았다(**MSG-476과 동일 재발** — 웹 파생 함수를 바꾸는 티켓은 모바일 패리티 앵커를 먼저 조회할 것), 타입까지 새 계약에 묶어 다음 드리프트를 typecheck가 잡게 함 ② e2e `consent-gate-popstate`가 익명 렌더 증거로 삭제 대상인 "로그인" 버튼을 단정 → 확정 행정동 heading으로 교체(게이트 본래 단정 무변경) ③ nose 신규 6패밀리 개별 검토 후 추출 대상 0건 판정·베이스라인 재등재. **BE 환류 2건**: 코스 스팟(`CourseSpotDto`)이 좌표만 줘 비로그인 코스 스팟 상세에 행정동 줄 없음(AC 11 부분, FE로 메울 수 없음) · dev 재생 미디어가 S3 키를 `https%3A//dev.local/seed/….m3u8`로 저장해 403(AC 12 프레임 미표시 — FE 계약은 성립, 시드 데이터 결함). 확인불가 2건은 로그인 상태 브라우저 회귀(카카오 세션 부재, MSG-463 선례)
 - MSG-488: [웹] AI 경로추천 페이지 신설 (`/ai-route`) — 자연어 문장 → `POST /api/routes/recommend` → 좌측 388px 패널 카드 리스트 + 지도 오버레이(번호 마커·격자 초록 틴트·이웃 직선). **라우트명은 티켓 가칭 `/route`에서 `/ai-route`로 변경**(사용자 승인) — 코드베이스에 `route`가 이미 3중 의미(`ROUTES` react-router 상수 · `ThemeId "route"` = 기존 코스 칩 "경로추천"으로 같은 초록 `theme-route`까지 공유 · `map-overlay-store.routes`)라 동음이의를 피했다. **로그인 전용** — 2026-08-28 익명 POST 실측이 `401 {developCode:2403}`이라 `RequireAuth` + 레일 항목 비로그인 클릭 시 `login-modal-store` 게이트. **결과 도착 시 지도를 이동·확대하지 않는다**(카드 클릭만 `moveTo`, 줌 불변) — 사용자가 보던 범위를 뺏지 않는 것이 이 티켓의 계약이고, 자동 이동은 MSG-489 몫. **재사용 성과: 신규 렌더 코드가 거의 없다** — `map-overlay-store`에 이미 `routes`(폴리라인 + 번호 경유지)·`cells`(색·빗금) 슬롯이 있어 MapShell→MapCanvas 렌더 경로를 통째로 썼고, MapCanvas 추가분은 경유지 `onClick` 슬롯 + `active` 강조뿐(`onRouteWaypointClick` 미제공이면 기존 코스 마커는 비클릭 그대로). 오버레이 파생은 순수 함수 `route-overlay.ts`에 두어 RN 경계 유지(`features/`·`model/`에 `naver` import 0건). 승격 2건: ui-web **`Skeleton`** 신설(레포 첫 스켈레톤 — 착수 전제였던 "GalleryTabBody가 첫 사용처"는 실측 오류였다. `GallerySkeleton`은 `DotsLoader` 래퍼이고 MSG-403이 의도적으로 도트로 통일한 자리라 미접촉), **`RetryNotice`**를 `pages/map-home/ui/` → ui-web 이동(재사용 시 pages→pages import가 되므로 — 소비 8파일은 import 한 줄씩만 변경). 마커 스타일은 Figma 정본(28px `size-7` + `border-2 border-background` + `shadow-raised`)으로 갱신했고 `routeMarkerContent` 공유상 **기존 코스 칩 경유지 마커도 함께 바뀌는 것을 사용자가 승인**(두 마커가 같은 초록이라 통일이 낫다는 판단 — `markerStyle` 분기 미생성). 결과 부족 배너는 **FE 고정 문구**이고 서버 `notice`는 null 여부 신호로만 쓴다(문자열 미노출을 `not.toContain`으로 고정), 0곳이면 카드·오버레이 없이 배너만. **웨이브 2 병렬 머지를 위해 파일 소유권을 설계 산출물로 명시**(정본 `docs/spec/MSG-488.md` §4-2): 489(상태·요청·입력카드 계열)와 490(구간거리·오버레이 기하·walk-paths 계열)의 **교차 파일 0건**, 공유 파일 `AiRoutePage.tsx`도 489만 2줄·490은 0줄, 셸·렌더·라우트·레일·ui-web은 488이 완결(둘 다 0줄). 확장점 주석 3종을 지정 위치에 심었고 489·490 신규 예정 파일은 하나도 만들지 않았다. **검증 실측**: 남아 있던 리프레시 쿠키로 실계정 자동 재발급이 돼 **실 API 8곳 응답**으로 브라우저 검증 — 지도 미이동(축척바 100m 불변) · 8→3→2→0곳 4회 연속 갱신 잔상 0 · 도감 왕복 후 복원 + **재요청 0회** · 실패 7경로 전건 · Figma 4프레임 오탐 목록 밖 편차 0 · 콘솔 에러 0. 확인불가 1건 — 빗금(점령 격자 교집합)이 실데이터에 발생하지 않아 육안 불가, 단위 테스트로 대체. a11y 지적 1건 즉시 반영: `RouteResultHeader`(`role="status"`)가 자체 `role="status"`를 가진 `DotsLoader`를 감싸 낭독이 실제로 중복돼(`"동선 찾는 중 동선 찾는 중"`) 도트를 `aria-hidden`으로 감쌌다(ui-web 무수정). **nose 중복 게이트는 착수 전부터 red**였고 근원이 이 티켓 자신의 웨이브 0 openapi 커밋(`107aa59`)이라 재등재했다 — 검증자가 `git archive HEAD`로 워크트리 밖에 풀어 재현해 HEAD 시점 3패밀리가 빌더 지목 id와 일치함을 독립 확인(숨어든 진짜 중복 0). **알려진 한계**: `gateFillCells`가 `zoom < 16`에서 채움 셀을 버려 넓게 본 상태에서 요청하면 격자 초록 틴트가 안 보인다(마커·선은 남음) — MSG-489의 1km 축척 고정이 해소한다. **489 선행 경고**: "지도 위 현재 위치 점"을 그릴 슬롯이 `MapCanvasProps`에 없어(`MapLabelOverlay`는 텍스트 pill, `waypoints`는 번호 뱃지) 489가 "488 완결·489 0줄"로 선언된 `MapCanvas.tsx`를 다시 열 공산이 크다 — 489∥490 병렬성 자체는 안 깨진다. **스펙 각주 누락 1건**: Figma 결과·결과 부족 프레임 양쪽에 "축제, 팝업, 코스, 행사 정보와…" 각주가 있는데 스펙은 로딩 화면에만 기재 — 디자인 정본을 따라 양쪽에 렌더.
-- MSG-489: [웹] AI 경로추천 — `mentionedArea` 자동 이동·1km 축척 고정·2차 자동 재요청·출발지(origin) 자동 판정. **웨이브 2 = 490(walk-paths)과 동시 진행** — `docs/spec/MSG-488.md` §4-2 소유권 표의 489열만 접촉, 접촉 금지 15경로 diff 0줄(검증자 감사), `MapCanvas.tsx` 0줄(현재 위치 점은 **Figma 12402·13139에 노드가 없어 제외** — 488의 "489가 MapCanvas를 다시 열 공산" 경고는 디자인 근거가 없었다). **착수 전 실측 2건이 설계를 결정했다**: ① 2차 자동 재요청은 서버 10초 rate limit **예외가 아니다**(로그인 세션 연속 호출 → 두 번째 `429/14429`, 1차 요청 시작 +11s는 200, `Retry-After` 없음) → 1차 `requestedAt` 기준 `10.5s` 잔여 대기 후 발사, 대기·2차 중 패널은 로딩·1차 결과 미게시, 2차 mentionedArea 무시(1회 한정), 2차 14429면 기존 에러 매핑. 브라우저 실측 간격 11,174ms·recommend 정확히 2회. ② `shared/geolocation.getCurrentPosition()`이 **권한 거부를 삼키고 서면 좌표를 돌려줘** 거부 사용자에게도 origin이 전송되는 오판정 → 가산 export `getCurrentPositionOrNull`(사용자 승인, 기존 소비 3곳 무수정). **488 "알려진 한계" 정정**: `gateFillCells`는 `zoom<16`에서 *색 있는 셀을 남기는* 필터이고 AI 경로 셀은 전부 `theme-route` 색이라 게이트를 **통과한다**(zoom 13에서 폴리곤 8개 DOM 실측, `fill=#34C759`) — 다만 1km 축척에선 셀이 6~7px이라 28px 마커에 가려 육안으로는 안 보인다. "1km 고정이 해소한다"는 서술은 성립하지 않으며 이는 홈과 동일한 저줌 공통 동작으로 수용(`MAP_SCALE_1KM_ZOOM`=13 < `GRID_MIN_ZOOM`=16). **설계 결정**: 제출·정규화·측위·이동·2차 예약을 훅 하나(`use-ai-route-auto-move`)가 소유해 `AiRoutePage.tsx`가 스펙 "2줄" 상한을 -w 기준 +14/−12로 넘겼다(제출 로직 7줄이 페이지에서 빠짐 — 490은 이 파일 0줄이라 병렬성 불변); 2차 발사는 `bounds` **참조 변경** AND 시간 경과 두 조건(이동 직후 즉시 쏘면 옛 bounds, `ZOOM_OUT`은 중심이 옛 뷰포트 안이라 중심 판정만으론 못 막음); 예약 플래그를 스토어에 둬 대기 중 섹션 이탈·StrictMode 2회 실행에서도 영구 로딩·중복 발사 없음; 토스트 조사는 받침 판정 순수 함수("서면으로", ㄹ 받침 예외 포함). 0.5도 예방(뷰포트 한 변 >0.5°면 중심 기준 1km로 먼저 맞추고 요청, 토스트 없음) 실측: span 0.7° 제출 → 요청 1회·14401 없음 — **이 규칙은 아래 §11 후속 변경에서 폐기됐다(현재는 항상 1km 정규화)**. ui-web `Toast` dark가 Figma 15675:3267과 1:1이라 승격 0건, Figma 편차 0(computed style 실측). **검증 실측**: 수용 기준 28개(L19+S9) 전건 통과·확인불가 0, Chrome 위치 권한 granted + 실좌표가 서면 안이라 S1 "안 → 표시"를 브라우저에서 직접 판정, 토스트 3초 소멸, 2차 로딩 전 구간 1차 잔상 0, 콘솔 0. 중복 게이트 재등재 +11/−6 전부 489 변경 파일 포함(무관 흡수 0), `setGeolocation` 3복제는 `src/test/geolocation.ts`로 추출. **후속 변경(2026-08-29, 승인 — 스펙 §11)**: 사용자 지시로 **제출 시 항상 1km 정규화**로 바꾸고 0.5도 규칙(A2·`needsSpanNormalize`·`MAX_VIEWPORT_SPAN_DEG`·L12)을 **폐기**했다 — 항상 1km면 서버 상한 14401이 구조적으로 불가능해 0.5도 판정이 죽은 조건이 된다. 이미 1km면 줌 명령을 내지 않는다(같은 값으로 `zoomTo`하면 `idle`이 안 와 요청이 영영 안 나간다). 정규화 대기에도 로딩을 켜되(`startNormalize`) `requestedAt`은 **mutate 시점**에만 찍는다(대기가 10초 창을 먹으면 2차가 조기 발사돼 14429). 2차 발사 조건은 `bounds` 참조 변경 → **목표 뷰포트 도달**(`reachedTargetViewport` — 참조 변경 AND 줌이 목표 단)로 좁혀 진행 중 지도 조작이 2차를 오염시키지 않게 했고, **지도 잠금은 하지 않는다**(사용자 결정 — ui-web·MapShell·MapCanvas 계속 0줄). 좁힌 대가인 "목표를 영영 벗어나는" 경로는 두 대기 모두 `VIEWPORT_SETTLE_TIMEOUT_MS`=3s 상한으로 종결시켜 **영구 로딩을 테스트로 금지**(L22·L24). 결과 상태에서는 뷰포트가 바뀌어도 recommend가 안 나가 자유 확대 가능(L25 회귀 고정 — 1km에서 셀 6~7px이라 육안 미식별이던 지점이 여기서 해소). 접촉 파일 7개(+`nose.baseline.json`), `AiRoutePage.tsx` 0줄, 490 소유 파일 0줄. **재작업 1회차(2026-08-29 §12)**: 검증이 백그라운드 탭 경로에서 **14401 재현**을 잡았다 — 숨은 탭은 rAF가 멈춰 `idle`이 안 오는데 3s 상한이 옛 뷰포트(1.94°×4.75°)로 발사했다. §11이 지웠던 서버 상한 판정을 **발사 직전 최종 가드**(`exceedsViewportSpan`)로 되살려 `send()` 한 곳에서 막고, 못 보내면 `abortPending`으로 **에러 안내 종결**(영구 로딩·확정 400 둘 다 금지), 숨은 탭에서는 상한 타이머를 걸지 않는다. §11 D10의 "항상 1km면 14401 구조적 불가능" 서술은 정정됐다(정상 경로 한정). 상한 3s는 실측(줌 전이 269~729ms) 근거로 유지. **같은 회차에 사용자 지시로 `/ai-route`에서 다른 섹션 집계 클러스터 마커를 숨겼다** — `MapShell.tsx`는 MSG-488이 완결 선언한 파일이나 사용자 명시 지시이고 490도 0줄이라 병렬 충돌 없음(예외 기록). **codex 리뷰 반영(2026-08-29 §13, push 전 게이트)**: ①2차 인스턴스에 `onLoginRequired`를 붙였다 — 1차 성공과 지연된 2차(서버 10초 창) 사이에 세션이 만료되면 401을 받는데 모달이 뜨지 않았다(종전 "후속 후보" 서술은 한계가 아니라 결함이었다). ②**정착 상한이 무한히 밀리는 D13 위반을 고쳤다** — 두 대기 이펙트가 `bounds`·`zoom` 갱신마다 타이머를 처음부터 다시 걸어, 사용자가 계속 패닝하면 종결이 영영 연기됐다(정규화 대기도 동일 구조였다). 상한을 **대기 사이클당 절대 마감 1회**(`advanceSettleDeadline` 순수 함수)로 바꿔 재실행은 **남은 시간만** 스케줄하고 마감이 지났으면 즉시 종결한다. 마감은 **가시 구간만 소모**하고 숨은 구간만큼 뒤로 밀려 §12 가시성 결정과 공존한다. 패닝 반복 시나리오 3건 + 마감 산술 5건을 테스트로 고정(기존 L1~L25 회귀 0).
+- MSG-489: [웹] AI 경로추천 — `mentionedArea` 자동 이동·1km 축척 고정·2차 자동 재요청·출발지(origin) 자동 판정. **웨이브 2 = 490(walk-paths)과 동시 진행** — `docs/spec/MSG-488.md` §4-2 소유권 표의 489열만 접촉, 접촉 금지 15경로 diff 0줄(검증자 감사), `MapCanvas.tsx` 0줄(현재 위치 점은 **Figma 12402·13139에 노드가 없어 제외** — 488의 "489가 MapCanvas를 다시 열 공산" 경고는 디자인 근거가 없었다). **착수 전 실측 2건이 설계를 결정했다**: ① 2차 자동 재요청은 서버 10초 rate limit **예외가 아니다**(로그인 세션 연속 호출 → 두 번째 `429/14429`, 1차 요청 시작 +11s는 200, `Retry-After` 없음) → 1차 `requestedAt` 기준 `10.5s` 잔여 대기 후 발사, 대기·2차 중 패널은 로딩·1차 결과 미게시, 2차 mentionedArea 무시(1회 한정), 2차 14429면 기존 에러 매핑. 브라우저 실측 간격 11,174ms·recommend 정확히 2회. ② `shared/geolocation.getCurrentPosition()`이 **권한 거부를 삼키고 서면 좌표를 돌려줘** 거부 사용자에게도 origin이 전송되는 오판정 → 가산 export `getCurrentPositionOrNull`(사용자 승인, 기존 소비 3곳 무수정). **488 "알려진 한계" 정정**: `gateFillCells`는 `zoom<16`에서 *색 있는 셀을 남기는* 필터이고 AI 경로 셀은 전부 `theme-route` 색이라 게이트를 **통과한다**(zoom 13에서 폴리곤 8개 DOM 실측, `fill=#34C759`) — 다만 1km 축척에선 셀이 6~7px이라 28px 마커에 가려 육안으로는 안 보인다. "1km 고정이 해소한다"는 서술은 성립하지 않으며 이는 홈과 동일한 저줌 공통 동작으로 수용(`MAP_SCALE_1KM_ZOOM`=13 < `GRID_MIN_ZOOM`=16). **설계 결정**: 제출·정규화·측위·이동·2차 예약을 훅 하나(`use-ai-route-auto-move`)가 소유해 `AiRoutePage.tsx`가 스펙 "2줄" 상한을 -w 기준 +14/−12로 넘겼다(제출 로직 7줄이 페이지에서 빠짐 — 490은 이 파일 0줄이라 병렬성 불변); 2차 발사는 `bounds` **참조 변경** AND 시간 경과 두 조건(이동 직후 즉시 쏘면 옛 bounds, `ZOOM_OUT`은 중심이 옛 뷰포트 안이라 중심 판정만으론 못 막음); 예약 플래그를 스토어에 둬 대기 중 섹션 이탈·StrictMode 2회 실행에서도 영구 로딩·중복 발사 없음; 토스트 조사는 받침 판정 순수 함수("서면으로", ㄹ 받침 예외 포함). 0.5도 예방(뷰포트 한 변 >0.5°면 중심 기준 1km로 먼저 맞추고 요청, 토스트 없음) 실측: span 0.7° 제출 → 요청 1회·14401 없음 — **이 규칙은 아래 §11 후속 변경에서 폐기됐다(현재는 항상 1km 정규화)**. ui-web `Toast` dark가 Figma 15675:3267과 1:1이라 승격 0건, Figma 편차 0(computed style 실측). **검증 실측**: 수용 기준 28개(L19+S9) 전건 통과·확인불가 0, Chrome 위치 권한 granted + 실좌표가 서면 안이라 S1 "안 → 표시"를 브라우저에서 직접 판정, 토스트 3초 소멸, 2차 로딩 전 구간 1차 잔상 0, 콘솔 0. 중복 게이트 재등재 +11/−6 전부 489 변경 파일 포함(무관 흡수 0), `setGeolocation` 3복제는 `src/test/geolocation.ts`로 추출. **후속 변경(2026-08-29, 승인 — 스펙 §11)**: 사용자 지시로 **제출 시 항상 1km 정규화**로 바꾸고 0.5도 규칙(A2·`needsSpanNormalize`·`MAX_VIEWPORT_SPAN_DEG`·L12)을 **폐기**했다 — 항상 1km면 서버 상한 14401이 구조적으로 불가능해 0.5도 판정이 죽은 조건이 된다. 이미 1km면 줌 명령을 내지 않는다(같은 값으로 `zoomTo`하면 `idle`이 안 와 요청이 영영 안 나간다). 정규화 대기에도 로딩을 켜되(`startNormalize`) `requestedAt`은 **mutate 시점**에만 찍는다(대기가 10초 창을 먹으면 2차가 조기 발사돼 14429). 2차 발사 조건은 `bounds` 참조 변경 → **목표 뷰포트 도달**(`reachedTargetViewport` — 참조 변경 AND 줌이 목표 단)로 좁혀 진행 중 지도 조작이 2차를 오염시키지 않게 했고, **지도 잠금은 하지 않는다**(사용자 결정 — ui-web·MapShell·MapCanvas 계속 0줄). 좁힌 대가인 "목표를 영영 벗어나는" 경로는 두 대기 모두 `VIEWPORT_SETTLE_TIMEOUT_MS`=3s 상한으로 종결시켜 **영구 로딩을 테스트로 금지**(L22·L24). 결과 상태에서는 뷰포트가 바뀌어도 recommend가 안 나가 자유 확대 가능(L25 회귀 고정 — 1km에서 셀 6~7px이라 육안 미식별이던 지점이 여기서 해소). 접촉 파일 7개(+`nose.baseline.json`), `AiRoutePage.tsx` 0줄, 490 소유 파일 0줄. **재작업 1회차(2026-08-29 §12)**: 검증이 백그라운드 탭 경로에서 **14401 재현**을 잡았다 — 숨은 탭은 rAF가 멈춰 `idle`이 안 오는데 3s 상한이 옛 뷰포트(1.94°×4.75°)로 발사했다. §11이 지웠던 서버 상한 판정을 **발사 직전 최종 가드**(`exceedsViewportSpan`)로 되살려 `send()` 한 곳에서 막고, 못 보내면 `abortPending`으로 **에러 안내 종결**(영구 로딩·확정 400 둘 다 금지), 숨은 탭에서는 상한 타이머를 걸지 않는다. §11 D10의 "항상 1km면 14401 구조적 불가능" 서술은 정정됐다(정상 경로 한정). 상한 3s는 실측(줌 전이 269~729ms) 근거로 유지. **같은 회차에 사용자 지시로 `/ai-route`에서 다른 섹션 집계 클러스터 마커를 숨겼다** — `MapShell.tsx`는 MSG-488이 완결 선언한 파일이나 사용자 명시 지시이고 490도 0줄이라 병렬 충돌 없음(예외 기록). **codex 리뷰 반영(2026-08-29 §13, push 전 게이트)**: ①2차 인스턴스에 `onLoginRequired`를 붙였다 — 1차 성공과 지연된 2차(서버 10초 창) 사이에 세션이 만료되면 401을 받는데 모달이 뜨지 않았다(종전 "후속 후보" 서술은 한계가 아니라 결함이었다). ②**정착 상한이 무한히 밀리는 D13 위반을 고쳤다** — 두 대기 이펙트가 `bounds`·`zoom` 갱신마다 타이머를 처음부터 다시 걸어, 사용자가 계속 패닝하면 종결이 영영 연기됐다(정규화 대기도 동일 구조였다). 상한을 **대기 사이클당 절대 마감 1회**(`advanceSettleDeadline` 순수 함수)로 바꿔 재실행은 **남은 시간만** 스케줄하고 마감이 지났으면 즉시 종결한다. 마감은 **가시 구간만 소모**하고 숨은 구간만큼 뒤로 밀려 §12 가시성 결정과 공존한다. 패닝 반복 시나리오 3건 + 마감 산술 5건을 테스트로 고정(기존 L1~L25 회귀 0). **브라우저 실측(2026-08-29, 전제 충족 후 재계측)**: 정규화 315ms(8km→1km)·복구 851ms·2차 간격 10,492ms·요청 span 전건 ≤0.5°·14429 문구 노출 확인, 계속 방해 시 3,088ms 종결(요청 0건, 안내+다시 시도).
diff --git a/docs/spec/MSG-489.md b/docs/spec/MSG-489.md
index 8ce0ac2e..0ce5a908 100644
--- a/docs/spec/MSG-489.md
+++ b/docs/spec/MSG-489.md
@@ -432,3 +432,18 @@ Figma 정본: 섹션 15666:12401 — `15666:12402`(대기 + 출발 표시) · `1
 | 마감 산술 위치 | 순수 함수(`route-request.ts`) + 뷰-레이어 훅의 ref 보관 | ①훅 안에 산술까지 인라인 → 타이밍 테스트(실타이머 수 초)로만 검증돼 경계값을 못 고정한다 ②스토어에 마감 필드 추가 → 렌더를 유발하지 않는 값이고 사이클 플래그와 수명이 달라 초기화 규칙이 갈라진다 |
 | 두 대기의 마감 공유 | 대기별 독립 인스턴스 2개 | 하나를 공유 → 정규화 종료 후 2차가 남은 상한을 물려받아 사실상 상한이 절반이 된다 |
 | P1 콜백 전달 | 1차와 동일한 `onLoginRequired` 주입 | 2차 전용 분기(예: 조용히 종료) → 인증 실패 동작이 요청 순서에 따라 달라지는 이유가 없다 |
+
+### 13-1. 브라우저 실측 보강 (2026-08-29 — 03d 확인불가 4건 해소)
+
+검증 3회차(03d)는 탭이 `hidden` 고정(rAF 정지)이고 로그인 세션이 만료돼 실동작을 하나도 못 봤다. 사용자가 화면을 켜고 로그인한 뒤 전제(`visible` · **121fps**)를 충족시켜 재계측했다 — 전건 통과(`_workspace/MSG-489/03e_orchestrator_browser_checks.md`).
+
+| 항목 | 실측 |
+|---|---|
+| 정규화(방해 없음) | 8km 제출 → **315ms**에 1km로 발사, 200·8곳 |
+| 정규화(계속 방해) | 16km 제출 후 5초간 축소 연타(→128km) → **3,088ms 종결**, recommend **0건**, 로딩 아닌 안내+"다시 시도" |
+| 복구 | "다시 시도" → **851ms**에 1km 발사, 200 |
+| 2차 대기(드래그 3회 방해) | 1차 +226ms → 토스트 "서면으로 이동했어요"(2,912ms) → **2차 +10,718ms**(요청 시각 기준 10,492ms), 200·8곳 — 연기 없음 |
+| 요청 범위 | 전건 span 0.1211° × 0.2966° ≤ 0.5°, 비200은 의도적 14429 1건뿐 |
+| 14429 문구 | 재제출 → 화면에 "요청이 너무 잦습니다. 잠시 후 다시 시도해주세요" |
+
+`P2`(무한 연기)와 §12의 14401 가드가 **같은 시나리오에서 동시에 입증**됐다 — 계속 방해해도 3.1초에 종결하고, 그 종결이 과대 뷰포트 요청이 아니라 안내로 끝난다. 남은 미검증은 "2차 대기 중 탭 숨김/복귀 시 마감이 가시 시간만 소모하는지" 하나이며 단위 테스트 3건이 고정한다.

From 55aa07593795b257b278f16559ef19a0393d1423 Mon Sep 17 00:00:00 2001
From: gyuhochoime <cjg1999@naver.com>
Date: Sat, 29 Aug 2026 17:42:49 +0900
Subject: [PATCH 6/6] =?UTF-8?q?MSG-489=20docs:=20react-doctor=20=EC=BA=90?=
 =?UTF-8?q?=EC=8B=9C=20=EB=AC=B4=ED=9A=A8=ED=99=94=20=EC=A7=80=EC=A0=81=20?=
 =?UTF-8?q?=EA=B8=B0=EA=B0=81=20=E2=80=94=20=EC=82=AC=EC=9C=A0=20=EB=AA=85?=
 =?UTF-8?q?=EC=8B=9C=20+=20=ED=95=B4=EB=8B=B9=20=EC=A4=84=EB=A7=8C=20?=
 =?UTF-8?q?=EC=9D=B8=EB=9D=BC=EC=9D=B8=20=EC=96=B5=EC=A0=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR #105 리뷰(react-doctor/query-mutation-missing-invalidation, warning) 판정.

/api/routes/recommend는 body가 필요해 POST일 뿐 읽기형이라(생성 스펙: "…보내면 지점 목록을 돌려준다") 서버 리소스를 만들지도 고치지도 않고, 응답은 쿼리 캐시가 아니라 ai-route-store로 간다 — 낡아질 캐시가 없다. 제안대로 onSuccess에 invalidateQueries를 넣으면 1차 응답 분기(결과 미게시 + 2차 예약)에서도 실행돼 무관한 격자 쿼리를 재요청하고 오버레이를 흔든다.

규칙 자체는 레포의 다른 mutation에서 유효하므로(video 5·profile 3·badge 1이 실제로 invalidate) doctor.config.json 전역 off는 하지 않는다. pre-commit 훅이 --blocking warning이라 커밋이 막혀, 공식 인라인 억제(react-doctor-disable-next-line)로 이 한 줄만 좁혀 껐다 — 판정 근거는 호출부 주석과 docs/spec/MSG-489.md §13-2에 남긴다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QkrsSVoDCWaPAV45gzKpZX
---
 .../src/features/ai-route/api/use-route-recommend.ts  | 10 ++++++++++
 docs/spec/MSG-489.md                                  | 11 +++++++++++
 2 files changed, 21 insertions(+)

diff --git a/apps/web/src/features/ai-route/api/use-route-recommend.ts b/apps/web/src/features/ai-route/api/use-route-recommend.ts
index b575d4e1..8e0274af 100644
--- a/apps/web/src/features/ai-route/api/use-route-recommend.ts
+++ b/apps/web/src/features/ai-route/api/use-route-recommend.ts
@@ -18,6 +18,13 @@ import {
  * mutation은 TanStack 기본 `retry: 0`이라 14429(10초 제한)가 자동 재시도로 악화되지 않는다.
  * 콜백은 훅 레벨 옵션으로 받는다 — mutate per-call 콜백은 관찰자 언마운트 시 유실된다(MSG-325 선례).
  *
+ * **쿼리 무효화가 없는 것은 의도다** (react-doctor `query-mutation-missing-invalidation` 오탐,
+ * 2026-08-29 판정). 이 엔드포인트는 body가 필요해 POST일 뿐 **읽기형**이라(생성 스펙: "…보내면
+ * 지점 목록을 돌려준다") 서버 리소스를 만들지도 고치지도 않고, 응답은 쿼리 캐시가 아니라
+ * `ai-route-store`로 간다 — 낡아질 캐시가 없다. 되레 `onSuccess`에 무효화를 넣으면 1차 응답
+ * 분기(결과 미게시 + 2차 예약)에서도 실행돼 무관한 격자 쿼리를 재요청하고 오버레이를 흔든다.
+ * 규칙 자체는 레포의 다른 mutation(video·profile·badge)에서 유효하므로 전역 off 하지 않는다.
+ *
  * MSG-489: 응답에 `mentionedArea`가 실리면 **결과를 게시하지 않고**(D5) 2차 요청을 예약한다.
  * 2차 인스턴스(`secondary: true`)는 예약 플래그를 보존한 채 로딩만 이어 간다 —
  * `startRequest`를 쓰면 `autoMoved`가 초기화돼 2차 응답에서 또 이동하는 무한 루프가 된다.
@@ -39,6 +46,9 @@ export const useRouteRecommend = (callbacks?: {
   const succeed = useAiRouteStore((s) => s.succeed);
   const fail = useAiRouteStore((s) => s.fail);
 
+  // 읽기형 POST라 무효화할 캐시가 없다 — 위 주석의 판정(2026-08-29). 규칙은 레포 다른
+  // mutation에서 유효하므로 전역 off 대신 이 한 줄만 억제한다.
+  // react-doctor-disable-next-line react-doctor/query-mutation-missing-invalidation
   return useMutation({
     mutationFn: (body: RouteRecommendRequestDto, context) =>
       recommendFn({ body }, context),
diff --git a/docs/spec/MSG-489.md b/docs/spec/MSG-489.md
index 0ce5a908..8bad1a04 100644
--- a/docs/spec/MSG-489.md
+++ b/docs/spec/MSG-489.md
@@ -447,3 +447,14 @@ Figma 정본: 섹션 15666:12401 — `15666:12402`(대기 + 출발 표시) · `1
 | 14429 문구 | 재제출 → 화면에 "요청이 너무 잦습니다. 잠시 후 다시 시도해주세요" |
 
 `P2`(무한 연기)와 §12의 14401 가드가 **같은 시나리오에서 동시에 입증**됐다 — 계속 방해해도 3.1초에 종결하고, 그 종결이 과대 뷰포트 요청이 아니라 안내로 끝난다. 남은 미검증은 "2차 대기 중 탭 숨김/복귀 시 마감이 가시 시간만 소모하는지" 하나이며 단위 테스트 3건이 고정한다.
+
+### 13-2. PR #105 리뷰 반영 — react-doctor 지적 1건 기각 (2026-08-29)
+
+`react-doctor/query-mutation-missing-invalidation` (warning, `use-route-recommend.ts`) — "useMutation에 캐시 무효화가 없어 사용자가 낡은 데이터를 본다, `onSuccess`에 `invalidateQueries`를 넣어라".
+
+**기각.** 근거 셋:
+1. `POST /api/routes/recommend`는 **읽기형**이다 — 생성 스펙이 "…보내면 지점 목록을 돌려준다"로 적고 있고 서버 리소스를 만들거나 고치지 않는다. body가 필요해 POST일 뿐이다.
+2. 응답은 쿼리 캐시가 아니라 `ai-route-store`(zustand)로 간다. 이 화면의 유일한 쿼리 `useOccupiedGridsQuery`는 추천 결과와 무관하다 — **낡아질 캐시가 없다**.
+3. 제안대로 넣으면 손해가 난다: `onSuccess`는 **1차 응답 분기(결과 미게시 + 2차 예약)에서도 실행**되므로, 무관한 격자 쿼리를 추천마다 재요청하고 오버레이를 흔든다.
+
+**규칙을 `doctor.config.json`에서 off 하지는 않았다** — `use-video-mutations`(5)·`use-profile-mutations`(3)·`use-badge-mutations`(1)이 실제로 `invalidateQueries`를 쓰는 등 레포 다른 곳에서는 규칙이 유효하고, 전역 off는 진짜 무효화 누락을 침묵시킨다. (덧붙여 v0.9.3 스캐너는 규칙 설정 자체를 무시한다 — CLAUDE.md 2026-08-28 행.) 대신 **호출부에 사유 주석**을 남겨 다음 스캔에서 같은 조사를 반복하지 않게 했다.