"""재채점 번들이 놓일 곳 (계획 2026-09-26 L3b §2.1 "미러 루트 층"). - 미러 영역 = `//accounts///eval/` — `mirror_root` 는 **버킷의 부모**(`poc_bundle.mirror.mirror_bundle(root=)` 와 같은 뜻, 기본 `blob_mirror_root()`). 경로 조각은 `poc_bundle.data.layout` 의 규칙으로만 만든다(슬러그 검사 포함). - `` 모드 기본 출력: 번들이 `…/eval/bundles/` 에 있으면 `…/eval/evaluations`(eval-wrap 과 같은 규칙), 아니면 호출자가 `--out` 을 줘야 한다. """ from __future__ import annotations from pathlib import Path from poc_bundle.data.errors import DataConfigError from poc_bundle.data.layout import SUBPREFIX, case_prefix from poc_bundle.home import blob_mirror_root from poc_bundle.mirror import DEFAULT_BUCKET BUNDLES_AREA = "bundles" EVALUATIONS_AREA = "evaluations" class RescorePathError(ValueError): """재채점 입력·출력 위치를 정할 수 없다(잘못된 case 슬러그·기본 출력 위치 없음).""" def parse_case_key(case_key: str) -> tuple[str, str]: """`a/c` → (account, case). 슬러그 규칙은 `case_prefix` 가 본다.""" parts = case_key.split("/") if isinstance(case_key, str) else [] if len(parts) != 2: raise RescorePathError(f"case must be /, got {case_key!r}") account, case = parts try: case_prefix(account, case) except DataConfigError as exc: raise RescorePathError(str(exc)) from exc return account, case def mirror_area_dir( mirror_root: Path | None, account: str, case: str, area: str, *, bucket: str = DEFAULT_BUCKET ) -> Path: """미러의 한 case 영역 디렉토리(`bundles` 또는 `evaluations`).""" if area not in (BUNDLES_AREA, EVALUATIONS_AREA): raise RescorePathError(f"unknown mirror area {area!r}") try: prefix = case_prefix(account, case) except DataConfigError as exc: raise RescorePathError(str(exc)) from exc return resolve_mirror_root(mirror_root) / bucket / prefix / SUBPREFIX[area] def resolve_mirror_root(mirror_root: Path | None) -> Path: """미러 버킷의 부모 절대 경로 — None 이면 데이터 홈의 `blob-mirror`.""" return blob_mirror_root() if mirror_root is None else Path(mirror_root).expanduser().resolve() def default_evaluations_dir(run_bundle_dir: Path) -> Path | None: """`…/eval/bundles/` → `…/eval/evaluations`. 그 모양이 아니면 None(호출자가 `--out` 을 요구한다).""" resolved = Path(run_bundle_dir).resolve() parent = resolved.parent if parent.name == Path(SUBPREFIX[BUNDLES_AREA]).name and parent.parent.name == "eval": return parent.parent / Path(SUBPREFIX[EVALUATIONS_AREA]).name return None