refs #732: stabilize carrier report result schema

docs/design/hmm-html-report-mcp/troubleshooting.md

@@ -104,3 +104,16 @@ underscore만 camelCase로 변환했다.
 조건문에 하드코딩하지 않는다.
 
 **재발 방지**: 서로 다른 컬럼 label 표기의 두 응답을 연속 정규화하는 회귀 테스트를 유지한다.
+
+## 두 번째 리포트의 컬럼이 한글 alias로 바뀌어 깨짐
+
+**원인**: Select AI가 첫 호출에는 `CARRIER_CODE`, 두 번째 호출에는 `선사코드`처럼 의미는 같지만
+번역된 alias를 생성했다. 구분자 정규화만으로는 서로 다른 언어의 key를 같은 필드로 판단할 수 없다.
+
+**확인**: 선행 조회 2건은 정상인데 두 번째 `reportJson.rows`가 `선사명`, `선사코드`,
+`최신매출Usd` 등을 가지는지 확인한다.
+
+**해결**: 선사 Select AI query contract에 renderer가 요구하는 ASCII uppercase underscore 출력 alias를
+선언한다. 실제 SQL, 직원 코드, 결과 값은 고정하지 않는다.
+
+**재발 방지**: 같은 팀원 질의를 두 번 호출해 두 응답의 key 집합과 renderer HTML을 비교한다.