From ad4ed623bd983af2e790078e5436fa5e2c2b1d47 Mon Sep 17 00:00:00 2001
From: Variet Worker <worker@variet.net>
Date: Sun, 19 Apr 2026 14:48:42 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20observer-dev-guide=20DOM=20=EA=B5=AC?=
 =?UTF-8?q?=EC=A1=B0=20BTN-DOM-DUMP=20=EA=B8=B0=EB=B0=98=20=EA=B0=B1?=
 =?UTF-8?q?=EC=8B=A0=20+=20log=20relay=20=ED=95=84=ED=84=B0=20=EA=B7=9C?=
 =?UTF-8?q?=EC=B9=99=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agents/references/observer-dev-guide.md | 41 +++++++++++++++++-------
 1 file changed, 29 insertions(+), 12 deletions(-)

diff --git a/.agents/references/observer-dev-guide.md b/.agents/references/observer-dev-guide.md
index 449098d..38e7501 100644
--- a/.agents/references/observer-dev-guide.md
+++ b/.agents/references/observer-dev-guide.md
@@ -85,21 +85,38 @@ Select-String -Path "$env:LOCALAPPDATA\Programs\Antigravity\resources\app\out\vs
 - 사용자 메시지 블록: `.select-text.rounded-lg` (v0.5.74+)
 - Thinking 블록: 조상에 `max-h-[200px]` 클래스 있음 → 필터링
 
-### 3.2 승인 버튼 (Observer가 접근 가능)
-- "Always run" 버튼: `<button>` 태그, chat panel 내
-  - 명령어 텍스트: `footer`의 **형제(sibling)** 요소의 `pre.font-mono` (조상 아님!)
-  - 조상 탐색 trail: `d0:button → d1:div → d2:footer` (footer.parentElement === null)
-- "Retry" 버튼: `<button>` 태그, chat panel 내
+### 3.2 승인 버튼 — "Always run" (v0.5.93 BTN-DOM-DUMP 확인)
 
-### 3.3 Diff Review (Accept all / Reject all) — Observer 접근 **불가**
-- "Accept all" / "Reject all" 버튼은 **에디터 webview**에 렌더링
-- Observer의 `document`에서 `querySelectorAll('button')` 등으로 찾을 수 없음
-- ACCEPT-SCAN 디버그 로그로 확인: `button, a, div, span, [role="button"]` 전체 스캔해도 미발견
-- **해결 경로**: Extension host에서 `antigravity.acceptAgentStep` 명령 실행 (CMD-DISCOVERY에서 발견됨)
+실제 DOM 구조 (v0.5.92 로그로 확인):
+- d0: button.flex.cursor-pointer (Always run 버튼)
+- d1: div.min-w-0
+- d2: div.flex.items-center.justify-between.rounded-b.border-t (버튼 바)
+- d3: div (이름 없는 컨테이너)
+  - div.mb-1 = "Running command" (헤더)
+  - div.flex = "❯ gravity_control > ..." (실제 명령어, plain div!)
+  - div.flex = "Always run Cancel" (버튼들)
+
+> 명령어는 pre.font-mono나 code가 아닌 plain div.flex에 있음.
+> v30: "Running command" div의 형제를 탐색하여 프롬프트 마커 뒤의 명령어 추출.
+
+- "Retry" 버튼: button 태그, chat panel 내
+
+### 3.3 Diff Review (Accept all / Reject all) — Observer 접근 불가
+- 에디터 webview에 렌더링, Observer document에서 접근 불가
+- 해결: Extension host에서 antigravity.acceptAgentStep 명령 실행
 
 ### 3.4 DOM 렌더링 타이밍
-- "Always run" 버튼이 DOM에 나타난 후, `pre.font-mono` (명령어 텍스트)는 **100~300ms 후** 렌더링
-- 해결: DEFERRED 컨텍스트 — 500ms 딜레이 후 재추출 (v0.5.84+)
+- "Always run" 버튼이 DOM에 나타날 때 명령어 div도 함께 렌더링됨
+- v30의 "Running command" div 탐색은 즉시 성공
+
+### 3.5 log() relay 필터 규칙
+Observer의 log() 함수는 키워드 필터로 일부 로그만 extension.log에 relay.
+새 로그 키워드 추가 시 반드시 필터도 함께 수정해야 함.
+
+현재 필터 키워드 (v0.5.92+):
+CV-CLASSES, CV-CHILDREN, child[, CV found, Conversation view,
+BEACON, ERROR, chat relay, user-cls,
+CONTEXT, BTN-DOM, DEFERRED, DETECTED
 
 ---