# task-1050.1 완료 보고서 — ThreadAuto v2 텍스트 파이프라인 개선 (3건)

## S - Situation
ThreadAuto 텍스트 파이프라인이 task-1047.1에서 보험저널 기반 텍스트 Threads 업로드를 실행 중이며, 3가지 개선 필요사항이 발견되었다: 타사명 정책, 날짜 부정확 표현, 수치 환각 문제.

## C - Complication
(1) master_brief.md의 "타사 직접 언급 금지" 규칙이 정책 변경(조건부 허용)과 불일치, (2) Claude CLI에 현재 날짜/기사 발행일이 전달되지 않아 "오늘 나온 기사"라고 7일 전 기사를 잘못 표현, (3) text_insight 재실행 시 fact_guard 3회 연속 실패(환각 수치 생성률 약 67%).

## Q - Question
3건의 개선을 적용하여 타사명 정책 일관성, 날짜 표현 정확성, fact_guard 재실행 안정성(90%+ 목표)을 달성할 수 있는가?

## A - Answer
3건 모두 구현 완료. (1) master_brief.md + compliance_filter.py + text_prompts.py에 조건부 허용 정책 반영, (2) text_generator.py에 `_get_date_guidance()` 메서드 추가로 0일/1-3일/4일+ 분기별 날짜 가이드 프롬프트 자동 주입, (3) text_prompts.py에 text_insight 전용 수치 억제 규칙 + text_generator.py에 fact_guard 사전 검증 연동(검증 실패 시 자동 재생성). pytest 82건 전체 PASS, pyright 에러 0건.

---

## 수정 파일 목록

- `content/text_generator.py` — `_get_date_guidance()` 신규 메서드, `generate()`에 fact_guard 사전 검증 추가 (+49줄)
- `content/text_prompts.py` — text_insight 프롬프트에 타사명 조건부 허용 + 수치 억제 규칙 추가 (+6줄)
- `content/compliance_filter.py` — 타사명 블랙리스트 패턴에 정책 변경 주석 추가 (+2줄)
- `prompts/master_brief.md` — "타사 직접 언급 금지" → 조건부 허용 (2개소 수정)
- `tests/test_text_generator.py` — 신규 테스트 3클래스 12건 추가, VALID_INSIGHT_TEXT 정성적 표현 수정 (+150줄)

---

## 테스트 결과
- pytest: **82/82 PASSED** (기존 70건 유지 + 신규 12건)
- pyright: **에러 0건, 경고 0건**
- black/isort: 포매팅 완료

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **master_brief.md L303 "특정 타사 보험회사명 언급 금지" 미수정** — L185의 공통 제약만 수정 후 L303의 콘텐츠 생성 금지사항 섹션도 동일하게 조건부 허용으로 수정
2. **VALID_INSIGHT_TEXT 픽스처에 fact_db 미등록 수치(12%) 포함** — fact_guard 사전 검증 추가로 인해 기존 mock 텍스트 검증 실패 발생. 수치를 정성적 표현("꾸준히 성장 중")으로 교체
3. **TDD 순서에서 일부 테스트가 이미 GREEN** — compliance_filter.py의 타사명 패턴이 이미 "~보다" 형태만 차단하고 있어 단순 언급은 기존에도 허용됨. 정책 주석만 추가하여 의도 명시

### 범위 외 미해결 (1건)
1. **topic_selector.py의 published 필드 보존** — `_cache_item_to_topic()` 함수에서 뉴스 캐시 아이템의 published 필드를 topic dict에 포함시키지 않고 있음. 범위 외 사유: 이 수정은 크롤러(RSS fetcher) 출력 스키마와 연관되어 별도 작업 필요. 현재 `run_insjournal_text.py`에서 직접 topic dict를 구성할 때 published를 포함하면 작동함.

---

## 머지 판단
- **머지 필요**: Yes
- **브랜치**: task/task-1050.1-dev1
- **워크트리 경로**: /home/jay/projects/ThreadAuto/.worktrees/task-1050.1-dev1
- **머지 의견**: pytest 82건 전체 PASS, pyright 에러 0건, 기존 테스트 회귀 없음. 변경 범위가 content/ 및 prompts/ 한정이며 다른 모듈에 side-effect 없음. 머지 안전.