From afb1a1d6e613ec8303be415601a857a7268bec95 Mon Sep 17 00:00:00 2001
From: CD <variet@variet.net>
Date: Sun, 8 Mar 2026 17:43:48 +0900
Subject: [PATCH] =?UTF-8?q?docs(bridge):=20product.json=20=EC=B2=B4?=
 =?UTF-8?q?=ED=81=AC=EC=84=AC=20=EB=B6=88=EC=9D=BC=EC=B9=98=20=EA=B7=BC?=
 =?UTF-8?q?=EB=B3=B8=20=EC=9B=90=EC=9D=B8=20=EA=B8=B0=EB=A1=9D=20#task-258?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/devlog/2026-03-08.md           |  1 +
 docs/devlog/entries/20260308-014.md | 32 +++++++++++++++++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 docs/devlog/entries/20260308-014.md

diff --git a/docs/devlog/2026-03-08.md b/docs/devlog/2026-03-08.md
index 42cbe28..30ebeae 100644
--- a/docs/devlog/2026-03-08.md
+++ b/docs/devlog/2026-03-08.md
@@ -15,3 +15,4 @@
 | 11 | 08:10 | Stall 감지 calibration + VS Code 명령어 기반 승인 핸들러 | `f1f9a0b` | 🔧 |
 | 12 | 11:30~14:35 | 승인 로직 정밀 디버깅: IDLE→stall 전환, lastModifiedTime 구분, RPC/Commands 전수 테스트, ResolveOutstandingSteps cancel 발견 | - | 🔧 |
 | 13 | 15:00~16:52 | Multi-window 격리 (v0.3.1→0.3.4): 세션 필터, per-project 포트, 등록 경쟁 조건 수정, DOM Observer 렌더러 디버깅 | - | 🔧 |
+| 14 | 17:01~17:38 | **근본 원인 발견**: product.json 체크섬 불일치 → vscode-file:// 원본 캐시 서빙. 체크섬 수동 업데이트로 수정 | - | 🔧 |
diff --git a/docs/devlog/entries/20260308-014.md b/docs/devlog/entries/20260308-014.md
new file mode 100644
index 0000000..62095bd
--- /dev/null
+++ b/docs/devlog/entries/20260308-014.md
@@ -0,0 +1,32 @@
+# product.json 체크섬 불일치 → 렌더러 스크립트 미실행 근본 원인 발견
+
+- **시간**: 2026-03-08 17:01~17:38
+- **Vikunja**: #258 (Multi-window 격리 + DOM Observer 렌더러 디버깅)
+
+## 진단 과정
+
+1. Antigravity 재설치 후 Extension Host는 정상 (bridge HTTP 포트 응답, POLL 활성, 세션 등록)
+2. 렌더러 스크립트 `.js` 파일은 디스크에 존재, `<script>` 태그도 HTML에 존재
+3. DevTools Console에 `[GB Observer]`, `[AG SDK]` 로그 = **0건**
+4. 스크립트 파일 첫 줄에 `[AG PROBE]` 진단 프로브 삽입 → **여전히 0건**
+5. 결론: Electron이 JS 파일 자체를 로딩하지 않음
+
+## 근본 원인
+
+- Antigravity 재설치 → `product.json` SHA256 체크섬이 원본으로 리셋
+- Extension `setupApprovalObserver()`가 HTML 패치 후 **`IntegrityManager.suppressCheck()` 미호출**
+- `vscode-file://` 프로토콜이 체크섬 불일치 파일을 거부 → **원본 캐시 HTML 서빙**
+- 결과: 수정된 HTML (script 태그 포함)이 디스크에 존재하지만, Electron은 원본 HTML을 렌더링
+
+## 해결
+
+- `product.json` → `checksums` 섹션에서 수정된 2개 파일 해시 수동 업데이트:
+  - `vs/code/electron-browser/workbench/workbench.html`
+  - `vs/code/electron-browser/workbench/workbench-jetski-agent.html`
+- 해시 계산: `base64(sha256(fileBytes)).replace(/=+$/, '')`
+
+## 미완료
+
+1. **E2E 검증 미완**: Antigravity 재시작 후 `[AG PROBE]`/`[GB Observer]` 로그 출현 확인 필요
+2. **Extension 코드 수정**: `setupApprovalObserver()`에 `IntegrityManager.suppressCheck()` 영구 추가
+3. **diagnostic probe 제거**: `ag-sdk-variet-gravity-bridge.js` 첫 줄의 `[AG PROBE]` 제거