refactor: 컨슈머 실패 신호 메커니즘 일원화

[Jaeho-Site]

변경 사항

PR #206/#210 까지 리뷰가 반복 지적한 구조 결함 해소 — 같은 "생성 중 무기한 대기" 버그를 세 컨슈머에서 세 깊이로 고쳐 온 실패 신호 메커니즘을 단일 구현으로 통합.

AI (ai/)

• 신규 messaging/consumers/failure_signal.py: consume_with_failure_signal 이 파싱(실패 시 DLQ)→멱등→전 구간 가드→FAILED 콜백(+ack)→성공 발행 실패 시 FAILED 오인 없는 DLQ→콜백 0건 경로 멱등 unmark 를 전담. 오류 분류(classify_failure)·errorMessage 포맷(ExcType: msg 500자 상한)도 단일 출처
• questions/followup/feedback 3개 컨슈머는 _process(성공 payload 반환) + _failed_payload 팩토리만 구현 — questions/followup 의 무방비 구간(컨텍스트 빌드·진행 이벤트·발행)이 처음으로 보호되고 unmark 도 3사 공통 적용
• 콜백 계약 불변 (에러 코드 명칭·필드·라우팅) — 기존 컨슈머 테스트가 무변경으로 그린인 것이 증거. 의도된 미세 변화 2건: errorMessage 포맷 통일, feedback 실패 로그 이벤트명 feedback.generate.unexpected→feedback.generate.failed

Core (backend/)

• SessionErrorNotice 를 common/sse/ 로 이동(wire JSON 불변) + SessionErrorNotifier 가 세션/유저 이중 채널 ERROR 발행 단일 구현 — 두 콜백 서비스의 인라인 복사본·형제 nested record 결합 제거 (화이트리스트는 성격이 달라 각 서비스 잔류)
• errorCode null 인 FAILED 콜백이 Map.of NPE → 롤백·재시도 루프에 빠지던 기존 결함에 폴백 가드 (코드 리뷰 CONFIRMED)

검증

• ai: 381 passed (+7: 컨텍스트 빌드 실패·발행 실패·unmark·팩토리 예외), 스모크 105, black 클린
• backend: 235 passed + notifier 단위·null 코드·유출 전수 스캔 테스트. 로컬 실패 4건은 Docker(Testcontainers) 부재 환경 실패로 baseline 동일, 신규 0
• 코드 리뷰 9건 판정 중 6건 반영(가드 팩토리 예외 시 unmark 누락, null errorCode NPE, 분류 3중복, 유출 테스트 범위, stale 주석·문서 규정), 2건 후속 이관(unmark 재주입 재실행 — attemptId 필요 / 범용 이중 채널 notifier), 1건 수용(로그 키 통일 — 의도 명시)

문서

• docs/messaging.md §6, ai/CLAUDE.md §16(두 단락 통합)·§12(stale 규정 정정), ai_server/CLAUDE.md §2, backend/CLAUDE.md §19
• frontend/·infra/ 변경 없음

후속 (기록)

• 피드백/콜백 attempt 상관관계(F5) — unmark 재주입 재실행 부작용도 이것으로 해소
• 분석·voice/tts 계열 6개 컨슈머의 발행 가드·unmark 확장