autorig-preflight

name	autorig-preflight
description	GPU 전 프리플라이트 게이트 — YAML·마스터·See-through 레포·Modal 크레덴셜·의존성을 CPU로 전수 검사해 $0.08~0.17 GPU 소비 전에 막을 수 있는 실패를 모두 차단한다. 트리거 — "파이프라인 실행 전 체크", "GPU 전 게이트", "프리플라이트", "preflight", "파이프라인 돌리기 전", "See-through 전 검증", "캐릭터 파이프라인 준비됐나", "character yaml 검증".

AUTORIG 파이프라인 프리플라이트 게이트

GPU(A100 See-through, $0.08~0.17/캐릭터)를 태우기 전에 결정론으로 막을 수 있는 실패를 모두 잡는다. 모든 검사 CPU전용·비용 0.

실행

# 최소 (YAML + 레포 + 크레덴셜 + 의존성)
python3 scripts/preflight_check.py \
  --character-spec characters/<id>.yaml

# 풀 (마스터 PNG 포함)
python3 scripts/preflight_check.py \
  --character-spec characters/<id>.yaml \
  --master experiments/<exp>/true_master_2048.png

# JSON 리포트 저장
python3 scripts/preflight_check.py \
  --character-spec characters/<id>.yaml \
  --master experiments/<exp>/true_master_2048.png \
  --out experiments/<exp>/reports/preflight.json

exit 0 = FAIL 없음 (GPU 진입 OK). exit 1 = FAIL 1개 이상 (차단).

게이트 목록

게이트	수준	내용
YAML 파일 존재·파싱	FAIL	파일 없거나 파싱 오류
필수 필드 (id·name·appearance·colors)	FAIL	누락 시 차단
V2 확장 필드 (body_spec 등)	WARN	미작성 → analyze_master_png.py 자동채움 가능
skip_deghost 확인	PASS 정보	긴 머리 캐릭터 알림
마스터 PNG 존재·정사각·해상도≥1024	FAIL/WARN	미지정=WARN, 없음=FAIL
See-through 레포·inference_psd.py	FAIL	레포 없으면 P1 불가
Modal 크레덴셜 (~/.modal.toml · 환경변수)	WARN	없으면 modal setup 안내
modal CLI	WARN	없으면 pip install modal 안내
PIL·numpy·cv2·yaml	FAIL	CPU 단계 필수 의존성
anime-face-detector·toonout	PASS 정보	Modal-side → 로컬 없어도 정상

FAIL 처리 규칙

FAIL 항목 해결 후 GPU 단계 진입. WARN만 있으면 확인 후 진행 가능.

• YAML 필수 필드 누락 → characters/.yaml 보완
• 마스터 PNG 없음 → Path A(텍스트 생성) 또는 Path B(업로드) 완료 후 재실행
• See-through 레포 없음 → git clone 또는 experiments/validation-smoke-001/external_repos/see-through 확인
• Modal 크레덴셜 없음 → pip install modal && modal setup
• PIL/cv2 없음 → 가상환경 pip install

파이프라인 위치

V2 파이프라인의 P0 앞 에 삽입:

analyze_master_png.py (Path B)  →  [preflight_check] → validate_master_image.py → P1 See-through

preflight_check FAIL이면 See-through 호출 자체를 막아 GPU 비용 발생 방지.