fix(B05): 초기노선 갈래 화면을 서버 길 모양(PLAN 20장 API 줄)에 맞춤

- 요청 { mode, weights?{expected, earthwork, grade} } — logic · slope 가정을 버림
- 비교값 avg_grade_pct · over_limit.total · offset_avg_m, 기준값 pending(비면 확정) 읽기
- [확인] 몸통 initial 도 { mode, weights }
- 시험 test_b05_routeedit_initial.py 를 서버 답 모양으로

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015sCeZz8z8YnbovsKgn7HK7

B05_Profile/B05_Profile_Api_RouteInitial.ts

@@ -2,11 +2,11 @@
  * B05_Profile_Api_RouteInitial.ts
  * 초기노선 갈래 요청(계획서 20) — 로직 하나를 골라 서버가 새 계획노선 노드를 낸다.
  *
- *   POST /projects/{id}/route/initial  { logic, weights? } → 노드 · 비교값 · 공통 제약 기준값
+ *   POST /projects/{id}/route/initial  { mode, weights? } → 노드 · 비교값 · 공통 제약 기준값
  *
  * 계산 자리는 **서버 단독**(CLAUDE.md 5장 ③) — 화면은 부르고, 받은 노드를 편집 캐시에 싣고,
- * 받은 비교값·기준값을 보이기만 한다. 서버 길은 sub3 몫이라 모양이 오면 `normalizeRouteInitial`
- * (`_RouteEdit_Initial_Model`) 한 곳만 맞춘다.
+ * 받은 비교값·기준값을 보이기만 한다. 모양은 계획서 20 「API」 줄(서버 `initial_route`) —
+ * 답을 펴는 자리는 `normalizeRouteInitial`(`_RouteEdit_Initial_Model`) 한 곳이다.
  * ========================================================================== */
 
 import { requestJson } from "./B05_Profile_Api_Replan";
@@ -21,11 +21,11 @@ export type RouteInitialLogic = "follow" | "earthwork" | "gentle" | "weighted";
 export interface RouteInitialWeights {
   expected: number;
   earthwork: number;
-  slope: number;
+  grade: number;
 }
 
 export interface RouteInitialRequest {
-  logic: RouteInitialLogic;
+  mode: RouteInitialLogic;
   weights?: RouteInitialWeights;
 }
 

B05_Profile/B05_Profile_UI_RouteEdit_Initial.ts

