fix: 코드베이스 전체 import 정리 및 버그 수정 (Phase 6)

## 주요 변경사항

### 1. Scripts 및 CLI 업데이트
- **scripts/welcome.py**: llmkit → beanllm 모든 참조 변경
  - Import 경로: `from llmkit.ui` → `from beanllm.ui`
  - 환경 변수: LLMKIT_SHOW_BANNER → BEANLLM_SHOW_BANNER
  - GitHub URL: leebeanbin/llmkit → leebeanbin/beanllm
  - CLI 예제 코드 업데이트

- **publish.sh**: PyPI 배포 스크립트 업데이트
  - 패키지명: llmkit → beanllm
  - Ruff check 경로: src/llmkit → src/beanllm
  - PyPI/TestPyPI URL 업데이트
  - 설치 명령어: `pip install llmkit` → `pip install beanllm`

- **src/beanllm/utils/cli/cli.py**: 상대 import → 절대 import 변경
  - `from ...infrastructure` → `from beanllm.infrastructure`
  - `from ...ui` → `from beanllm.ui`

### 2. Import 문 표준화 (86개 파일)
- **모든 3-level 상대 import 제거**: `from ...` → `from beanllm.`
- **모든 4-level 상대 import 제거**: `from ....` → `from beanllm.`
- **모든 5-level 상대 import 제거**: `from .....` → `from beanllm.`

**영향받은 모듈:**
- domain/ (loaders, embeddings, evaluation, vision, vector_stores, retrieval, splitters, parsers, prompts, graph, finetuning)
- service/impl/ (모든 서비스 구현)
- infrastructure/ (hybrid, registry, models, scanner, inferrer)
- integrations/ (llamaindex, langgraph)
- dto/ (request, response)
- facade/, providers/, models/, utils/

### 3. 누락된 Import 버그 수정
- **docling_loader.py**: `os`, `Dict`, `Any` import 추가
- **csv.py**: `csv` 모듈 import 추가
- **directory.py**: 중복 `import re` 제거
- **jupyter.py**: 문자열 결합 버그 수정
  - 변경 전: `"\n\n" + "="*80 + "\n\n".join(content_parts)`
  - 변경 후: `("\n\n" + "="*80 + "\n\n").join(content_parts)`

### 4. PDF Loader Import 수정 (8개 파일)
- bean_pdf_loader.py
- engines/base.py, pymupdf_engine.py, pdfplumber_engine.py, marker_engine.py
- utils/layout_analyzer.py, markdown_converter.py
- vision_rag_service_impl.py

## 검증 결과
✅ 3-level 이상 상대 import: 144개 → 0개
✅ llmkit 참조 (src/scripts): 모두 제거
✅ requests import: 0개 (모두 httpx 사용)
✅ 누락된 import: 모두 추가
✅ 중복 import: 모두 제거

## 기술적 개선사항
- **유지보수성**: 절대 import로 코드 가독성 향상
- **안정성**: 누락된 import 버그 수정으로 런타임 에러 방지
- **일관성**: 전체 코드베이스 import 스타일 통일
- **호환성**: 패키지 리팩토링 후에도 import 경로 안정성 보장

Author: leebeanbin

publish.sh

@@ -1,11 +1,11 @@
 #!/bin/bash
 
-# llmkit PyPI 배포 스크립트
+# beanllm PyPI 배포 스크립트
 # 사용법: ./publish.sh [test|prod]
 
 set -e  # 에러 발생시 중단
 
-echo "🚀 llmkit PyPI 배포 스크립트"
+echo "🚀 beanllm PyPI 배포 스크립트"
 echo "=============================="
 
 # 인자 확인
@@ -27,7 +27,7 @@ echo ""
 echo "🔍 Step 2: 코드 품질 체크..."
 if command -v ruff &> /dev/null; then
     echo "  - Ruff 린트 실행 중..."
-    ruff check src/llmkit --fix || echo "  ⚠️  경고가 있지만 계속 진행합니다."
+    ruff check src/beanllm --fix || echo "  ⚠️  경고가 있지만 계속 진행합니다."
 else
     echo "  ⚠️  Ruff가 설치되어 있지 않습니다. 건너뜁니다."
 fi
@@ -67,14 +67,14 @@ ls -lh dist/
 echo ""
 if [ "$MODE" = "test" ]; then
     echo "🧪 Step 5: TestPyPI에 업로드 중..."
