Files
kebab/crates/kebab-config/tests/migrate_v3.rs
altair823 da323af87b refactor(config): OCR 중복 제거 — 공유 [ingest.ocr] 엔진 블록 + v4→v5 마이그레이션
Phase 2 Unit 1. OcrCfg(image) 13필드가 PdfOcrCfg(pdf) 와 전부 중복(image 고유
0, pdf 고유 4) + apply_env 에 KEBAB_IMAGE_OCR_*/KEBAB_PDF_OCR_* 27 arm 복제를
제거한다.

- 신규 SharedOcrEngineCfg(13 공유 필드, 전부 Option, default None) = [ingest.ocr].
  엔진 설정 단일 출처. image/pdf 블록은 on/off 토글 + override.
- load-time resolution(Config::resolve_ocr, from_file 호출): 공유 필드가 Some 이고
  미디어 블록이 그 키 미명시면 concrete OcrCfg/PdfOcrCfg 로 overlay(presence 는
  toml::Value 로 판정; 미디어 > 공유 > 내장 default). struct 필드는 그대로 두고
  엔진 필드에 #[serde(default)] 만 추가(slim 블록 파싱) → image(gemma4:e4b/1600)
  vs pdf(qwen2.5vl:3b/2048) 미디어별 기본값 보존.
- resolver Config::image_ocr()/pdf_ocr() 추가. consumer(kebab-parse-image,
  kebab-app build_*_ocr_engine·ingest gate·pdf_ocr_apply·ingest_config_signature)가
  전부 경유 → god-struct 직접 read 제거.
- apply_env: 27 arm → 공유 KEBAB_OCR_* 12 arm(image+pdf 동시) + pdf 고유 4 arm +
  미디어별 KEBAB_IMAGE_OCR_ENABLED/KEBAB_PDF_OCR_ENABLED.
- step_4_to_5: [ingest.image.ocr] 12 엔진 키를 [ingest.ocr] 로 move_table(enabled
  제외). pdf 블록 무손상(reconcile 이 채워 공유 overlay 오염 X). annotated_default
  도 동일 통합으로 v5 canonical 형상. CURRENT_SCHEMA_VERSION=5.
- v4→v5 round-trip 테스트(비-default image engine 보존 + pdf 오염 X + 멱등). effective
  OCR 바이트 동일 → ingest_config_signature 불변 → 강제 재색인 없음.

검증: clippy --workspace --all-targets 0 / kebab-config·kebab-parse-image·
kebab-parse-pdf·kebab-app 테스트 pass. surface: README [ingest.ocr] 절 + SMOKE
config 블록 + DOGFOOD env + HOTFIXES dated entry.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012Mc6W1fgsrbFKTsqA6P8La
2026-06-24 11:03:39 +00:00

66 lines
3.1 KiB
Rust

//! v3 마이그레이션 무손실 골든 — 사용자 실제 v2 config.
//!
//! 불변식: 사용자가 손본 값·주석·대안(commented) 줄이 [ingest.*] relocation
//! 후에도 전부 보존되고, v3 Config 로 파싱했을 때 같은 값을 내며, 재실행이
//! 멱등이어야 한다.
use kebab_config::migrate::migrate_document;
const USER_V2: &str = include_str!("fixtures/user_v2_config.toml");
#[test]
fn user_v2_migrates_losslessly() {
let out = migrate_document(USER_V2);
assert_eq!(out.from_schema_version, 2);
// v2 → CURRENT(=5): v3 의 [ingest.*] relocation, v4 의
// [[workspace.sources]] default source 미러링, v5 의 공유 [ingest.ocr]
// 통합까지 적용된다.
assert_eq!(
out.to_schema_version,
kebab_config::migrate::CURRENT_SCHEMA_VERSION
);
let t = &out.new_text;
// 사용자 값 보존.
assert!(t.contains("root = \"/Users/user/Obsidian/Default\""), "{t}");
// v4: workspace.root → [[workspace.sources]] id=default 미러링.
assert!(t.contains("[[workspace.sources]]"), "v4 sources 누락:\n{t}");
assert!(t.contains("id = \"default\""), "default source 누락:\n{t}");
assert!(t.contains("model = \"snowflake-arctic-embed2\""));
assert!(t.contains("endpoint = \"http://192.168.0.2:11943\""));
// 사용자 주석/대안 줄 보존.
assert!(t.contains("# engine = \"ollama-vision\""), "대안 주석 유실:\n{t}");
assert!(t.contains("# provider = \"candle\""));
// 새 위치.
assert!(t.contains("[ingest.image.ocr]"));
assert!(t.contains("[ingest.pdf.ocr]"));
assert!(t.contains("[ingest.chunking]"));
assert!(t.contains("[ingest.image.caption]"));
// 옛 top-level 위치 제거.
assert!(!t.contains("\n[chunking]"));
assert!(!t.contains("\n[image.ocr]"));
assert!(!t.contains("\n[indexing]"));
// v5: 공유 [ingest.ocr] 통합 후 image 엔진 키는 공유 블록에 산다.
assert!(t.contains("[ingest.ocr]"), "공유 OCR 블록 누락:\n{t}");
// effective 값은 from_file(공유 OCR resolution 포함)로 검증한다 —
// image 의 engine=paddle-onnx 가 공유 블록으로 끌어올려진 뒤에도 보존.
let dir = std::env::temp_dir().join(format!("kebab_mv3_{}", std::process::id()));
std::fs::create_dir_all(&dir).unwrap();
let p = dir.join("config.toml");
std::fs::write(&p, t).unwrap();
let cfg = kebab_config::Config::from_file(&p).expect("v5 from_file");
assert!(cfg.image_ocr().enabled);
assert_eq!(cfg.image_ocr().engine, "paddle-onnx");
assert_eq!(cfg.models.embedding.model, "snowflake-arctic-embed2");
assert_eq!(cfg.models.llm.endpoint, "http://192.168.0.2:11943");
// pdf paddle 값 보존(v2 비대칭 → pdf 대칭 키로 복사). user 의 pdf.ocr 는
// engine=paddle-onnx 이고 자체 det_model 없으므로 번들(None) 유지.
assert_eq!(cfg.pdf_ocr().engine, "paddle-onnx");
// 멱등.
let again = migrate_document(t);
assert!(!again.changed(), "재실행 변경: {:?}", again.changes);
assert_eq!(again.new_text, *t);
}