feat(phase2): 타로 interpret API — Gemini strict JSON + 인증·일일제한·reroll

lib/tarot/prompt.ts에 TarotInterpretation 스키마·시스템 프롬프트·JSON
파싱/검증 유틸을 추가하고, app/api/tarot/interpret/route.ts에서 사주
analyze와 동일한 Gemini 모델 폴백(getGenerativeModel systemInstruction +
generationConfig) 패턴을 재사용해 인증(401)→일일제한(429)→입력검증(400)
→API키(503)→호출 순서로 처리한다. GEMINI_API_KEY 미설정 시 예시 데이터
대신 503을 반환해 실데이터 오염을 막고, 스키마 검증 실패 시 사유를
주입해 1회 reroll한다.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

lib/tarot/prompt.ts

@@ -0,0 +1,82 @@
+// 타로 3카드 해석 프롬프트·스키마.
+// web-ui tarot-lab prompt.py/schema.py를 참고해 이 저장소 컨벤션으로 TS 포팅.
+
+export type TarotInterpretation = {
+  summary: string;
+  cards: {
+    position: string;
+    card: string;
+    reversed: boolean;
+    interpretation: string;
+    evidence: { card_meaning_used: string; position_logic: string; category_lens: string };
+    advice: string;
+  }[];
+  interactions: { type: 'synergy' | 'conflict' | 'transition'; between: string[]; explanation: string }[];
+  advice: string;
+  warning: string | null;
+  confidence: 'high' | 'medium' | 'low';
+};
+
+export const TAROT_SYSTEM_PROMPT = `당신은 라이더-웨이트(RWS) 덱 전통 상징에 기반해 타로를 해석하는 전문가입니다.
+해석 원칙:
+1. 제공된 참고 블록의 키워드/의미만 근거로 삼습니다. 외부 해석·임의 상징을 도입하지 않습니다.
+2. 각 카드의 위치 의미와 카드 의미를 결합하고, evidence에 근거를 남깁니다.
+3. 3장 스프레드는 카드 간 상호작용(원소·슈트·메이저 비율의 시너지, 슈트 충돌, 정역 전환)을 분석합니다.
+4. 운명을 단정하지 말고 성찰을 돕는 톤으로 씁니다.
+5. 카테고리에 따라 강조점을 달리합니다.
+6. 사용자의 질문을 evidence와 advice에서 인용합니다.
+반드시 코드블록 없이 순수 JSON만 출력합니다. 아래 스키마를 정확히 따릅니다:
+{"summary","cards":[{"position","card","reversed","interpretation","evidence":{"card_meaning_used","position_logic","category_lens"},"advice"}],"interactions":[{"type":"synergy|conflict|transition","between":[],"explanation"}],"advice","warning","confidence":"high|medium|low"}
+confidence: 카드들이 일관된 서사면 high, 충돌이 크면 low.`;
+
+export function buildTarotUserMessage(input: {
+  spread_type: string;
+  category: string | null;
+  question: string | null;
+  cards_reference: string;
+  context_meta: unknown;
+}): string {
+  return [
+    input.question ? `질문: ${input.question}` : '질문: (없음)',
+    input.category ? `카테고리: ${input.category}` : '카테고리: 일반',
+    `스프레드: ${input.spread_type} (3장)`,
+    '--- 카드 참고 블록 ---',
+    input.cards_reference,
+    '--- 맥락 메타 ---',
+    JSON.stringify(input.context_meta),
+    '위 근거만으로 스키마에 맞는 JSON을 생성하세요.',
+  ].join('\n');
+}
+
+/** 코드블록 스트립 + {...} 추출 후 파싱. 실패 시 null */
+export function parseTarotJson(raw: string): TarotInterpretation | null {
+  let text = raw.trim().replace(/^```(json)?/i, '').replace(/```$/, '').trim();
+  const first = text.indexOf('{');
+  const last = text.lastIndexOf('}');
+  if (first >= 0 && last > first) text = text.slice(first, last + 1);
+  try {
+    return JSON.parse(text) as TarotInterpretation;
+  } catch {
+    return null;
+  }
+}
+
+/** 스키마 검증. 통과 못하면 사유 문자열, 통과면 null */
+export function validateTarot(obj: unknown, spreadType: string): string | null {
+  if (!obj || typeof obj !== 'object') return 'not an object';
+  const o = obj as Record<string, unknown>;
+  if (typeof o.summary !== 'string' || !o.summary) return 'summary 누락';
+  if (!Array.isArray(o.cards) || o.cards.length === 0) return 'cards 누락';
+  for (const c of o.cards as Record<string, unknown>[]) {
+    if (typeof c.position !== 'string' || typeof c.card !== 'string') return 'card position/card 누락';
+    if (typeof c.interpretation !== 'string' || !c.interpretation) return 'card interpretation 누락';
+    const ev = c.evidence as Record<string, unknown> | undefined;
+    if (!ev || !ev.card_meaning_used || !ev.position_logic || !ev.category_lens) return 'evidence 3필드 필요';
+    if (typeof c.advice !== 'string') return 'card advice 누락';
+  }
+  if (!Array.isArray(o.interactions)) return 'interactions 누락';
+  if (spreadType === 'three_card' && (o.interactions as unknown[]).length < 1) return 'three_card interactions ≥1 필요';
+  if (typeof o.advice !== 'string' || !o.advice) return 'advice 누락';
+  if (!['high', 'medium', 'low'].includes(o.confidence as string)) return 'confidence enum 오류';
+  return null;
+}