-    echo "  TestPyPI: https://test.pypi.org/project/llmkit/"
+    echo "  TestPyPI: https://test.pypi.org/project/beanllm/"
     python -m twine upload --repository testpypi dist/*
 
     echo ""
     echo "✅ TestPyPI 업로드 완료!"
     echo ""
     echo "테스트 설치 방법:"
-    echo "  pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ llmkit"
+    echo "  pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ beanllm"
 
 elif [ "$MODE" = "prod" ]; then
     echo "🚀 Step 5: PyPI에 업로드 중..."
@@ -90,9 +90,9 @@ elif [ "$MODE" = "prod" ]; then
         echo "✅ PyPI 업로드 완료!"
         echo ""
         echo "설치 방법:"
-        echo "  pip install llmkit"
+        echo "  pip install beanllm"
         echo ""
-        echo "PyPI 페이지: https://pypi.org/project/llmkit/"
+        echo "PyPI 페이지: https://pypi.org/project/beanllm/"
     else
         echo "❌ 배포가 취소되었습니다."
         exit 1

scripts/welcome.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-llmkit 환영 메시지 및 빠른 시작 가이드
+beanllm 환영 메시지 및 빠른 시작 가이드
 디자인 시스템 적용
 """
 import sys
@@ -10,7 +10,7 @@
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
 
 try:
-    from llmkit.ui import (
+    from beanllm.ui import (
         print_logo,
         OnboardingPattern,
         InfoPattern,
@@ -30,7 +30,7 @@ def print_welcome():
     """환영 메시지 출력 (디자인 시스템 적용)"""
     if not use_ui:
         print("=" * 70)
-        print("🚀 Welcome to llmkit!")
+        print("🚀 Welcome to beanllm!")
         print("=" * 70)
         return
 
@@ -43,7 +43,7 @@ def print_quick_start():
     if not use_ui:
         print("\n📚 Quick Start:")
         print("  1. Set environment variables: export OPENAI_API_KEY='your-key'")
-        print("  2. Try: python -c \"from llmkit import get_registry; print(get_registry().get_available_models())\"")
+        print("  2. Try: python -c \"from beanllm import Client; print(Client().list_models())\"")
         return
 
     # 온보딩 패턴 사용
@@ -56,15 +56,15 @@ def print_quick_start():
             },
             {
                 "title": "Try it out",
-                "description": "from llmkit import get_registry; r = get_registry()"
+                "description": "from beanllm import Client; client = Client()"
             },
             {
                 "title": "Use CLI",
-                "description": "llmkit list"
+                "description": "beanllm list"
             },
             {
                 "title": "Read docs",
-                "description": "https://github.com/yourusername/llmkit"
+                "description": "https://github.com/leebeanbin/beanllm"
             }
         ]
     )
@@ -98,14 +98,14 @@ def print_providers_status():
         import google.generativeai
         providers.append((StatusIcon.success(), "Gemini", Badge.success("Installed")))
     except ImportError:
-        providers.append((StatusIcon.warning(), "Gemini", "Optional - pip install llmkit[gemini]"))
+        providers.append((StatusIcon.warning(), "Gemini", "Optional - pip install beanllm[gemini]"))
 
     # Ollama
     try:
         import ollama
         providers.append((StatusIcon.success(), "Ollama", Badge.success("Installed")))
     except ImportError:
-        providers.append((StatusIcon.warning(), "Ollama", "Optional - pip install llmkit[ollama]"))
+        providers.append((StatusIcon.warning(), "Ollama", "Optional - pip install beanllm[ollama]"))
 
     console = get_console()
     table = Table(title="[bold cyan]📦 Provider Status[/bold cyan]", box=box.ROUNDED, show_header=True)
@@ -129,8 +129,8 @@ def main():
     # 추가 정보
     if use_ui:
         InfoPattern.render(
-            "💡 Tip: Set LLMKIT_SHOW_BANNER=true to see this on import",
-            details=["📚 Docs: https://github.com/yourusername/llmkit"]
+            "💡 Tip: Set BEANLLM_SHOW_BANNER=true to see this on import",
+            details=["📚 Docs: https://github.com/leebeanbin/beanllm"]
         )
 
 

src/beanllm/domain/embeddings/advanced.py

@@ -8,7 +8,7 @@
 from .utils import batch_cosine_similarity
 
 try:
-    from ...utils.logger import get_logger
+    from beanllm.utils.logger import get_logger
 except ImportError:
     import logging
 

src/beanllm/domain/embeddings/api_embeddings.py

@@ -19,7 +19,7 @@
 from .base import BaseAPIEmbedding
 
 try:
-    from ...utils.logger import get_logger
+    from beanllm.utils.logger import get_logger
 except ImportError:
     import logging
 

src/beanllm/domain/embeddings/base.py

@@ -9,7 +9,7 @@
 from typing import List, Optional, Tuple
 
 try:
-    from ...utils.logger import get_logger
+    from beanllm.utils.logger import get_logger
 except ImportError:
     import logging
 

src/beanllm/domain/embeddings/cache.py

@@ -7,8 +7,8 @@
 from typing import Any, Dict, List, Optional
 
 try:
-    from ...utils.cache import LRUCache
-    from ...utils.logger import get_logger
+    from beanllm.utils.cache import LRUCache
+    from beanllm.utils.logger import get_logger
 except ImportError:
     import logging
 

src/beanllm/domain/embeddings/factory.py

@@ -17,7 +17,7 @@
 )
 
 try:
-    from ...utils.logger import get_logger
+    from beanllm.utils.logger import get_logger
 except ImportError:
     import logging
 

src/beanllm/domain/embeddings/local_embeddings.py

@@ -17,7 +17,7 @@
 from .base import BaseLocalEmbedding
 
 try:
-    from ...utils.logger import get_logger
+    from beanllm.utils.logger import get_logger
 except ImportError:
     import logging
 

src/beanllm/domain/embeddings/utils.py

@@ -13,7 +13,7 @@
     np = None
 
 try:
-    from ...utils.logger import get_logger
+    from beanllm.utils.logger import get_logger
 except ImportError:
     import logging
 

src/beanllm/domain/evaluation/checklist.py

@@ -68,7 +68,7 @@ def _get_client(self):
         """클라이언트 lazy loading"""
         if self.client is None:
             try:
-                from ...facade.client_facade import create_client
+                from beanllm.facade.client_facade import create_client
 
                 self.client = create_client()
             except Exception: