리서치: vault style-mood-taxonomy.md v1 vs 코드 9무드 대조

[thxforall]

Part of #789

Question

선언된 정본 vault style-mood-taxonomy.md v1(→ DB style_moods)의 실제 내용을 코드 9무드(cody_prompts.py/mood_vectors.rs/scoring.rs)와 대조. 라벨·순서·설명·ja 유무. (vault = decoded-docs 별도 레포, $DECODED_DOCS_PATH/sibling.)

산출

• SSOT 실내용 확정 → D-STYLEDNA 비준 근거.

[thxforall]

🔬 조사 결과 (verified-from-code · high · CONFIRMED)

결론: 9무드 KEY + 순서는 5개 서피스(vault 표 / DB style_moods 시드 / cody_prompts.py / scoring.rs+mood_vectors.rs / web styleDna.ts+messages) 완전 일치한다 (street→casual_daily→minimal→chic_edgy→preppy→lovely_feminine→sporty→classic_elegant→retro_vintage). → #793의 "KEY SSOT 존재·일치" 전제 확정, 핸드오프의 "SSOT 부재"는 오류. 코드 3파일은 KEY+순서만 담고 라벨/설명/ja는 없다 → 라벨 대조는 실제로 vault ↔ DB 시드 대조: ko.name/description 문자열 일치, en.name 일치, ja는 데이터로 어디에도 없음(DB COMMENT만 ja→en→ko 폴백 선언 = declared-but-unpopulated).

결정적 갭 2개:

1. 표시 라벨이 프론트 messages에서만 drift: en.json "Casual daily"/"Chic edgy" vs DB/vault "Daily Casual"/"Edgy Chic" → packages/web/messages/en.json:56. + ko.json이 무드 라벨을 한국어로 로컬라이즈 안 하고 영어 재사용 → ko.json:56.
2. 비준 대상 vault 문서 자체가 내부 모순: front-matter status: v1 확정 vs H1 초안 (v0.1) vs tag draft → decoded-docs/Project/style-mood-taxonomy.md:5,8,4. 정본 표 순서 vs 소비자설명 순서가 classic_elegant 위치에서 불일치 → md:25 vs md:31-41.

근거: 코드 KEY SSOT scoring.rs:8(+mood_vectors.rs:3 import) · cody 계약주석 cody_prompts.py:32 · DB 시드 supabase/migrations/20260610120000_taste_onboarding_tables.sql:104 · ja 폴백 COMMENT :11.

결정 영향 (#793): item1(SSOT 비준) — 비준 전 vault 문서의 버전라벨·내부순서를 하나로 정리해야 clean 비준(안심 근거=KEY+순서 5서피스 확정). item2(라벨 단일화) — 화해 대상은 messages 카탈로그를 DB style_moods.translations(=vault)에 맞추기. ja 라벨 = declared-but-unpopulated로 #792(로케일)에 종속.

남은 갭 (라이브, NOT-IN-CODE): psql "$OPERATION_DATABASE_URL" -c "SELECT key, sort_order, translations->'ko'->>'name' ko, translations->'en'->>'name' en, (translations ? 'ja') has_ja FROM public.style_moods ORDER BY sort_order;" (시드 ON CONFLICT DO UPDATE라 결론 불변 스팟체크).

_{울트라코드 리서치 fan-out (지도 #789) · 적대적 검증 통과.}

[thxforall]

🔁 재검증 (2026-07-22, 현재 dev 트리) — 데이터 CONFIRMED / 갭1 OVERTURNED

핵심: SSOT 데이터는 지금 비준 가능하다. 막힌 건 vault 문서를 "v1"으로 인용하는 것뿐 — 이 구분이 D-STYLEDNA를 언블록한다.

데이터 clean (육안 아님 — 3소스 프로그램 파싱 후 필드 동등성 단언): vault 표/산문 ↔ supabase SQL 시드 ↔ SeaORM Rust 시드가 ko/en name·sort_order·brand_examples·ko description 9/9 byte-exact. 두 DB 시드는 서로 완전 동일, 둘 다 멱등 ON CONFLICT DO UPDATE.

갭1(messages drift) = 해소됨, 전복. PR #912(6bd50568, 07-11, "#849")가 en.json/ko.json을 DB에 맞추고 T10 드리프트 가드까지 추가. 실행 확인 6/6 pass. 스팟체크: messages/en.json:312,314 = "Daily Casual"/"Edgy Chic" = DB 시드 일치. → #802가 의도한 결론이 이미 코드에 강제돼 있음(그 커밋이 "DB = 표시 SSOT (#793 결정)"을 명시).

갭2(vault 내부 모순) = 여전히 존재, 유일한 비준 블로커. vault 파일은 2026-06-10 이후 미변경. status: v1 확정 vs H1 초안 (v0.1) vs tag draft가 8줄 안에 공존, classic_elegant가 정본 표 #8 / 산문 #5.

baseline이 놓친 3건:

1. T10 가드가 #802가 비준하는 대상을 안 덮는다 — messages ↔ 수기 유지 스냅샷 ↔ 코드 MOOD_KEYS만 체크. vault↔시드, supabase↔SeaORM은 자동 가드 0 (그래서 green 테스트를 믿지 않고 직접 대조함)
2. ja는 "declared-but-unpopulated"보다 나쁨 — 데이터 부재에 더해 ja는 라우팅 로케일도 아니고(i18n/routing.ts:4 = ko/en), 실제 폴백(StyleMoods.tsx:101-102)은 locale→ko로 DB COMMENT가 선언한 en 단계를 건너뜀
3. en.description이 9행 전부 부재 — en은 배포된 로케일인데 미결 제품 갭

by-design 노트: 홈 MOOD_RAILS 라벨 이탈은 content-quality.ts:27-37이 가드 제외로 문서화한 의도적 결정 → drift로 취급 안 함.

자산: docs/research/2026-07-22-802-style-mood-taxonomy-ssot-reconciliation.md (PR #1053)
남은 조치: vault 문서 버전 라벨 정리(~3줄) → clean 비준. 이중 시드 dedup · 가드 확장은 후속.

[thxforall]

✅ 비준 블로커 해소 — vault PR 열림

재검증에서 확인된 유일한 비준 블로커(vault 문서 자체의 3중 모순)를 정리했다: decodedcorp/decoded-docs#18

• title/H1의 초안 (v0.1)·tag draft 제거 → front-matter status: v1 확정과 통일
• 소비자용 설명문의 classic_elegant를 5 → 8번째로 이동해 정본 표 sort_order(= DB style_moods 시드)와 정합. 문구 변경 0
• 문서 상단에 v1 상태·재검증 결과 명시(무엇이 SSOT이고 무엇이 미해결인지)

의도적으로 보존한 것: status의 "raf 공유 예정" 마커. 코드 대조 일치(9/9)가 사람 sign-off를 대신하지 않으므로 자동으로 지우지 않았다 — raf 공유가 이미 끝났다면 PR에서 제거하면 된다.

미해결(비준과 별개 트랙): en.description 9행 부재(en은 배포된 로케일) · ja 라벨 미적재(#792 로케일 종속) · vault↔시드 자동 가드 부재(T10 미커버) · supabase↔SeaORM 이중 시드.

→ 이 PR이 머지되면 D-STYLEDNA item1(SSOT 비준) 언블록. item2(라벨 단일화)는 PR #912로 이미 완료.