docs: session end — known-issues 3건 (cross-project flooding, pending 누적, diff_review brain/) + devlog #008

.agents/references/known-issues.md

@@ -615,3 +615,21 @@
 - **원인**: `bot.py` `chat_snapshot_scanner`(L895-988)에서 `channel.send()` 성공 후 INFO 로그 없음. 실패 시 `discord.NotFound`만 catch하고 일반 Exception은 catch 안 함
 - **해결**: 전송 성공 시 `[SNAPSHOT] Sent to #채널명 (inline/file, N chars)` INFO 로그 추가. `Exception` catch도 추가하여 `[SNAPSHOT] Discord send failed` ERROR 로그 출력
 - **주의**: `_get_channel()` 실패 시 `[SNAPSHOT] No Discord channel` WARNING은 이전에도 있었으나, channel이 정상이면 아무 단서 없었음
+
+### [2026-03-16] 크로스 프로젝트 이벤트 폭주 — Watcher/Collector 무필터
+- **증상**: /start 실행 시 gravity_control 채널에 variet_agent, lifetimepd, deriva 등 타 프로젝트 알림 유입. 6개 프로젝트 42개 세션의 file_changed가 모두 전달됨
+- **원인**: `watcher.py`가 brain/ 전체를 recursive 감시하면서 모든 세션의 .md 변경을 이벤트로 방출. `collector.py` `_forward_events_loop`도 프로젝트 필터 없이 모든 이벤트를 Gateway로 전달
+- **해결**: (1) `watcher.py`에 `_is_my_session()` 필터 추가 — register/ 파일 기반으로 MY 프로젝트 세션만 이벤트 방출. (2) `collector.py`에 `_get_session_project()` + 이벤트 전달 필터 추가
+- **주의**: 미등록 세션(새로 시작된 대화)은 allow-through 방식. register 파일은 60초 캐시로 I/O 절감
+
+### [2026-03-16] pending 파일 139개 누적 — 정리 로직 부재
+- **증상**: `bridge/pending/` 디렉토리에 auto_resolved 109개 + pending 30개 = 139개 파일 누적. 새 pending 전달 지연
+- **원인**: Extension이 `auto_resolved`/`expired`로 상태 변경한 pending 파일을 아무도 삭제 안 함. Bot은 gateway 모드라 로컬 파일 접근 불가, Collector는 response가 온 pending만 삭제
+- **해결**: `collector.py` `_forward_pending_loop`에서: (1) auto_resolved/expired 상태 → Gateway 전달 후 즉시 로컬 삭제, (2) 10분 이상된 forwarded pending 주기적 자동 삭제
+- **주의**: startup_pending은 정리 대상에서 제외 (mtime 기반 변경 감지가 필요하므로)
+
+### [2026-03-16] diff_review가 brain/ artifact에도 트리거 — task.md "코드 리뷰"
+- **증상**: AI가 task.md만 수정한 경우에도 "코드 리뷰: task.md" pending이 생성되어 사용자 혼동
+- **원인**: Extension의 diff_review 감지 로직이 write_to_file/replace_file_content로 수정된 **모든** 파일을 추적. brain/ 경로의 task.md, implementation_plan.md 등 AG 내부 artifact도 포함됨
+- **해결**: `extension.ts` diff_review 감지 시 `.gemini/antigravity/brain/` 경로 파일을 필터링하여 제외. 코드 파일만 남으면 diff_review 생성, brain artifact만이면 skip
+- **주의**: 코드 파일 + brain artifact가 혼합된 경우에는 코드 파일에 대해서만 diff_review 생성