IMPROVEMENT Phase A~D + Phase 2 전체 반영

## IMPROVEMENT (Phase A~D)
- A-1: 4단계 Sonnet 디자인 조정 (_adjust_design) — CSS 변수 cascade
- A-2: 5단계 HTML 전문 프롬프트 전달
- A-3: shrink/expand 하드코딩 제거 → Sonnet target_ratio 기반
- A-4: rewrite action 구현
- A-5: overflow: visible (area 레벨 텍스트 잘림 방지)
- A-6: object-fit cover → contain (이미지 crop 방지)
- A-7: table-layout: fixed
- A-8: container query 폰트 스케일링
- B-1: details-block 템플릿 신규 (CSS 변수만 사용)
- B-2: 인쇄 시 details 자동 펼침 JS
- B-3: catalog에 details-block 등록
- B-4/B-5: images[]/tables[] 상세 판단 + fallback 3곳 동기화
- B-8: fallback card-grid → topic-header + char_guide 제거
- C-1: CLAUDE.md gradient 원칙 완화
- C-3: border-radius 9개 파일 var(--radius) 통일
- C-4: box-shadow 2레벨 → 1레벨
- D-0: 이미지 경로 입력 UI + API base_path
- D-1: Pillow 의존성 + image_utils.py
- D-2~D-4: 이미지 비율/축소방지 프롬프트 전달
- D-5: HTML에 이미지 base64 삽입

## Phase 2 (다른 Claude 작업)
- P2-A: FAISS 블록 검색 (bge-m3, 46개 블록)
- P2-B: SVG N개 자동 배치 (svg_calculator.py)
- P2-C: Opus 블록 추천 (Kei API 경유)
- P2-D: 5단계 재검토 루프 강화 (MAX_REVIEW_ROUNDS=2)
- P2-E: details-block fallback 연동

## 버그 수정 (BF-8~10)
- BF-8: 컨테이너 예산 기반 블록 배치
- BF-9: grid와 Sonnet 역할 분리
- BF-10: catalog mtime 캐시 자동 갱신

## 블록 라이브러리
- 46개 블록 (6 카테고리), catalog/BLOCK_SLOTS/INDEX 동기화
- 구 블록 제거 (quote-block, card-grid, comparison)
- 13개 _legacy 블록 보존

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

src/image_utils.py

@@ -0,0 +1,138 @@
+"""이미지 크기 측정 + HTML 이미지 삽입 유틸리티.
+
+MDX 콘텐츠에서 이미지 참조를 추출하고, 로컬 파일의 크기를 Pillow로 측정한다.
+다운로드 HTML에서 이미지가 보이도록 base64 data URI로 변환한다.
+"""
+from __future__ import annotations
+
+import base64
+import logging
+import re
+from pathlib import Path
+from typing import Any
+
+logger = logging.getLogger(__name__)
+
+# 웹 표준 이미지 포맷
+IMAGE_EXTENSIONS = {".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg"}
+
+MIME_MAP = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+}
+
+
+def get_image_sizes(content: str, base_path: str) -> list[dict[str, Any]]:
+    """콘텐츠에서 이미지 참조를 추출하고 로컬 파일 크기를 측정한다.
+
+    Args:
+        content: MDX/텍스트 콘텐츠
+        base_path: 이미지 파일 기준 폴더 경로
+
+    Returns:
+        [{"path": "/assets/images/DX1.png", "width": 800, "height": 600,
+          "ratio": 1.33, "orientation": "landscape"}]
+    """
+    if not base_path:
+        return []
+
+    base = Path(base_path)
+    images: list[dict[str, Any]] = []
+
+    for match in re.finditer(r"!\[.*?\]\((.*?)\)", content):
+        rel_path = match.group(1).strip()
+        abs_path = base / rel_path.lstrip("/")
+
+        if abs_path.suffix.lower() not in IMAGE_EXTENSIONS:
+            continue
+
+        if not abs_path.exists():
+            logger.warning(f"이미지 파일 미발견: {abs_path}")
+            images.append({
+                "path": rel_path,
+                "width": 0,
+                "height": 0,
+                "ratio": 0,
+                "orientation": "not_found",
+            })
+            continue
+
+        try:
+            from PIL import Image
+
+            with Image.open(abs_path) as img:
+                w, h = img.size
+
+            ratio = round(w / h, 2) if h > 0 else 1.0
+            if ratio > 1.2:
+                orientation = "landscape"
+            elif ratio < 0.8:
+                orientation = "portrait"
+            else:
+                orientation = "square"
+
+            images.append({
+                "path": rel_path,
+                "width": w,
+                "height": h,
+                "ratio": ratio,
+                "orientation": orientation,
+            })
+            logger.info(f"이미지 크기: {rel_path} → {w}×{h}px ({orientation})")
+
+        except Exception as e:
+            logger.warning(f"이미지 크기 측정 실패 ({rel_path}): {e}")
+            images.append({
+                "path": rel_path,
+                "width": 0,
+                "height": 0,
+                "ratio": 0,
+                "orientation": "error",
+            })
+
+    return images
+
+
+def embed_images(html: str, base_path: str) -> str:
+    """HTML의 이미지 src를 base64 data URI로 변환한다.
+
+    다운로드된 HTML 파일에서 로컬 이미지가 보이도록
+    상대 경로를 base64 인라인으로 교체한다.
+
+    Args:
+        html: 렌더링된 HTML
+        base_path: 이미지 파일 기준 폴더 경로
+
+    Returns:
+        이미지가 base64로 삽입된 HTML
+    """
+    if not base_path:
+        return html
+
+    base = Path(base_path)
+
+    def replace_src(match: re.Match) -> str:
+        src = match.group(1)
+        abs_path = base / src.lstrip("/")
+
+        if not abs_path.exists():
+            return match.group(0)
+
+        suffix = abs_path.suffix.lower()
+        mime = MIME_MAP.get(suffix, "application/octet-stream")
+
+        try:
+            data = base64.b64encode(abs_path.read_bytes()).decode()
+            return f'src="data:{mime};base64,{data}"'
+        except Exception:
+            return match.group(0)
+
+    return re.sub(
+        r'src="(/[^"]+\.(?:png|jpg|jpeg|gif|webp|svg))"',
+        replace_src,
+        html,
+    )