🕸️ ⑦ 네트워크 조회 헬퍼

이 모듈은 코칭 엔진이 "이 식재료, 어디에 어떻게 넣으면 아이가 잘 먹을까?"를 물었을 때 대답해 주는 '음식 인맥 검색대'입니다. 직접 추천을 결정하지는 않습니다. 다른 코칭 모듈이 편지를 쓸 때 필요한 '사실' 네 가지를 결정론(매번 같은 답)으로 찾아 줍니다. ① 궁합(같이 차리면 자연스러운 짝, 예: 두부+다시마) ② 검증된 사촌(맛·식감이 닮아 한 걸음 갈아탈 만한 대체 음식, 예: 감자→고구마) ③ 음식 적합도(이 식재료를 넣기 좋은 요리, 예: 두부→순두부·계란찜) ④ 급식 흔함도(이 식재료가 또래 급식 표준식단에 얼마나 자주 오르나). 이 넷은 우리가 모은 실제 레시피·급식 데이터에서 미리 계산해 둔 표를 그냥 '읽어 오는' 것뿐입니다.

왜 필요하냐면, 코칭의 핵심 전략이 "잘 먹는 음식에 결핍 식재료를 슬쩍 섞기" 또는 "잘 먹는 음식의 닮은 사촌으로 한 걸음 갈아타기(푸드체이닝)"인데, 아무 조합이나 섞으면 '미역국에 당근'처럼 아이가 질색하는 괴식이 나옵니다. 그래서 추천하기 전에 반드시 이 검색대에서 "이 짝이 실제 레시피에 충분히 같이 나왔나? 닮은 사촌이 사람이 검증한 것인가? 이 요리에 넣어도 자연스럽나?"를 확인합니다. 즉 코치가 상상으로 조합을 지어내지 못하게 막는 '현실 검문소'입니다.

이 모듈의 코드 본체는 lib/coachRecos.ts(추천 사실 조립)와 그 하위의 그래프 질의 헬퍼(lib/foodGraph.ts·lib/kitGuide.ts), 그리고 휴면 중인 괴식 게이트(lib/comboGuard.ts·lib/comboMatrix.ts)입니다.

그래프 질의 헬퍼 (lib/foodGraph.ts — 결정론 조회의 뿌리)

곁들임 안전 필터 + 조리 표기 (lib/coachRecos.ts)

급식 흔함도 — youa-freq (이번 세션 ⑤거울/A어드민근거의 안심 톤 소스)

이 모듈의 '급식 빈도' 소스는 youa-freq.json(dietary4u 영유아 표준식단 등장률%)입니다. coachRecos.ts:176~216에 인덱싱·조회가 박혀 있습니다.

추천 사실 조립 — buildRecoFacts / buildIngredientPool (진입점)

괴식 게이트 (lib/comboGuard.ts · comboMatrix.ts — ⚠️ 라이브 미배선·휴면)

입력 테이블(JSON 스냅샷) → 그래프 질의 헬퍼 → 추천 사실 조립 → CoachContext 키. 결정론(매번 같은 답)이고 순수 함수(fs/HTTP 불사용).

buildRecoFacts({ likedIngredients, target, targetIngredient, freqMap, suppressCousins })
│
├─(a) 타깃 줄 ──────────────────────────────────────────────────────────────────
│     targetIngredient (주간 풀 일일 회전)  ──▶ cookedName()         "삶은 검은콩"
│     popularDishesFor(ing, freqMap)        ──▶ "또래 인기: 콩자반·검은콩밥"
│     safeGarnishOf(ing) ∩ likedSet          ──▶ "잘 먹는 두부 곁들이면 좋아요"
│     youaReassuranceFor(ing)  (pct≥50)      ──▶ "또래 급식에도 자주 오르는 익숙한 재료"
│        └─ break (오늘 추천 식재료 1개만)
│
└─(b) 사촌 줄 ──  if (suppressCousins) → [] ◀── ⭐F-18: 슬롯이 음식 타깃 정한 날 생략
      for ing of liked (김치류 제외):
        verifiedCousinsOf(ing) \ likedSet  ──▶ "사촌 찐 단호박(또래 인기: 단호박죽)"   ◀── challenge 다리
        safeGarnishOf(ing)     \ likedSet  ──▶ "궁합 계란·당근"
        └─ lines ≥ 4 면 중단
                                            │
                                            ▼
            RecoFacts{ target, cousins[], lines[], text }
                                            │
   cron: bridgeFacts = _noFood ? '' : buildRecoFacts(...).text   (두뇌 useFood=false면 '')
                                            ▼
                              CoachContext.bridgeFacts  →  ⑥ 작문기(손) 그라운딩

아린: 콩류·채소 결핍, 확신 liked = 감자·계란(2개), 콜드스타트 보강 후 likedSeed에 미역·두부·쌀 등 합류. 오늘 슬롯이 콩류 회전 식재료 '검은콩'을 잡은 날.

buildRecoFacts({
  likedIngredients: ["계란","감자","미역","두부","쌀"],
  target: "콩류",
  targetIngredient: "검은콩",   // 주간 풀에서 일일 회전
  freqMap: { "검은콩":[{name:"콩자반",freq:31}],
             "단호박":[{name:"단호박죽",freq:18}] },
  suppressCousins: true          // ⭐ F-18: 오늘 슬롯이 음식 타깃을 이미 정함
})

// 내부 단위 헬퍼 호출:
// verifiedCousinsOf("감자") → [{nm:"고구마",kind:"bridge",verified:true},
//                              {nm:"단호박",kind:"bridge",verified:true}]
// safeGarnishOf("검은콩") ∩ liked → [{nm:"두부"}]
// youaReassuranceFor("검은콩") → "또래 급식에도 자주 오르는 익숙한 재료"

{
  "target": "콩류",
  "cousins": [],            // suppressCousins로 (b) 생략
  "lines": [
    "[오늘 타깃 콩류] 삶은 검은콩 (또래 인기 음식: 콩자반 · 잘 먹는 두부 곁들이면 좋아요 · 또래 급식에도 자주 오르는 익숙한 재료)"
  ],
  "text": "[오늘 타깃 콩류] 삶은 검은콩 (또래 인기 음식: 콩자반 · 잘 먹는 두부 곁들이면 좋아요 · 또래 급식에도 자주 오르는 익숙한 재료)"
}

// suppressCousins=false 였다면 (b)에 추가됐을 줄(천장4 단조성):
//   "감자 → 사촌 찐 단호박(또래 인기: 단호박죽) / 궁합 계란"
//   "계란 → 사촌 삶은 메추리알 / 궁합 ..."

연속성 47점(2026-06-20) 실측 천장을 이 모듈 관점에서 정직하게. 각 항목 증상 → 근본원인 → 해야할일(owner).