# Known Issues & Lessons Learned > **�씠 �뙆�씪��� SSOT(Single Source of Truth)�엯�땲�떎.** > �뵒踰꾧퉭�씠�굹 援ы쁽 �쟾�뿉 **諛섎뱶�떆** �씠 �뙆�씪�쓣 �솗�씤�븯�꽭�슂. > �꽭�뀡 醫낅즺 �떆 �깉濡� 諛쒓껄�맂 �씠�뒋瑜� �씠 �뙆�씪�뿉 異붽���빀�땲�떎. > [!TIP] > �빐寃� �셿猷뚮맂 怨쇨굅 �씠�뒋�뒗 [`known-issues-archive.md`](file:///c:/Users/Variet-Worker/Desktop/gravity_control/.agents/references/known-issues-archive.md)�뿉 蹂닿���릺�뼱 �엳�뒿�땲�떎. > 鍮꾩듂�븳 臾몄젣媛� �옱諛쒗븯硫� archive�뿉�꽌 寃��깋�븯�꽭�슂. --- ### [2026-04-12] [Extension] V8 CachedData가 Observer 스크립트 로딩을 차단 - **증상**: html-patcher가 workbench-jetski-agent.html에 observer v7 인라인 스크립트를 성공적으로 삽입했지만, deep-inspect가 렌더러에서 응답 없음 (10s timeout). AG 재시작 후에도 observer가 로드되지 않음 - **원인**: `%APPDATA%\Antigravity\CachedData\` (50MB)에 V8 캐시가 남아있어, AG가 패치된 HTML 대신 캐시된 이전 버전을 로드. extension.log에 `patcher.install() called (needs reload)` 메시지가 표시되지만 실제 적용이 안 됨 - **해결**: `Remove-Item "$env:APPDATA\Antigravity\CachedData\*" -Recurse -Force` 실행 후 AG 재시작. known-issues-archive #6에도 동일 케이스 있음 - **주의**: HTML 패치 변경 시 **반드시** V8 CachedData 삭제 + AG 재시작 필요. 단순 AG 재시작만으로는 부족 ### [2026-04-12] [DOM] text-ide-message-block-bot-color는 AI 응답 컨테이너가 아닌 NUX tooltip 전용 - **증상**: observer-script가 `.text-ide-message-block-bot-color`를 AI 응답 컨테이너로 사용하지만, 실제 AI 텍스트를 추출하지 못함 - **원인**: 번들 분석(jetskiAgent/main.js 10.8MB)으로 확인 결과, 이 클래스는 `hsn` 컴포넌트(NUX Tooltip 텍스트 색상)에서만 사용. AI 응답 텍스트는 `plannerResponse` step의 `Whi` 렌더러 → `div.px-2.py-1` → `MarkdownRenderer` 내부에 렌더링됨 - **해결**: observer-script에서 `.text-ide-message-block-bot-color` 의존성 제거 필요. `markdown-body` 클래스도 AG Native에 존재하지 않음 - **주의**: AI 응답 마크다운은 `prose` 관련 클래스나 MarkdownRenderer 내부 구조로 타겟팅해야 함. 실제 DOM 덤프로 정확한 셀렉터 확인 필요 ### [2026-04-12] [SDK/DOM] AG Native 세션은 Cascade SDK API에 등록되지 않음 — DOM이 유일한 데이터 소스 - **증상**: AG Native 세션에서 Discord 릴레이로 AI 응답이 전혀 전달되지 않고, 대신 UI 노이즈(`content_copy`, `Always run`, `keyboard_arrow_up`, `Cancel`)가 전송됨 - **원인 1 (SDK)**: `GetCascadeTrajectorySteps(cascadeId=세션ID)` → `500 trajectory not found`. `GetDiagnostics` → `404`. AG Native 세션은 Cascade trajectory API에 전혀 등록되지 않는 별도 시스템 - **원인 2 (DOM)**: `observer-script.ts` v6의 `scanChatBodies()`가 `.text-ide-message-block-bot-color` 컨테이너의 `textContent`를 통째로 가져오면서 내부 버튼/아이콘 텍스트까지 포함 - **해결**: `observer-script.ts` v7로 전면 재설계: 1. `[data-testid="conversation-view"]` + `[data-step-index]` 기반 step-aware 파싱 2. `extractCleanStepText()`: 클론 후 button/svg/icon 엘리먼트 제거 → 마크다운 텍스트만 추출 3. `extractStepContext()`: `getStepContainer()` → step 헤더 + code 블록만 추출 4. `NOISE_RE`: Material icon 이름, 버튼 레이블, UI 텍스트 전면 차단 5. 최초 `conversation-view` 감지 시 DOM 구조 자동 덤프 (`/dump-html`) - **주의**: SDK 경로(step-probe RT-CAPTURE)는 AG Native에서 사용 불가. DOM이 유일한 콘텐츠 소스이므로 AG UI 업데이트 시 `data-testid`/`data-step-index` 속성 존재 여부 반드시 확인 필요 ### [2026-04-09] [Bridge] Discord Body Content Missing Due to Step Probe Dummy Payload - **利앹긽**: ���洹쒕え UI 留덉씠洹몃젅�씠�뀡 �썑, �뵒�뒪肄붾뱶 �듅�씤 硫붿떆吏� 蹂몃Ц�뿉 �떎�뻾�븷 肄붾뱶/紐낅졊�뼱媛� �셿�쟾�엳 �늻�씫�릺怨� "Step #15"��� 媛숈�� �뵒�뤃�듃 �뀓�뒪�듃留� �쟾�넚�맖. - **�썝�씤**: Native UI 蹂�寃쎌쑝濡� �씤�빐 DOM observer媛� 異붿텧�븳 踰꾪듉 �뀓�뒪�듃("Always run")媛� `http-bridge.ts` �븘�꽣 �슦�쉶 諛� bot.py�뿉�꽌 吏��뿰(defer) 泥섎━�맖. 諛섎㈃ `step-probe.ts`媛� `GetAllCascadeTrajectories` �뤃留곸쓣 �넻�빐 �룞�떆�뿉 諛쒖깮�떆�궓 dummy pending payload (紐낅졊�뼱 �긽�꽭 �궡�슜�씠 �뾾�씠 `Step #XX` �씪�뒗 �뀓�뒪�듃留� �룷�븿)媛� 遊뉗뿉 �쓽�빐 癒쇱�� �옄�룞 �듅�씤�릺硫댁꽌 �젙�옉 �떎�젣 肄붾뱶 �쁺�뿭 �젙蹂닿�� 利앸컻�븿. - **�빐寃�**: `step-probe.ts` �궡�뿉 `formatStepProbeCommand` �뿬�띁 �븿�닔瑜� 異붽���븯�뿬, WAITING �긽�깭 �뒪�뀦�쓽 `argumentsJson` �뜲�씠�꽣瑜� 吏곸젒 �뙆�떛�븯怨� `CommandLine`, `TargetFile` �벑 �떎�젣 紐낅졊�뼱��� �긽�꽭 �씤�옄/肄붾뱶瑜� `command`��� `description`�쑝濡� �븷�떦�븯�뿬 釉뚮┸吏�濡� �꽆湲곕룄濡� �뙣移섑븿. DOM �샃���踰꾩쓽 遺덉븞�젙�꽦怨� 愿�怨꾩뾾�씠 �씪愿��맂 蹂몃Ц �쟾�떖 蹂댁옣. - **二쇱쓽**: UI �뒪�겕�옒�븨�뿉 �쓽議댄븯�뒗 DOM Observer 諛⑹떇��� UI �젅�씠�븘�썐, �븘�씠肄� �궫�엯 �벑�뿉 痍⑥빟�븯誘�濡�, �긽�꽭 �럹�씠濡쒕뱶 異붿텧��� �빆�긽 100% �떊猶� 媛��뒫�븳 SDK RPC(`step-probe.ts`) �뜲�씠�꽣瑜� �슦�꽑 �궗�슜�븯�룄濡� 援ъ꽦�빐�빞 �븿. ## �룷留� ### [2026-03-23] [Extension] Cross-Project DOM Observer Leakage - **利앹긽**: �떎以� �썝寃� 而댄벂�꽣�뿉�꽌 �룞�씪�븳 �봽濡쒖젥�듃紐낆쑝濡� �떎�뻾�맂 VS Code�뱾�씠 �꽌濡쒖쓽 `execute JavaScript` (Allow) �듅�씤 �떊�샇瑜� 媛�濡쒖콈嫄곕굹 �뿁�슧�븳 �꽌踰꾨줈 蹂대깂. - **�썝�씤**: Extension�씠 `workbench.html`�뿉 �뒪�겕由쏀듃瑜� 二쇱엯�븷 �븣 寃곗젙濡좎쟻 �룷�듃瑜� �븯�뱶肄붾뵫�뻽�뒗�뜲, �쟾�뿭 罹먯떆�맂 HTML �뙆�씪�쓣 紐⑤뱺 濡쒖뺄/�썝寃� �뿰寃곗씠 怨듭쑀�븯硫댁꽌 留덉��留됱뿉 �뿴由� �봽濡쒖젥�듃�쓽 �룷�듃 踰덊샇濡� �뜮�뼱�뵆�썙吏�. - **�빐寃�**: `extension.ts`�뿉�꽌 �긽�깭 �몴�떆以�(Status Bar) `tooltip`�뿉 �룷�듃瑜� 二쇱엯�븯怨�, `observer-script.ts`�뿉�꽌 DOM 荑쇰━瑜� �넻�빐 �룞�쟻�쑝濡� �옄�떊�쓽 李�(Window)�뿉 �븷�떦�맂 �룷�듃瑜� 李얠븘�궡�룄濡� �닔�젙. `vscode.env.asExternalUri`瑜� �궗�슜�븯�뿬 �룷�듃 異⑸룎 �떆 �슦�쉶�맂 二쇱냼源뚯�� 濡쒖뺄 �룷�썙�뵫�뿉 留ㅽ븨�릺�룄濡� 吏��썝. - **二쇱쓽**: VS Code UI 肄붿뼱(HTML) �뙣移� �떆, �뿬�윭 李�(Window)�씠�굹 �떎以� �썝寃� �젒�냽 �떆 �솚寃�(Scope) 遺꾨━�뿉 媛곷퀎�븳 二쇱쓽媛� �븘�슂�븿. �쟾�뿭 �옄�썝�뿉 �쓽議댄븯�뒗 �븯�뱶肄붾뵫 吏��뼇. ### [�궇吏�] [�궎�썙�뱶] ��� �븳以� �슂�빟 - **利앹긽**: 臾댁뾿�씠 �옒紐삳릺�뿀�뒗媛� - **�썝�씤**: 洹쇰낯 �썝�씤 - **�빐寃�**: �삱諛붾Ⅸ �빐寃� 諛⑸쾿 - **二쇱쓽**: �옱諛� 諛⑹��瑜� �쐞�븳 援먰썕 ``` --- ### [2026-04-08] [Discord Bot] Channel Deletion Cache Desync - **利앹긽**: 遊뉗씠 耳쒖졇 �엳�뒗 �긽�깭�뿉�꽌 Discord 梨꾨꼸(g-project-name)�쓣 �궘�젣�븯硫�, 遊뉗씠 �궘�젣瑜� �씤吏��븯吏� 紐삵븯怨� �깉 梨꾨꼸�쓣 �깮�꽦�븯吏� �븡�쑝硫� 硫붿떆吏��룄 利앸컻�븿. - **�썝�씤**: ot.py�쓽 self.project_channels �뵓�뀛�꼫由ъ뿉 梨꾨꼸 媛앹껜媛� 罹먯떆�릺�뼱 �엳�뼱, API �샇異� �뾾�씠 罹먯떆�맂(�궘�젣�맂) 梨꾨꼸濡� 硫붿떆吏�瑜� 蹂대궡�젮 �떆�룄�븯�떎 404 �뿉�윭 諛쒖깮 �썑 �떎�뙣�븿. - **�빐寃�**: 梨꾨꼸 留듯븨�씠 瑗ъ���쓣 �븣�뒗 **Python 遊�(Docker 而⑦뀒�씠�꼫)�쓣 �옱�떆�옉**�븯�뿬 罹먯떆瑜� 珥덇린�솕�븯怨� 梨꾨꼸 紐⑸줉�쓣 �깉濡� 媛깆떊�븯寃� �븿. - **二쇱쓽**: 梨꾨꼸 愿�由щ뒗 罹먯떆�뿉 �쓽議댄븯湲� �븣臾몄뿉 媛뺤젣濡� Discord UI�뿉�꽌 梨꾨꼸�쓣 吏��썱�쓣 �븣�뒗 諛섎뱶�떆 遊뉗쓣 �옱援щ룞�빐�빞 �븿. ### [2026-04-08] [Extension] Multiple Workspace LS Cross-Connection - **利앹긽**: ariet-llm 李쎌뿉�꽌 耳곗쑝�굹 gravity_control�쓽 諛깃렇�씪�슫�뱶 援щ룞 以묒씤 LS�뿉 �뿰寃곕릺�뼱 �옄湲� �옄�떊 李쎌쓽 �떊�샇瑜� �옟吏� 紐삵븿. - **�썝�씤**: �뿬�윭 VS Code 李쎌쓣 �쓣�썱�쓣 �븣 �뼱�뼡 李쎌뿉�꽌�뒗 Antigravity �뙣�꼸�쓣 �늻瑜댁�� �븡�븘 �쟾�슜 LS媛� �떆�옉�릺吏� �븡�쓬. ixLSConnection()�씠 �옄湲� 紐レ쓽 LS瑜� 李얠�� 紐삵븯怨� fallback�쑝濡� 湲곗〈�뿉 �뼚 �엳�뜕 �떎瑜� 李쎌쓽 LS�뿉 �뿰寃곕맖. - **�빐寃�**: ����긽 李쎌뿉�꽌 Developer: Reload Window �떎�뻾 �썑 **�궗�씠�뱶諛붿쓽 濡쒖뺄 Antigravity 梨쀫큸 �뙣�꼸�쓣 �븳 踰� �뿴�뼱** �옄�떊�쓽 LS �봽濡쒖꽭�뒪瑜� �쓣�슫 �뮘�뿉 Gravity Bridge瑜� Start�븿. - **二쇱쓽**: LS�뒗 �옄�룞�쑝濡� �떆�옉�릺吏� �븡怨� �궗�슜�옄媛� 梨꾪똿 �뙣�꼸�쓣 �븳 踰� �겢由�/�솢�꽦�솕�빐�빞留� Spawn �맖. ## �윍� Active/Recent Issues ### [2026-04-09] [Extension] Agent UI Native Migration & Icon Text Gluing - **利앹긽**: UI Tailwind/Native 留덉씠洹몃젅�씠�뀡 諛� �븘�씠肄� �쟻�슜 �썑, Discord 釉뚮┸吏�濡� �떊�샇媛� �쟾�넚�릺吏� �븡�쓬. - **�썝�씤**: �꽕�씠�떚釉� UI 踰꾪듉�쓽 `textContent` 異붿텧 �떆, Codicons �벑 �븘�씠肄� �룿�듃 臾몄옄�뿴(e.g., `渽� Accept`)�씠 �븵遺�遺꾩뿉 蹂묓빀(Gluing)�릺硫댁꽌, 湲곗〈�쓽 `^` �빑而ㅺ�� �룷�븿�맂 �젙洹쒖떇 留ㅼ묶(`/^(?:Always\s*)?Run/i`)�씠 �떎�뙣�븿. - **�빐寃�**: `observer-script.ts`�쓽 �뒪罹�, Sibling 踰꾪듉 �닔吏�, Webview Trigger-click �벑 `textContent`瑜� 異붿텧�븯�뒗 紐⑤뱺 DOM �씫湲� 援ш컙�뿉 `txt.replace(/^[^a-zA-Z0-9]+/, '')` �쟾泥섎━瑜� �쟻�슜�븯�뿬 �꽑�뻾 湲고샇/�븘�씠肄섏쓣 �븞�쟾�븯寃� �젣嫄�. - **二쇱쓽**: Native UI 而댄룷�꼳�듃 �솚寃쎌뿉�꽌�뒗 �뀓�뒪�듃 �끂�뱶肉먮쭔 �븘�땲�씪 �븘�씠肄�/SVG 而댄룷�꼳�듃�쓽 �뀓�뒪�듃 湲�猷⑥엵 �쁽�긽�쑝濡� �씤�빐 �뾼寃⑺븳 �떆�옉�젏(`^`) �젙洹쒖떇�씠 源⑥쭏 �닔 �엳�쑝誘�濡�, �빆�긽 遺덊븘�슂�븳 �듅�닔臾몄옄 �쟾泥섎━瑜� �꽑�뻾�빐�빞 �븿. ### [2026-04-09] [Extension] Agent UI Native Migration & CodeLens False Positive Filter - **利앹긽**: UI Tailwind/Native 留덉씠洹몃젅�씠�뀡 �쟻�슜 �썑, Discord 釉뚮┸吏�濡� �떊�샇媛� �쟾��� �쟾�넚�릺吏� �븡�쓬 - **�썝�씤**: Agent �뙣�꼸�씠 �꺆/�뿉�뵒�꽣 蹂몃Ц�뿉 吏곸젒 �젋�뜑留곷릺硫댁꽌, 湲곗〈 �삤�옉�룞 諛⑹�� 濡쒖쭅(`if (b.closest('.monaco-editor'))`)�뿉 �뙣�꼸 �쟾泥� 踰꾪듉�씠 �룷李⑸릺�뼱 臾댁떆�맖 - **�빐寃�**: �꼫臾� 愿묐쾾�쐞�븳 `.monaco-editor` 諛⑹뼱瑜� �빐�젣�븯怨�, 肄붾뱶 �젋利� 怨좎쑀 而⑦뀒�씠�꼫�씤 `.codelens-decoration` �궡遺��씪 寃쎌슦�뿉留� 臾댁떆�븯�룄濡� ����룷�씤�듃 �닔�젙 - **二쇱쓽**: DOM �샃���踰� �븘�꽣 議곌굔 �옉�꽦 �떆 �옒�띁 �겢�옒�뒪�뒗 UI �뵒�옄�씤 媛쒗렪(Native, Editor Tab �벑 �쐞移� 蹂�寃�)�뿉 留ㅼ슦 痍⑥빟�븿. 媛��옣 援ъ껜�쟻�씤 �궡遺� �끂�뱶 �겢�옒�뒪�굹 ���寃� 怨좎쑀 �냽�꽦�쓣 �넻�빐 �븘�꽣留곹븷 寃� ### [2026-03-31] [step-probe] GetAllCascadeTrajectories 10-Item Hard Limit (Signal Drop) - **利앹긽**: `guitar_score` �벑�뿉�꽌 �솢�꽦�솕�맂 �꽭�뀡�쓽 �뵒�뒪肄붾뱶 �듅�씤 �떊�샇瑜� "怨꾩냽�빐�꽌" �옟吏� 紐삵븿. (WS 60珥� ����엫�븘�썐蹂대떎 �뜑 移섎챸�쟻�쑝濡� �떊�샇媛� �븘�삁 媛�吏� �븡�쓬) - **�썝�씤**: Extension�씠 �솢�꽦 �꽭�뀡�쓣 李얘린 �쐞�빐 �샇異쒗븯�뒗 `GetAllCascadeTrajectories` LS API媛� `{}`(鍮� �씤�옄)濡� �샇異쒕맆 �븣, 湲곕낯�쟻�쑝濡� **10媛쒖쓽 �꽭�뀡留� 諛섑솚�븯�뒗 �븯�뱶 由щ컠(Pagination Limit)**�씠 嫄몃젮�엳�쓬. �씠濡� �씤�빐 �옉�뾽 �궡�뿭�씠 �늻�쟻�릺硫� �닔留롮�� 理쒖떊/吏꾪뻾 以� �꽭�뀡�뱾�씠 10媛� 紐⑸줉�뿉�꽌 諛��젮�굹 �늻�씫�맖. �씡�뒪�뀗�뀡��� �꽭�뀡�씠 �뾾�떎怨� �뙋�떒�빐 媛뺤젣濡� `IDLE` 紐⑤뱶�뿉 吏꾩엯�븯硫�, �듅�씤 ���湲곗뿴(WAITING) �옄泥대�� 寃��궗�븯吏� �븡寃� �맖. - **�빐寃�** (v0.5.14): `v0.5.13`�뿉�꽌 �룄�엯�뻽�뜕 `{ limit: 100 }`�씠 LS �떒�쓽 荑쇰━ 怨쇰���븯濡� �씤�븳 VS Code UI �봽由ъ쭠(DoS)�쓣 �쑀諛쒗븯�뿬 濡ㅻ갚�븯�뒗 以� �븘�닔 �젙�젹 �뙆�씪誘명꽣(`descending: true`)源뚯�� �냼�떎�릺�뿀�뜕 �떎�닔瑜� 援먯젙�븿. 理쒖쥌�쟻�쑝濡� `{ limit: 30, descending: true }`瑜� �쟻�슜�븯�뿬 �뙆�떛 遺��븯 理쒖냼�솕 諛� 理쒖떊 �꽭�뀡 理쒖긽�떒(Index 0) 議고쉶瑜� �븞�쟾�븯寃� 援ы쁽�븿. - **二쇱쓽**: LS�쓽 湲곕낯 SQLite/DB �쓳�떟 Limit 洹쒖튃�뿉 �쓽議댄븯�뿬 �쟾泥� �뜲�씠�꽣 �뒪罹붿쓣 �닔�뻾�븯�뒗 濡쒖쭅��� �뼵�젣�뱺 Truncation �씠�뒋(Data Loss)瑜� �쑀諛쒗븷 �닔 �엳�쓬. ### [2026-03-31] [WS] Browser API Fallback 60s Timeout (Zombie Connection) - **利앹긽**: `guitar_score` �벑 紐⑤뱺 �옉�뾽 �솚寃쎌뿉�꽌 �빟 60珥덈쭏�떎 WebSocket �뿰寃곗씠 �걡湲곌퀬 �옱�뿰寃곕릺�뒗 �쁽�긽�씠 諛섎났�릺硫�(extension.log�뿉 `Heartbeat timeout` 怨꾩냽 異쒕젰), 洹� �궗�씠 �뵒�뒪肄붾뱶 �듅�씤 �떊�샇瑜� �넃移�. - **�썝�씤**: Extension�씠 `ws` 紐⑤뱢 濡쒕뱶 �떎�뙣(VS Code �솚寃� �벑)濡� �씤�빐 釉뚮씪�슦��� �궡�옣 `WebSocket` 媛앹껜濡� Fallback �맖. 釉뚮씪�슦��� WS�뒗 �꽌踰꾩쓽 �꽕�씠�떚釉� ping�쓣 諛쏆븘 pong�쓣 �옄�룞 �쓳�떟�븯吏�留� JS�뿉 �씠踰ㅽ듃瑜� �끂異쒗븯吏� �븡�쓬. �씠濡� �씤�빐 `lastPongTime` 媛깆떊�씠 遺덇���뒫�빐�졇, `Date.now() - lastPongTime > 60000` 議곌굔�씠 臾댁“嫄� �넻怨쇰릺�뼱 硫�姨≫븳 �뿰寃곗쓣 媛뺤젣 醫낅즺�븿 (False Positive). - **�빐寃�** (v0.5.12): 1. `hub.py`: `{"type": "heartbeat"}` JSON 硫붿떆吏� �닔�떊 �떆 紐낆떆�쟻�쑝濡� `{"type": "pong"}` JSON�쓣 �쓳�떟�븯�룄濡� �닔�젙. 2. `ws-client.ts`: 紐낆떆�쟻 `pong` �빖�뱾�윭 異붽��. JSON pong 吏��썝 �꽌踰꾧굅�굹 Node.js ws瑜� �궗�슜�븷 �븣留� 60珥� ����엫�븘�썐 寃�利앹쓣 嫄곗튂�룄濡� 議곌굔 蹂닿컯 (`forceHeartbeatTimeoutIfNoPong`). - **二쇱쓽**: 釉뚮씪�슦��� �몴以� WebSockets(W3C)�뒗 ping/pong �젣�뼱 �봽�젅�엫�쓣 JS濡� �끂異쒗븯吏� �븡�쓬. �뤃由ы븘/�겕濡쒖뒪�뵆�옯�뤌 WS �옒�띁 �궗�슜 �떆 �븯�듃鍮꾪듃�뒗 諛섎뱶�떆 JSON 硫붿꽭吏� �삎�깭�쓽 Application Layer Ping/Pong�쑝濡� ����뼱�궡嫄곕굹, Native WS API �뿬遺�瑜� �솗�떎�엳 泥댄겕�빐�빞 �븿. ### [2026-03-28] [step-probe] GetCascadeTrajectorySteps UTF-8 �뿉�윭 臾댄븳 猷⑦봽 - **利앹긽**: `guitar_score` �봽濡쒖젥�듃�뿉�꽌 `[STEP-PROBE] error: ...invalid UTF-8` �뿉�윭媛� 5珥덈쭏�떎 諛섎났�릺硫� Discord �듅�씤 �떊�샇媛� �쟾�떖�릺吏� �븡�쓬. - **�썝�씤**: AG LS �꽌踰꾩뿉�꽌 �듅�젙 step�쓽 `CortexStepEphemeralMessage.content`�뿉 諛붿씠�꼫由� �뜲�씠�꽣(�씠誘몄�� �벑) �룷�븿 �넂 proto UTF-8 吏곷젹�솕 500 �뿉�윭. `catch(e)` 釉붾줉�뿉�꽌 `stallProbed=true`瑜� �꽕�젙�븯吏� �븡�븘 `!ctx.stallProbed` 議곌굔�씠 �빆�긽 true �넂 5珥덈쭏�떎 �룞�씪 �슂泥� 臾댄븳 �옱�떆�룄. - **�빐寃�** (v0.5.11): `catch` 釉붾줉�뿉�꽌 UTF-8 �뿉�윭 媛먯�� �떆 `stepOffset=currentCount-20`�쑝濡� fallback �슂泥�. offset�룄 �떎�뙣 �떆 `stallProbed=true` �꽕�젙�븯�뿬 猷⑦봽 李⑤떒. `delta>0` �씠踰ㅽ듃 諛쒖깮 �떆 L433�뿉�꽌 �옄�룞 由ъ뀑. - **二쇱쓽**: `stallProbed=true`�뒗 �쁺援� Lock�씠 �븘�떂 ��� `delta>0` �떆 �옄�룞 由ъ뀑. UTF-8 �뿉�윭�뒗 AG �꽌踰� 痢� 臾몄젣(�씠誘몄��/諛붿씠�꼫由� �뜲�씠�꽣媛� ephemeral message�뿉 �룷�븿)�씠誘�濡� Extension�뿉�꽌 graceful fallback留� 泥섎━. ### [2026-03-28] [approval-handler] stepIndex 誘명솗�젙 �떆 wrong-stepIndex RPC �궘鍮� - **利앹긽**: DOM observer 寃쎈줈濡� `terminal_command` pending �깮�꽦 �썑 Discord �듅�씤 �떆 `HandleCascadeUserInteraction(stepIndex=0)` �넂 `"input not registered for step 0"` �넂 LS reconnect �넂 �옱�떆�룄 �넂 DOM click fallback�쑝濡� ����븯. (wrong-LS��� �룞�씪�븳 利앹긽�씠�굹 �떎瑜� �썝�씤) - **�썝�씤**: `ctx.lastPendingStepIndex=-1` (step-probe媛� UTF-8 �뿉�윭濡� WAITING 誘멸컧吏�)�엫�뿉�룄 `Math.max(0, -1)=0`�쑝濡� clamp�릺�뼱 議댁옱�븯吏� �븡�뒗 step 0�뿉 RPC �쟾�넚. - **�빐寃�** (v0.5.11): `effectiveStepIndex = stepIndex >= 0 ? stepIndex : (lastPendingStepIndex >= 0 ? lastPendingStepIndex : -1)`. `effectiveStepIndex < 0`�씠硫� RPC 釉붾줉 �쟾泥� skip �넂 DOM click 吏곹뻾 (湲곗〈怨� �룞�옉 �룞�씪, LS reconnect �궘鍮� �젣嫄�). - **二쇱쓽**: 湲곗〈 洹쒖튃 #14(`uint32`�뿉 �쓬�닔 湲덉��)��� 異⑸룎泥섎읆 蹂댁씠�굹, `effectiveStepIndex=-1`�씪 �븣 RPC �옄泥대�� **�쟾�넚�븯吏� �븡�쑝誘�濡�** �쐞諛� �븘�떂. RPC �쟾�넚 �떆�뿉�뒗 �뿬�쟾�엳 �쑀�슚�븳 stepIndex留� �궗�슜. ### [2026-03-25] [Architecture] Discord Signal Drop & Extension Freezes - **利앹긽**: �옣�떆媛� �옄由щ퉬��� �썑 蹂듦�� �떆 Discord濡� �듅�씤 �떊�샇媛� �삤吏� �븡嫄곕굹 VS Code UI媛� 媛꾪뿉�쟻/吏��냽�쟻�쑝濡� 硫덉땄(Freeze). - **�썝�씤**: 1. `ws.onerror` 諛쒖깮 �썑 `onclose` �늻�씫 �떆 �옱�뿰寃� 肄쒕갚 �샇異쒖씠 �씠猷⑥뼱吏�吏� �븡�븘 臾댄븳 ���湲� (�옣�떆媛� 留덈퉬) 2. `ws-client` �옱�뿰寃� �떆 �늻�쟻�맂 200媛� �걧瑜� �룞湲곗떇 burst �쟾�넚�븯�뿬 Hub�쓽 �냽�룄 �젣�븳(60媛�/10珥�)�뿉 嫄몃젮 �솗�젙 �쁺援� �궘�젣�맖 3. 濡쒖뺄 釉뚮┸吏� `http-bridge.ts`�쓽 怨쇨굅 �쑀�궛�씤 `FALSE_POSITIVE_RE` �젙洹쒖떇�씠 AI 怨좎쑀 踰꾪듉(Allow, Deny, Accept) 留덉�� �븘�꽣留곹븯�뿬 Discord �쟾�넚 �썝泥� 李⑤떒 4. `step-probe.ts` �뤃留� 猷⑦봽 �궡 �룞湲곗떇 �뙆�씪 I/O �궗�슜�쑝濡� �씤�븳 �봽由ъ쫰 - **�빐寃�** (v0.5.10): ws-client�뿉 �븯�뱶 ����엫�븘�썐 諛� 50ms Paced-flush �쟻�슜, http-bridge�쓽 �젙洹쒖떇 湲곕뒫 �셿�솕, step-probe 鍮꾨룞湲� I/O �쟾�솚 泥댁젣 �쟻�슜, observer-script�쓽 �븘�꽣�맂 �떊�샇 臾댄븳 HTTP �뤃留� 諛⑹뼱 肄붾뱶 諛섏쁺. - **二쇱쓽**: Extension �궡遺� 濡쒖쭅 踰꾧렇����쑝誘�濡� Hub(Python) 肄붾뱶�뒗 嫄대뱶由ъ�� �븡�쓬. Hub �냽�룄 �젣�븳��� �젙�긽 諛⑹뼱 湲곗젣�씠誘�濡� �겢�씪�씠�뼵�듃 �떒�쓽 Pacing�씠 �삱諛붾Ⅸ 諛⑺뼢�엫. ### [2026-03-24] DOM Observer /trigger-click �젋�뜑留� �닚�꽌 �삤�옉�룞 諛� False Positive �봽由ъ쭠 - **利앹긽**: v0.5.9 �뙣移� �씠�썑 肄붾뵫 �떆 Agent �솕硫댁씠 �걡�엫�뾾�씠 �꽌紐� ���湲�(Pending) �긽�깭濡� 硫덉땄. �삉�뒗 �뵒�뒪肄붾뱶�뿉�꽌 `Approve` �떆 �뿉�뵒�꽣 �궡�쓽 �뿁�슧�븳 `Run Test`(肄붾뱶 �젋利�)瑜� �겢由��븿. - **�썝�씤**: �뀓�뒪�듃��� �젙洹쒖떇(`/^Run/i` �벑)�뿉留� �쓽議댄븯�뿬 `querySelectorAll`�쓣 �닔�뻾�븷 寃쎌슦, DOM �듃由ъ뿉 �젋�뜑留곷맂 �닔留롮�� VS Code �꽕�씠�떚釉� 肄붾뱶 �젋利� 踰꾪듉�쓣 Agent 踰꾪듉蹂대떎 癒쇱�� 李얠븘踰꾨━�뒗 諛쒖깮 �쐞移�(Context)�쓽 �븳怨꾩젏. - **�빐寃�** (v0.5.10): 1. 媛먯��(Scan): `isVSCodeMainWindow` 諛� �깘�깋 �끂�뱶 `isBodyRoot` �솗�씤�쓣 �넻�빐, �뿉�뵒�꽣 蹂몃Ц �쁺�뿭�뿉�꽌�뒗 "Run", "Approve" 媛먯��瑜� �썝泥� �젣嫄� (�삤吏� �뙣�꼸 �궡濡� �븳�젙). 2. �겢由�(Trigger-click): `deepFindButtons()` �궡�뿉�꽌 `findPanel()`(�뿉�씠�쟾�듃 �뙣�꼸) -> �븣由� Toasts -> Document 蹂몃Ц �닚�쑝濡� �깘�깋 **�슦�꽑�닚�쐞(Priority)**瑜� 媛뺤젣 �쟻�슜. - **二쇱쓽**: 踰꾪듉 �씠踰ㅽ듃 �썑�궧 �떆 �뀓�뒪�듃 留ㅼ묶�뿉留� �쓽議댄븯吏� 留먭퀬, 諛섎뱶�떆 DOM �깘�깋 �슦�꽑�닚�쐞��� 而⑦뀓�뒪�듃 踰붿쐞瑜� �븿猿� �븘�꽣留곹븯�뿬 False Positive瑜� 李⑤떒�븷 寃�. ### [2026-03-24] DOM Observer ��� VS Code Native UI Blind Spot - **利앹긽**: "Always Allow" 諛� �씪諛� "Allow Alt+�넻" 沅뚰븳 �븣由� 踰꾪듉�씠 �뵒�뒪肄붾뱶 沅뚰븳 �꽱�떛�뿉�꽌 �셿�쟾�엳 �늻�씫�맖. - **�썝�씤**: VS Code �꽕�씠�떚釉� �븣由� 諛� 梨꾪똿 �뙣�꼸 �궡�쓽 踰꾪듉��� `