fix(B05): 비중 끝값을 그 갈래와 같은 노선으로 — 예상 100 = 예상노선 추적 · 기울기 비교 순서를 기울기 순한과 같게(PLAN 23-3e)

- 비중 예상 100 · 토공 0 · 기울기 0 이면 예상노선 추적 선 그대로(전에는 후보 중 이격 최소 1153.26 m · 추적과 41.4 m 떨어짐)
- 사이 비중은 제약을 지킨 후보에서만 가중합으로 고름(추적 선은 끝값에서만 — 평지에서 사이 비중이 제약 넘는 추적 선을 고르던 것 막음)
- 비중의 기울기 몫 = 최대 먼저 · 평균은 같을 때만(기울기 순한과 같은 순서)
- 시험: 끝값 셋이 그 갈래와 거리 0.01 m 미만 · 노드 같음 · 비중을 옮기면 그 목표 값 단조(합성 언덕 · 랩탑_보조)

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

B05_Profile/B05_Profile_Engine_RouteInitial.py

@@ -8,8 +8,9 @@
                 제약 탐색은 하지 않고, 넘은 곳은 `metrics.violations` 에 뜬다.
   · earthwork — 후보 중 절 · 성토 합(`cut_m3 + fill_m3`) 최소.
   · gentle    — 후보 중 최대 종단기울기 최소(같으면 평균 최소).
-  · weighted  — 후보 중 예상노선 이격 · 절성토 · 기울기(최대 + 평균) 세 값을 후보 범위로
-                0~1 정규화해 비중(합 100)으로 더한 값 최소.
+  · weighted  — 후보 중 예상노선 이격 · 절성토 · 기울기(최대, 같으면 평균) 세 값을 후보
+                범위로 0~1 정규화해 비중(합 100)으로 더한 값 최소. 끝값은 그 갈래와 같은 선 —
+                토공 100 = 토공 최소 · 기울기 100 = 기울기 순한 · 예상 100 = 추적 선 그대로(23-3e).
 
 후보 = 목표 비중(토공 · 기울기 · 이격 · 기본 비중)을 바꿔 가며 격자 탐색(`..._Search`)한 노선들.
 갈래는 **비교값(화면에 보이는 값)으로 고른다** — 탐색 목표(4 m 링크 기울기 · 옆경사)는 비교값
@@ -230,12 +231,16 @@ def generate_initial_route(
             follow=follow,
         )
 
-    bound = None
-    if mode == "follow":
+    def follow_line() -> tuple[Any, dict[str, Any]]:
         # 예상노선 추적 = 전처리 초기값(`planned_route_initial.csv`)과 같은 규칙 · 같은 입력 →
         # 같은 선(`_write_planned_polyline` 기본값). 제약은 따지지 않고 넘은 곳만 목록에 뜸.
         outline = build_planned_polyline(expected, min_radius_m=min_radius_m)
