"""전 과정 생성 이미지 DB 영속화 — 중앙 capture 인프라 (Phase A 토대).

설계 SOT: docs/w21b-all-image-db-persistence-20260630/design.html (§10 Codex 보강)
계획 SOT: docs/w21b-all-image-db-persistence-20260630/plan.html (Phase A)

구성:
- context: GenerationContext(frozen) + contextvar + scope contextmanager + worker bind
- spool : file-backed spool (이미지 바이트 → temp 파일, 메모리 폭증 방지)
- queue : CaptureQueue (append/flush) — 독립 세션 DB insert + spool→final rename
- sink  : capture_generated_image / capture_artifact (enqueue only, default-off)

★ 절대규칙: 모든 capture 동작은 non-fatal — 어떤 실패도 생성 파이프라인을 깨지
않는다(독립 try/except + 독립 세션). scope 미설정 시 저장 안 함(중복 0 보장).
"""
