🪞 ③ 사실·거울 컴파일러

이 모듈은 코칭 편지가 "아이에 대해 말해도 되는 사실"을 코드가 미리 다 계산해서, 깔끔한 사실 카드로 만들어 AI에게 넘기는 부분입니다. 비유하자면, AI(LLM)가 글솜씨 좋은 작가라면 이 모듈은 옆에서 "팩트만 정리해주는 꼼꼼한 기자"예요. 작가가 분위기 살린답시고 없는 얘기를 지어내거나("매일 점심을 거른대요"), 하루 외식을 보고 "이 집은 늘 뷔페만 다녀요" 식으로 과장하지 못하게, 기자가 미리 검증된 팩트와 "이건 한 번뿐인 일/가끔 있는 일/자주 있는 일"이라는 빈도 도장을 찍어 넘깁니다. 즉, 숫자와 판단은 코드가 하고, AI는 그 사실을 따뜻한 문장으로 옮기기만 합니다.

가장 핵심은 "식단 거울"입니다. 편지 안에, 아이가 실제로 먹은 것과 영양이 어디가 채워지고 어디가 비었는지를 비춰주는 한 구절을 얹어요. "코치가 우리 애가 뭘 먹는지 보고 있구나"를 부모가 느끼게 하려는 장치죠. 거울은 (1) 어제 컨디션이 안 좋았으면 그냥 공감만 하고 끝, (2) 최근 7일 영양을 보고 잘 챙긴 식품군(강점)과 가장 부족한 식품군(결핍)을 골라 "노랑채소는 잘 챙겼는데 콩류가 좀 아쉬워요" 같은 해석 한 문장, (3) 그 결핍을 아이가 잘 먹는 음식에 슬쩍 섞는 구체 행동을 만듭니다. "어제 뭐뭐 먹었어요" 식의 단순 나열은 엄마에게 도움이 안 되니 일부러 뺐습니다.

집/기관을 정직하게 나눠 비추는 것도 이 모듈의 일입니다(P10). 어린이집·유치원 급식은 부모가 못 바꾸는 끼니라, 전체 영양이 괜찮아도 그게 기관 급식 덕이면 "어린이집 덕에 전체 영양은 잘 채워지고 있어요"라고 솔직히 밝히고, 집에서 비는 식품군에 한 걸음을 둡니다. "전반적으로 잘하고 계세요"처럼 기관 덕을 부모 공으로 돌리는 뭉뚱그린 칭찬은 금지합니다.

#5 거울 빈도 쿨다운(2026-06-20 신규) — 가장 최근에 고친 부분입니다. 예전에는 매일 편지 끝에 "어린이집 덕에 영양 잘 채워지고 있어요" 같은 안심 문구가 거의 매일 박혀(아린이 24통 중 17통) 부모가 보기에 "또 그 소리" 앵무새처럼 들렸습니다. 그래서 이 거울 안심 문구의 '출현 자체를 격일화'했습니다 — 최근 2일 안에 거울 안심이 한 번이라도 나왔으면 오늘은 통째로 쉽니다. 단, 집·기관 양쪽에서 부족한 게 2개 이상이면(심한 결핍) 쿨다운을 면제해 반드시 알립니다. 결과: 안심줄이 17통 → 6~8통으로 줄었습니다.

코드에 실제로 존재하는 함수·타입·데이터흐름입니다(file:line 실측, 환각 없음). 4개 파일에 걸쳐 산다: lib/coachFacts.ts(거울 직조·사실 카드), lib/reexposure.ts(재노출 판정), lib/coach.ts(쿨다운·누수 탐지·mirrorBlock·역 must-weave), app/api/cron/coach/route.ts(이력 적재·거울 선택·배선).

핵심 함수

route.ts — 이력 적재 · 거울 선택 · 쿨다운 배선 (실측)

coach.ts mirrorBlock — 프롬프트 직조 + 역 must-weave (실측)

입력 테이블 → 가공 함수 → 출력 컨텍스트키 파이프라인입니다.

#5 거울 빈도 쿨다운 — 폐루프 (2026-06-20)

  [어제·그제 편지] context.mirrorShown ──┐
                                        ▼
  route.ts:187  recentMirrorShown[cid] = [t/f, t/f, ...]  (최신부터)
                                        │
                                        ▼
  route.ts:894  _cooldownDue = mirrorCooldownDue(recentShown, {cooldownDays:2, severe:gMissing≥2})
                                        │
            ┌───────────────────────────┼───────────────────────────┐
       severe(결핍2+)               cooldownDue=true            cooldownDue=false
       면제 → 라인 노출            라인 생략(mirrorLineSel=null)   라인 노출
            │                           │                           │
            ▼                           ▼                           ▼
  coach.ts:751 라인 직조      coach.ts:750 '안심금지' 가드      coach.ts:751 라인 직조
                                        │
                                        ▼
            LLM이 습관적 안심줄 붙이면? → coach.ts:1018 mirrorReassureLeak
                                        │ true
                          ┌─────────────┴─────────────┐
                   :1021 LLM 재생성 1회          :1026 stripMirrorReassure(결정론 절단)
                                        │
                                        ▼
            route.ts:899  mirrorShownCtx 기록 → 다음날 분모로 환류 ↺

아린(5세)이 집에서 소고기·계란·미역국 잘 먹고 콩류/채소(당근) 결핍, 어린이집 등원. compileFactCards 통과 I/O와, #5 쿨다운 적용 전/후 편지 말미 비교.

{
  "today": "2026-06-16",
  "name": "아린",
  "recentMirrors": [
    "최근 고기·달걀은 잘 챙겼는데
     노랑·주황 채소가 좀 아쉬워요. ..."
  ],
  "rows": [
    { "log_date":"2026-06-15","slot":"dinner",
      "menus":["미역국","소고기무국","잡곡밥"],
      "refused":"당근","note":"당근은 골라냈어요",
      "environment":"table","place":"home",
      "ate_well":true,
      "ingredients":["미역","소고기","쌀","무"] },
    { "log_date":"2026-06-15","slot":"lunch",
      "menus":["김치","닭갈비"],"refused":null,
      "environment":"table","place":"daycare",
      "ate_well":true,
      "ingredients":["닭고기","배추"] }
  ]
}

{
  "cards": [
    { "key":"refuse:당근",
      "text":"거부: 당근 — 단발 1회(마지막 어제
              · 횟수=거부한 날 수)",
      "kind":"diagnosis" }
  ],
  "noteCards": ["[어제·하루 관찰] 당근은 골라냈어요"],
  "forbidParts": [
    "점심(을|은)?[^.。\\n]{0,6}(거르|건너|굶)|..."
  ],
  "mirror":
    "최근 고기·달걀은 잘 챙겼는데 콩류가 좀
     아쉬워요. 아린이가 잘 먹는 소고기무국에
     당근을 잘게 썰어 넣어 보면 어떨까요."
}