-        metrics = measure(outline, None, follow=True)
+        return outline, measure(outline, None, follow=True)
+
+    bound = None
+    # 비중 예상 100 = 예상노선 추적 그 선(PLAN 23-3e) — 사이 비중은 제약 지킨 후보에서만 고름
+    if mode == "follow" or (mode == "weighted" and used["earthwork"] == used["grade"] == 0):
+        outline, metrics = follow_line()
     else:
         key = _pool_key(
             expected, terrain, streams, max_grade, min_radius_m, stream_offset, grade_smooth
@@ -354,7 +359,8 @@ def _pick(
         return metrics["cut_m3"] + metrics["fill_m3"]
 
     def grade(metrics: dict[str, Any]) -> float:
-        return metrics["max_grade_pct"] + metrics["avg_grade_pct"]
+        # 최대 먼저 · 평균은 같을 때만(기울기 순한과 같은 순서 — 값은 0.01 단위라 평균 몫 < 0.01)
+        return metrics["max_grade_pct"] + 1e-4 * metrics["avg_grade_pct"]
 
     def offset(metrics: dict[str, Any]) -> float:
         return metrics["offset_avg_m"]

resources/tester/test_route_initial.py

@@ -113,6 +113,60 @@ def test_each_branch_best_at_own_goal(hill: Terrain) -> None:
     assert all(top <= r["metrics"]["max_grade_pct"] + 1e-6 for r in runs.values())
 
 
+# 비중 끝값 · 단조(PLAN 23-3e) — 예상 · 토공 · 기울기 한쪽 100 이면 그 갈래와 같은 선
+ENDS = {
+    "follow": {"expected": 100, "earthwork": 0, "grade": 0},
+    "earthwork": {"expected": 0, "earthwork": 100, "grade": 0},
+    "gentle": {"expected": 0, "earthwork": 0, "grade": 100},
+}
+# 예상 100 → 0(나머지 반반) · 기울기 100 → 토공 100
+TOWARD_OTHERS = [
+    (100, 0, 0),
+    (90, 5, 5),
+    (75, 12.5, 12.5),
+    (50, 25, 25),
+    (25, 37.5, 37.5),
+    (0, 50, 50),
+]
+TOWARD_EARTH = [(0, 0, 100), (0, 25, 75), (0, 50, 50), (0, 75, 25), (0, 100, 0)]
+
+
+def _gap(first: dict, second: dict) -> float:
+    return LineString(first["planned"]).hausdorff_distance(LineString(second["planned"]))
+
+
+def _check_weight_ends(run) -> None:
+    for mode, weights in ENDS.items():
+        end, own = run("weighted", weights), run(mode)
+        assert _gap(end, own) < 0.01, (mode, _gap(end, own))
+        assert end["nodes"] == own["nodes"]
+        assert end["metrics"]["length_m"] == own["metrics"]["length_m"]
+
+
+def _check_weight_monotone(run) -> None:
+    """비중을 한쪽으로 옮기면 그 목표 값은 나빠지지 않음(후보가 같으니 가중합 최소의 성질)."""
+
+    def metrics(steps):
+        keys = ("expected", "earthwork", "grade")
+        return [run("weighted", dict(zip(keys, step)))["metrics"] for step in steps]
+
+    offsets = [m["offset_avg_m"] for m in metrics(TOWARD_OTHERS)]
+    assert offsets == sorted(offsets), offsets
+    earth = metrics(TOWARD_EARTH)
+    cuts = [m["cut_m3"] + m["fill_m3"] for m in earth]
+    tops = [m["max_grade_pct"] for m in earth]
+    assert cuts == sorted(cuts, reverse=True), cuts
+    assert tops == sorted(tops), tops
+
+
+def test_weight_ends_match_branches(hill: Terrain) -> None:
+    _check_weight_ends(lambda mode, weights=None: _run(hill, mode, weights=weights))
+
+
+def test_weight_moves_monotone(hill: Terrain) -> None:
+    _check_weight_monotone(lambda mode, weights=None: _run(hill, mode, weights=weights))
+
+
 def test_follow_stays_on_expected_where_allowed() -> None:
     """고른 경사(2 %) — 추종은 예상노선을 그대로(격자 칸 반 안쪽)."""
     ramp = _terrain(lambda xx, yy: 0.02 * xx)
@@ -301,18 +355,19 @@ def project_runs() -> dict:
     streams = stream_lines(_reproject_features(features, to_metric))
     route = read_planned_route_csv(expected_route_csv_path(PROJECT))
     expected = [(float(v.x), float(v.y)) for v in route.vertices]
-    return {
-        mode: generate_initial_route(
+
+    def run(mode: str, weights: dict | None = None) -> dict:
+        return generate_initial_route(
             expected,
             terrain,
             streams,
             mode=mode,
-            weights=None,
+            weights=weights,
             max_grade=GRADE,
             min_radius_m=RADIUS,
         )
-        for mode in MODES
-    }
+
+    return {**{mode: run(mode) for mode in MODES}, "run": run}
 
 
 def test_project_follow_is_preprocess_initial(project_runs: dict) -> None:
@@ -331,7 +386,7 @@ def test_project_follow_is_preprocess_initial(project_runs: dict) -> None:
 
 def test_project_branches_differ_by_goal(project_runs: dict) -> None:
     """갈래끼리 선이 수 m 이상 갈리고 · 각 갈래가 제 목표 비교값에서 가장 좋음."""
-    searched = {mode: project_runs[mode] for mode in SEARCHED}
+    searched = {mode: project_runs[mode] for mode in SEARCHED}  # 비중은 50/25/25
     for first in SEARCHED:
         for second in SEARCHED:
             if first < second:
@@ -344,3 +399,13 @@ def test_project_branches_differ_by_goal(project_runs: dict) -> None:
     assert all(top <= r["metrics"]["max_grade_pct"] for r in searched.values())
     for result in searched.values():
         assert result["metrics"]["over_limit"]["total"] == len(result["metrics"]["violations"])
+
+
+def test_project_weight_ends_match_branches(project_runs: dict) -> None:
+    """랩탑_보조 — 비중 100/0/0 = 추적(1078.01 m) · 0/100/0 = 토공 최소 · 0/0/100 = 기울기 순한."""
+    _check_weight_ends(project_runs["run"])
+    assert project_runs["run"]("weighted", ENDS["follow"])["metrics"]["length_m"] == 1078.01
+
+
+def test_project_weight_moves_monotone(project_runs: dict) -> None:
+    _check_weight_monotone(project_runs["run"])