@@ -35,7 +35,7 @@ import {
 const WEIGHT_NAME: Record<WeightKey, string> = {
   expected: "예상",
   earthwork: "토공",
-  slope: "기울기",
+  grade: "기울기",
 };
 
 export interface InitialPanelParams {
@@ -51,7 +51,7 @@ export interface InitialPanel {
   /** 노선을 읽었다 — 창을 연 편집값과 「고친 노선인가」를 받아 단추를 연다. */
   ready: (opening: RouteEditSnapshot, edited: boolean) => void;
   /** [확인]에 실어 보낼 지금 초기값. */
-  current: () => { logic: RouteInitialLogic; weights: RouteInitialWeights | null };
+  current: () => { mode: RouteInitialLogic; weights: RouteInitialWeights | null };
   /** [취소] — 이 창에서 바꾼 초기값을 창을 열 때 것으로 되돌린다. */
   cancel: () => void;
   /** [확인] 뒤 결과 캐시를 비웠다 — 초기값은 새 노선의 출발점이라 다시 적는다. */
@@ -120,7 +120,7 @@ export function createInitialPanel(params: InitialPanelParams): InitialPanel {
       box.querySelector<HTMLOutputElement>(`[data-weight-out="${key}"]`)!.value = `${weights[key]}`;
     }
     box.querySelector<HTMLElement>("[data-weight-sum]")!.textContent =
-      `합 ${weights.expected + weights.earthwork + weights.slope}`;
+      `합 ${weights.expected + weights.earthwork + weights.grade}`;
     buttons.forEach((button) => {
       button.disabled = busy || !opening;
     });
@@ -136,7 +136,7 @@ export function createInitialPanel(params: InitialPanelParams): InitialPanel {
     nowLine.textContent = `${choiceLabel(logic, sent)} 셈하는 중…`;
     try {
       const response = await fetchRouteInitial(projectId, {
-        logic,
+        mode: logic,
         ...(sent ? { weights: sent } : {}),
       });
       if (!box.isConnected) return; // 그 사이 창이 닫혔다.
@@ -195,7 +195,7 @@ export function createInitialPanel(params: InitialPanelParams): InitialPanel {
       edited = wasEdited;
       render();
     },
-    current: () => ({ logic: choice?.logic ?? "follow", weights: choice?.weights ?? null }),
+    current: () => ({ mode: choice?.logic ?? "follow", weights: choice?.weights ?? null }),
     cancel: () => writeInitialChoice(projectId, openingChoice),
     keep: () => writeInitialChoice(projectId, choice),
   };

B05_Profile/B05_Profile_UI_RouteEdit_Initial_Model.ts

@@ -19,8 +19,8 @@ export const LOGIC_LABEL: Record<RouteInitialLogic, string> = {
 };
 
 /** 비중 기본값(%) — 계획서 20 사용자 확정 50/25/25. */
-export const DEFAULT_WEIGHTS: RouteInitialWeights = { expected: 50, earthwork: 25, slope: 25 };
-export const WEIGHT_KEYS = ["expected", "earthwork", "slope"] as const;
+export const DEFAULT_WEIGHTS: RouteInitialWeights = { expected: 50, earthwork: 25, grade: 25 };
+export const WEIGHT_KEYS = ["expected", "earthwork", "grade"] as const;
 export type WeightKey = (typeof WEIGHT_KEYS)[number];
 
 /** 한 비중을 옮기면 나머지 둘이 **지금 비율대로** 나눠 합 100 을 지킨다(정수 %). */
@@ -35,7 +35,7 @@ export function rebalanceWeights(
   const pool = weights[first] + weights[second];
   const firstShare = pool > 0 ? Math.round((rest * weights[first]) / pool) : Math.round(rest / 2);
   const out = { ...weights, [key]: fixed, [first]: firstShare, [second]: rest - firstShare };
-  return { expected: out.expected, earthwork: out.earthwork, slope: out.slope };
+  return { expected: out.expected, earthwork: out.earthwork, grade: out.grade };
 }
 
 /** 결과 비교값 — 서버가 셈해 준 것을 보이기만 한다. 없는 칸은 null. */
@@ -49,7 +49,7 @@ export interface InitialMetrics {
   offsetM: number | null;
 }
 
-/** 공통 제약 기준값 — 서버가 준 값. `confirmed` 가 거짓이면 지식DB 후보(사용자 확정 대기). */
+/** 공통 제약 기준값 — 서버가 준 값. `pending` 이 남아 `confirmed` 가 거짓이면 지식DB 후보. */
 export interface InitialCriteria {
   maxGradePct: number | null;
   minRadiusM: number | null;
@@ -69,14 +69,7 @@ export interface InitialChoice {
 const num = (value: unknown): number | null =>
   typeof value === "number" && Number.isFinite(value) ? value : null;
 
-/** 여러 이름 중 먼저 있는 숫자 — 서버 낱말이 정해지기 전이라 흔한 이름을 함께 본다. */
-function pick(source: Record<string, unknown>, ...names: string[]): number | null {
-  for (const name of names) {
-    const value = num(source[name]);
-    if (value !== null) return value;
-  }
-  return null;
-}
+const pick = (source: Record<string, unknown>, name: string): number | null => num(source[name]);
 
 /** 노드 목록을 편집값 한 벌로 편다 — 곡선 성분이 있으면 `/route/plan` 과 같은 규칙으로. */
 function snapshotOf(nodes: unknown[], curves: unknown): RouteEditSnapshot {
@@ -105,39 +98,37 @@ export function normalizeRouteInitial(
   logic: RouteInitialLogic,
   weights: RouteInitialWeights | null,
 ): InitialChoice {
+  // 모양은 계획서 20 「API」 줄 — 노드 · 곡선은 `/route/plan` 과 같은 꼴이다.
   const body = (response ?? {}) as Record<string, unknown>;
-  const nodes = Array.isArray(body.nodes)
-    ? body.nodes
-    : Array.isArray(body.vertices)
-      ? body.vertices
-      : [];
-  const snapshot = snapshotOf(nodes, body.curves);
+  const snapshot = snapshotOf(Array.isArray(body.nodes) ? body.nodes : [], body.curves);
   if (snapshot.planned.length < 2 || snapshot.planned.some(([x, y]) => !Number.isFinite(x + y))) {
     throw new Error("서버가 낸 초기노선에 노드가 모자랍니다.");
   }
   const m = (body.metrics ?? {}) as Record<string, unknown>;
   const c = (body.criteria ?? {}) as Record<string, unknown>;
+  const over = (m.over_limit ?? {}) as Record<string, unknown>;
   return {
     logic,
     weights,
     snapshot,
     metrics: body.metrics
       ? {
-          lengthM: pick(m, "length_m", "total_length_m"),
-          maxGradePct: pick(m, "max_grade_pct", "max_slope_pct"),
-          meanGradePct: pick(m, "mean_grade_pct", "mean_slope_pct", "avg_grade_pct"),
-          cutM3: pick(m, "cut_m3", "cut_volume_m3"),
-          fillM3: pick(m, "fill_m3", "fill_volume_m3"),
-          overLimitCount: pick(m, "over_limit_count", "violation_count", "exceed_count"),
-          offsetM: pick(m, "offset_mean_m", "expected_offset_m", "offset_m"),
+          lengthM: pick(m, "length_m"),
+          maxGradePct: pick(m, "max_grade_pct"),
+          meanGradePct: pick(m, "avg_grade_pct"),
+          cutM3: pick(m, "cut_m3"),
+          fillM3: pick(m, "fill_m3"),
+          overLimitCount: pick(over, "total"),
+          offsetM: pick(m, "offset_avg_m"),
         }
       : null,
     criteria: body.criteria
       ? {
-          maxGradePct: pick(c, "max_grade_pct", "max_slope_pct"),
+          maxGradePct: pick(c, "max_grade_pct"),
           minRadiusM: pick(c, "min_radius_m"),
-          streamOffsetM: pick(c, "stream_offset_m", "stream_clearance_m"),
-          confirmed: c.confirmed === true,
+          streamOffsetM: pick(c, "stream_offset_m"),
+          // 확정 대기 칸 이름 목록이 비어야 확정이다.
+          confirmed: Array.isArray(c.pending) && c.pending.length === 0,
         }
       : null,
   };
@@ -146,7 +137,7 @@ export function normalizeRouteInitial(
 /** 「현재 초기값: ○○」의 ○○ — 비중 계산이면 비중까지. */
 export function choiceLabel(logic: RouteInitialLogic, weights: RouteInitialWeights | null): string {
   if (logic !== "weighted" || !weights) return LOGIC_LABEL[logic];
-  return `${LOGIC_LABEL.weighted} ${weights.expected}/${weights.earthwork}/${weights.slope}`;
+  return `${LOGIC_LABEL.weighted} ${weights.expected}/${weights.earthwork}/${weights.grade}`;
 }
 
 const fixed = (value: number | null, digits: number, unit: string): string =>