adhdev 0.1.50 → 0.1.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adhdev",
-  "version": "0.1.50",
+  "version": "0.1.53",
   "description": "ADHDev CLI — Detect, install and configure your IDE + AI agent extensions",
   "main": "dist/index.js",
   "bin": {

package/providers/_builtin/acp/codex-cli/provider.js

@@ -12,11 +12,11 @@
  * @type {import('../../../../src/providers/contracts').ProviderModule}
  */
 module.exports = {
-  type: 'codex-cli',
-  name: 'Codex CLI',
+  type: 'codex-acp',
+  name: 'Codex (ACP)',
   category: 'acp',
 
-  displayName: 'Codex',
+  displayName: 'Codex (ACP)',
   icon: '🤖',
 
   // ACP spawn config — uses codex-acp adapter

package/providers/_builtin/ide/antigravity/scripts/read_chat.js

@@ -229,6 +229,28 @@
                     }
                 }
             }
+            // C: footer 기반 사용량/quota 다이얼로그 (Dismiss / See Plans / Enable Overages 등)
+            // <footer> 요소가 conv 안에 존재하고 2개 이상 버튼이 있으면 사용자 액션이 필요한 카드로 판단
+            if (!activeModal) {
+                const footers = Array.from(conv.querySelectorAll('footer')).filter(f => f.offsetWidth > 0 && f.offsetHeight > 0);
+                for (const footer of footers) {
+                    const footerBtns = Array.from(footer.querySelectorAll('button, a')).filter(b => b.offsetWidth > 0);
+                    if (footerBtns.length >= 2) {
+                        // 카드 컨테이너: footer 상위에서 충분한 높이를 가진 첫 번째 요소
+                        let card = footer.parentElement;
+                        for (let up = 0; up < 4 && card; up++) {
+                            if (card.offsetHeight > 60) break;
+                            card = card.parentElement;
+                        }
+                        const msg = card ? (card.innerText || '').trim().slice(0, 300) : '';
+                        const btnTexts = footerBtns.map(b => (b.innerText || '').trim()).filter(t => t.length > 0 && t.length < 40);
+                        if (btnTexts.length >= 2) {
+                            activeModal = { message: msg, buttons: btnTexts, width: card ? card.offsetWidth : 300, height: card ? card.offsetHeight : 100 };
+                            break;
+                        }
+                    }
+                }
+            }
             // 모달이 감지되면 status를 waiting_approval로 변경
             if (activeModal) status = 'waiting_approval';
         } catch (e) { activeModal = null; }

package/providers/_builtin/ide/kiro/provider.js

@@ -45,8 +45,11 @@ module.exports = {
   inputMethod: 'cdp-type-and-send',
   inputSelector: '[contenteditable="true"][role="textbox"]',
 
+  // Kiro의 채팅 UI는 webview iframe 내부
+  webviewMatchText: 'kiro-chat',
+
   scripts: {
-    readChat() { return loadScript('read_chat.js'); },
+    webviewReadChat() { return loadScript('webview_read_chat.js'); },
     sendMessage(text) {
       const s = loadScript('send_message.js');
       return s ? s.replace(/\$\{\s*MESSAGE\s*\}/g, JSON.stringify(text)) : null;
@@ -58,5 +61,26 @@ module.exports = {
       const s = loadScript('resolve_action.js');
       return s ? s.replace(/\$\{\s*BUTTON_TEXT\s*\}/g, JSON.stringify(buttonText)) : null;
     },
+    openPanel() { return loadScript('open_panel.js'); },
+    focusEditor() { return loadScript('focus_editor.js'); },
+    // 세션 관리 (webview)
+    webviewListSessions() { return loadScript('webview_list_sessions.js'); },
+    webviewNewSession() { return loadScript('webview_new_session.js'); },
+    webviewSwitchSession(sessionId) {
+      const s = loadScript('webview_switch_session.js');
+      return s ? s.replace(/\$\{\s*SESSION_ID\s*\}/g, JSON.stringify(sessionId)) : null;
+    },
+    webviewListModels() { return loadScript('webview_list_models.js'); },
+    webviewSetModel(params) {
+      const model = typeof params === 'string' ? params : params?.model;
+      const s = loadScript('webview_set_model.js');
+      return s ? s.replace(/\$\{\s*MODEL\s*\}/g, JSON.stringify(model)) : null;
+    },
+    webviewListModes() { return loadScript('webview_list_modes.js'); },
+    webviewSetMode(params) {
+      const mode = typeof params === 'string' ? params : params?.mode;
+      const s = loadScript('webview_set_mode.js');
+      return s ? s.replace(/\$\{\s*MODE\s*\}/g, JSON.stringify(mode)) : null;
+    },
   },
 };

package/providers/_builtin/ide/kiro/scripts/focus_editor.js

@@ -0,0 +1,20 @@
+/**
+ * Cursor v1 — focus_editor
+ *
+ * CURSOR.md 4-5: 셀렉터 우선순위
+ *   [contenteditable="true"][role="textbox"]
+ *   → .chat-input textarea
+ *   → .composer-input
+ *   → textarea
+ *
+ * 최종 확인: 2026-03-06
+ */
+(() => {
+    const editor = document.querySelector('[contenteditable="true"][role="textbox"]')
+        || document.querySelector('.chat-input textarea')
+        || document.querySelector('.composer-input')
+        || document.querySelector('textarea.native-input')
+        || document.querySelector('textarea');
+    if (editor) { editor.focus(); return 'focused'; }
+    return 'no editor found';
+})()

package/providers/_builtin/ide/kiro/scripts/open_panel.js

@@ -0,0 +1,47 @@
+/**
+ * Kiro — open_panel
+ *
+ * Kiro AI 채팅 패널 열기.
+ * Secondary Side Bar (#workbench.parts.auxiliarybar)에 위치.
+ * "Toggle Secondary Side Bar (⌥⌘B)" 또는 "Kiro" 버튼으로 열기.
+ *
+ * 반환: 'visible' | 'opened' | 'error: ...'
+ */
+(() => {
+    try {
+        // 1. 이미 열려 있는지 확인
+        const sidebar = document.getElementById('workbench.parts.auxiliarybar');
+        if (sidebar && sidebar.offsetWidth > 0 && sidebar.offsetHeight > 0) {
+            return 'visible';
+        }
+
+        // 2. Toggle 버튼 클릭 시도
+        const toggleBtns = Array.from(document.querySelectorAll('li.action-item a, button, [role="button"]'));
+        for (const btn of toggleBtns) {
+            const label = (btn.getAttribute('aria-label') || '').toLowerCase();
+            if (label.includes('toggle secondary') || label.includes('toggle auxiliary') ||
+                label === 'kiro' || label.includes('kiro')) {
+                if (btn.offsetWidth > 0 || btn.offsetHeight > 0) {
+                    btn.click();
+                    return 'opened (toggle)';
+                }
+            }
+        }
+
+        // 3. Cmd+Shift+I 단축키 폴백 (Kiro 기본 단축키)
+        document.dispatchEvent(new KeyboardEvent('keydown', {
+            key: 'b', code: 'KeyB', keyCode: 66,
+            metaKey: true, altKey: true, ctrlKey: false,
+            bubbles: true, cancelable: true,
+        }));
+        document.dispatchEvent(new KeyboardEvent('keyup', {
+            key: 'b', code: 'KeyB', keyCode: 66,
+            metaKey: true, altKey: true, ctrlKey: false,
+            bubbles: true, cancelable: true,
+        }));
+
+        return 'opened (⌥⌘B)';
+    } catch (e) {
+        return 'error: ' + e.message;
+    }
+})()

package/providers/_builtin/ide/kiro/scripts/resolve_action.js

@@ -0,0 +1,54 @@
+/**
+ * Kiro — resolve_action
+ *
+ * 승인/거부 버튼 찾기 + 좌표 반환.
+ * Kiro의 approval 다이얼로그는 메인 DOM에 표시됨.
+ *
+ * 파라미터: ${ BUTTON_TEXT }
+ */
+(() => {
+    const want = ${ BUTTON_TEXT };
+    const wantNorm = (want || '').replace(/\s+/g, ' ').trim().toLowerCase();
+
+    function norm(t) { return (t || '').replace(/\s+/g, ' ').trim().toLowerCase(); }
+
+    function matches(el) {
+        const t = norm(el.textContent);
+        if (!t || t.length > 80) return false;
+        if (t === wantNorm) return true;
+        if (t.indexOf(wantNorm) === 0) return true;
+        if (wantNorm.indexOf(t) >= 0 && t.length > 2) return true;
+        if (/^(run|approve|allow|accept|yes)\b/.test(wantNorm)) {
+            if (/^(run|allow|accept|approve)\b/.test(t)) return true;
+        }
+        if (/^(reject|deny|no|abort)\b/.test(wantNorm)) {
+            if (/^(reject|deny)\b/.test(t)) return true;
+        }
+        return false;
+    }
+
+    const sel = 'button, [role="button"], .monaco-button';
+    const allBtns = [...document.querySelectorAll(sel)].filter(b => {
+        if (!b.offsetWidth || !b.getBoundingClientRect().height) return false;
+        const rect = b.getBoundingClientRect();
+        return rect.y > 0 && rect.y < window.innerHeight;
+    });
+
+    let found = null;
+    for (let i = allBtns.length - 1; i >= 0; i--) {
+        if (matches(allBtns[i])) { found = allBtns[i]; break; }
+    }
+
+    if (found) {
+        const rect = found.getBoundingClientRect();
+        return JSON.stringify({
+            found: true,
+            text: found.textContent?.trim()?.substring(0, 40),
+            x: Math.round(rect.x + rect.width / 2),
+            y: Math.round(rect.y + rect.height / 2),
+            w: Math.round(rect.width),
+            h: Math.round(rect.height)
+        });
+    }
+    return JSON.stringify({ found: false, want: wantNorm });
+})()

package/providers/_builtin/ide/kiro/scripts/send_message.js

@@ -0,0 +1,29 @@
+/**
+ * Kiro — send_message
+ *
+ * Kiro의 채팅 입력은 webview iframe 안에 있어 메인 DOM에서 직접 접근 불가.
+ * auxbar 하단의 입력 필드 좌표를 계산하여 clickCoords로 반환.
+ * 데몬이 CDP Input API로 해당 좌표에 클릭+타이핑+Enter를 수행.
+ *
+ * 파라미터: ${ MESSAGE }
+ */
+(() => {
+    try {
+        const auxbar = document.getElementById('workbench.parts.auxiliarybar');
+        if (!auxbar || auxbar.offsetWidth === 0) {
+            return JSON.stringify({ sent: false, error: 'auxbar not found' });
+        }
+
+        const rect = auxbar.getBoundingClientRect();
+        const x = Math.round(rect.x + rect.width / 2);
+        const y = Math.round(rect.y + rect.height - 80);
+
+        return JSON.stringify({
+            sent: false,
+            needsTypeAndSend: true,
+            clickCoords: { x, y },
+        });
+    } catch (e) {
+        return JSON.stringify({ sent: false, error: e.message });
+    }
+})()

package/providers/_builtin/ide/kiro/scripts/webview_list_models.js

@@ -0,0 +1,39 @@
+/**
+ * Generic fallback — list_models
+ */
+(() => {
+    try {
+        const models = [];
+        let current = '';
+
+        // Try generic Model string from select/button
+        const sel = document.querySelectorAll('select, [class*="model"], [id*="model"]');
+        for (const el of sel) {
+            const txt = (el.textContent || '').trim();
+            if (txt && /claude|gpt|gemini|sonnet|opus/i.test(txt)) {
+                if (txt.length < 50) {
+                    models.push(txt);
+                    if (!current) current = txt;
+                }
+            }
+        }
+
+        if (models.length === 0) {
+            const btns = document.querySelectorAll('button');
+            for (const b of btns) {
+                const txt = (b.textContent || '').trim();
+                if (txt && /claude|gpt|gemini|sonnet/i.test(txt) && txt.length < 30) {
+                    models.push(txt);
+                    current = txt;
+                }
+            }
+        }
+
+        return JSON.stringify({ 
+            models: [...new Set(models)], 
+            current: current || 'Default' 
+        });
+    } catch (e) {
+        return JSON.stringify({ models: [], current: '', error: e.message });
+    }
+})()

package/providers/_builtin/ide/kiro/scripts/webview_list_modes.js

@@ -0,0 +1,39 @@
+/**
+ * Generic fallback — list_models
+ */
+(() => {
+    try {
+        const models = [];
+        let current = '';
+
+        // Try generic Model string from select/button
+        const sel = document.querySelectorAll('select, [class*="model"], [id*="model"]');
+        for (const el of sel) {
+            const txt = (el.textContent || '').trim();
+            if (txt && /claude|gpt|gemini|sonnet|opus/i.test(txt)) {
+                if (txt.length < 50) {
+                    models.push(txt);
+                    if (!current) current = txt;
+                }
+            }
+        }
+
+        if (models.length === 0) {
+            const btns = document.querySelectorAll('button');
+            for (const b of btns) {
+                const txt = (b.textContent || '').trim();
+                if (txt && /claude|gpt|gemini|sonnet/i.test(txt) && txt.length < 30) {
+                    models.push(txt);
+                    current = txt;
+                }
+            }
+        }
+
+        return JSON.stringify({ 
+            models: [...new Set(models)], 
+            current: current || 'Default' 
+        });
+    } catch (e) {
+        return JSON.stringify({ models: [], current: '', error: e.message });
+    }
+})()

package/providers/_builtin/ide/kiro/scripts/webview_list_sessions.js

@@ -0,0 +1,21 @@
+/**
+ * Kiro — webview_list_sessions (webview iframe 내부에서 실행)
+ *
+ * Kiro의 세션 탭 목록을 반환.
+ * DOM: .kiro-tabs-item
+ */
+(() => {
+    try {
+        const tabs = document.querySelectorAll('.kiro-tabs-item');
+        const sessions = Array.from(tabs).map((tab, i) => {
+            const label = tab.querySelector('.kiro-tabs-item-label');
+            const title = (label?.textContent || tab.textContent || '').trim();
+            const active = tab.classList.contains('active') ||
+                           tab.getAttribute('aria-selected') === 'true';
+            return { id: String(i), title, active };
+        });
+        return JSON.stringify({ sessions });
+    } catch (e) {
+        return JSON.stringify({ sessions: [], error: e.message });
+    }
+})()

package/providers/_builtin/ide/kiro/scripts/webview_new_session.js

@@ -0,0 +1,34 @@
+/**
+ * Kiro — webview_new_session (webview iframe 내부에서 실행)
+ *
+ * "New Session" 버튼/탭 클릭.
+ * Kiro는 탭 바에 + 버튼 또는 "New Session" 액션이 있음.
+ */
+(() => {
+    try {
+        // kiro-icon-button (+ 버튼) 찾기
+        const addBtns = document.querySelectorAll('.kiro-icon-button, button, [role="button"]');
+        for (const btn of addBtns) {
+            const ariaLabel = (btn.getAttribute('aria-label') || '').toLowerCase();
+            const title = (btn.getAttribute('title') || '').toLowerCase();
+            if (ariaLabel.includes('new') || title.includes('new') ||
+                ariaLabel.includes('add') || title.includes('add')) {
+                btn.click();
+                return JSON.stringify({ created: true, method: 'button' });
+            }
+        }
+
+        // Checkpoint > New Session 영역 찾기
+        const allText = document.querySelectorAll('*');
+        for (const el of allText) {
+            if (el.children.length === 0 && (el.textContent || '').trim() === 'New Session') {
+                el.click();
+                return JSON.stringify({ created: true, method: 'text-click' });
+            }
+        }
+
+        return JSON.stringify({ created: false, error: 'New Session button not found' });
+    } catch (e) {
+        return JSON.stringify({ created: false, error: e.message });
+    }
+})()

package/providers/_builtin/ide/kiro/scripts/webview_read_chat.js

@@ -0,0 +1,68 @@
+/**
+ * Kiro — webview_read_chat (webview iframe 내부에서 실행)
+ *
+ * Kiro의 채팅 UI는 webview iframe 안에 위치하며,
+ * 데몬의 evaluateInWebviewFrame을 통해 실행됨.
+ *
+ * DOM 구조:
+ *   .kiro-chat-timeline
+ *     .kiro-chat-message (유저/어시스턴트 메시지)
+ *       .kiro-chat-message-meta → .kiro-chat-message-role (발신자)
+ *       .kiro-chat-message-body → .kiro-chat-message-markdown (내용)
+ *
+ * 반환: ReadChatResult { id, status, messages, inputContent? }
+ */
+(() => {
+    try {
+        const messages = [];
+        const msgElements = document.querySelectorAll('.kiro-chat-message');
+
+        msgElements.forEach((msg, idx) => {
+            const roleMeta = msg.querySelector('.kiro-chat-message-role');
+            const roleText = (roleMeta?.textContent || '').trim();
+            const isKiro = roleText.toLowerCase() === 'kiro';
+            const role = isKiro ? 'assistant' : 'user';
+
+            const body = msg.querySelector('.kiro-chat-message-body');
+            let content = '';
+            if (body) {
+                const markdown = body.querySelector('.kiro-chat-message-markdown');
+                content = (markdown || body).textContent?.trim() || '';
+            }
+
+            if (content) {
+                messages.push({ role, content, index: idx });
+            }
+        });
+
+        // 상태 감지
+        let status = 'idle';
+
+        // "Working" / "Cancel" 버튼 → generating
+        const workingBar = document.querySelector('.kiro-snackbar');
+        if (workingBar && workingBar.offsetWidth > 0) {
+            const barText = (workingBar.textContent || '').toLowerCase();
+            if (barText.includes('working') || barText.includes('cancel')) {
+                status = 'generating';
+            }
+        }
+
+        // 입력 필드 내용
+        const input = document.querySelector('.tiptap.ProseMirror, [contenteditable="true"]');
+        const inputContent = input ? input.textContent?.trim() : '';
+
+        // 세션 탭
+        const tab = document.querySelector('.kiro-tabs-item.active, .kiro-tabs-item[aria-selected="true"]');
+        const title = tab?.textContent?.trim() || '';
+
+        return JSON.stringify({
+            id: title || 'kiro-default',
+            status,
+            messages,
+            title: title || undefined,
+            inputContent: inputContent || undefined,
+        });
+    } catch (e) {
+        return JSON.stringify({ id: '', status: 'error', messages: [], error: e.message });
+    }
+})()

package/providers/_builtin/ide/kiro/scripts/webview_set_mode.js

@@ -0,0 +1,15 @@
+/**
+ * Generic fallback — set_model
+ * ${ MODEL }
+ */
+(() => {
+    try {
+        const want = ${ MODEL } || '';
+        const norm = (t) => t.toLowerCase().trim();
+
+        // Very basic click attempt
+        return JSON.stringify({ success: false, error: 'Model selection requires UI interaction not supported by generic script' });
+    } catch (e) {
+        return JSON.stringify({ success: false, error: e.message });
+    }
+})()

package/providers/_builtin/ide/kiro/scripts/webview_set_model.js

@@ -0,0 +1,15 @@
+/**
+ * Generic fallback — set_model
+ * ${ MODEL }
+ */
+(() => {
+    try {
+        const want = ${ MODEL } || '';
+        const norm = (t) => t.toLowerCase().trim();
+
+        // Very basic click attempt
+        return JSON.stringify({ success: false, error: 'Model selection requires UI interaction not supported by generic script' });
+    } catch (e) {
+        return JSON.stringify({ success: false, error: e.message });
+    }
+})()

package/providers/_builtin/ide/kiro/scripts/webview_switch_session.js

@@ -0,0 +1,26 @@
+/**
+ * Kiro — webview_switch_session (webview iframe 내부에서 실행)
+ *
+ * 세션 탭 클릭으로 전환.
+ * 파라미터: ${ SESSION_ID } (탭 인덱스)
+ */
+(() => {
+    try {
+        const targetId = ${ SESSION_ID };
+        const tabs = document.querySelectorAll('.kiro-tabs-item');
+        const idx = parseInt(targetId, 10);
+
+        if (isNaN(idx) || idx < 0 || idx >= tabs.length) {
+            return JSON.stringify({ switched: false, error: `Invalid session index: ${targetId}, total: ${tabs.length}` });
+        }
+
+        tabs[idx].click();
+        const label = tabs[idx].querySelector('.kiro-tabs-item-label');
+        return JSON.stringify({
+            switched: true,
+            title: (label?.textContent || tabs[idx].textContent || '').trim(),
+        });
+    } catch (e) {
+        return JSON.stringify({ switched: false, error: e.message });
+    }
+})()

package/providers/_builtin/ide/pearai/provider.js

@@ -45,8 +45,11 @@ module.exports = {
   inputMethod: 'cdp-type-and-send',
   inputSelector: '[contenteditable="true"][role="textbox"]',
 
+  // PearAI의 Agent 채팅 UI는 webview iframe 내부 (Roo Code/Cline 기반)
+  webviewMatchText: 'chat-text-area',
+
   scripts: {
-    readChat() { return loadScript('read_chat.js'); },
+    webviewReadChat() { return loadScript('webview_read_chat.js'); },
     sendMessage(text) {
       const s = loadScript('send_message.js');
       return s ? s.replace(/\$\{\s*MESSAGE\s*\}/g, JSON.stringify(text)) : null;
@@ -58,5 +61,28 @@ module.exports = {
       const s = loadScript('resolve_action.js');
       return s ? s.replace(/\$\{\s*BUTTON_TEXT\s*\}/g, JSON.stringify(buttonText)) : null;
     },
+    webviewResolveAction(params) {
+      const action = typeof params === 'string' ? params : params?.action || 'approve';
+      const buttonText = params?.button || params?.buttonText
+        || (action === 'approve' ? 'Accept' : action === 'reject' ? 'Reject' : action);
+      const s = loadScript('webview_resolve_action.js');
+      return s ? s.replace(/\$\{\s*BUTTON_TEXT\s*\}/g, JSON.stringify(buttonText)) : null;
+    },
+    openPanel() { return loadScript('open_panel.js'); },
+    focusEditor() { return loadScript('focus_editor.js'); },
+    // 세션 관리 (webview)
+    webviewNewSession() { return loadScript('webview_new_session.js'); },
+    webviewListModels() { return loadScript('webview_list_models.js'); },
+    webviewSetModel(params) {
+      const model = typeof params === 'string' ? params : params?.model;
+      const s = loadScript('webview_set_model.js');
+      return s ? s.replace(/\$\{\s*MODEL\s*\}/g, JSON.stringify(model)) : null;
+    },
+    webviewListModes() { return loadScript('webview_list_modes.js'); },
+    webviewSetMode(params) {
+      const mode = typeof params === 'string' ? params : params?.mode;
+      const s = loadScript('webview_set_mode.js');
+      return s ? s.replace(/\$\{\s*MODE\s*\}/g, JSON.stringify(mode)) : null;
+    },
   },
 };

package/providers/_builtin/ide/pearai/scripts/focus_editor.js

@@ -0,0 +1,20 @@
+/**
+ * Cursor v1 — focus_editor
+ *
+ * CURSOR.md 4-5: 셀렉터 우선순위
+ *   [contenteditable="true"][role="textbox"]
+ *   → .chat-input textarea
+ *   → .composer-input
+ *   → textarea
+ *
+ * 최종 확인: 2026-03-06
+ */
+(() => {
+    const editor = document.querySelector('[contenteditable="true"][role="textbox"]')
+        || document.querySelector('.chat-input textarea')
+        || document.querySelector('.composer-input')
+        || document.querySelector('textarea.native-input')
+        || document.querySelector('textarea');
+    if (editor) { editor.focus(); return 'focused'; }
+    return 'no editor found';
+})()

package/providers/_builtin/ide/pearai/scripts/open_panel.js

@@ -0,0 +1,46 @@
+/**
+ * PearAI — open_panel
+ *
+ * PearAI 채팅 패널 열기.
+ * "Toggle PearAI Side Bar (⌘;)" 버튼으로 열기.
+ *
+ * 반환: 'visible' | 'opened' | 'error: ...'
+ */
+(() => {
+    try {
+        // 1. 이미 열려 있는지 확인
+        const sidebar = document.getElementById('workbench.parts.auxiliarybar');
+        if (sidebar && sidebar.offsetWidth > 0 && sidebar.offsetHeight > 0) {
+            return 'visible';
+        }
+
+        // 2. Toggle 버튼 클릭 시도
+        const toggleBtns = Array.from(document.querySelectorAll('li.action-item a, button, [role="button"]'));
+        for (const btn of toggleBtns) {
+            const label = (btn.getAttribute('aria-label') || '').toLowerCase();
+            if (label.includes('toggle pearai') || label.includes('toggle secondary') ||
+                label.includes('toggle auxiliary')) {
+                if (btn.offsetWidth > 0 || btn.offsetHeight > 0) {
+                    btn.click();
+                    return 'opened (toggle)';
+                }
+            }
+        }
+
+        // 3. Cmd+; 단축키 폴백 (PearAI 기본 단축키)
+        document.dispatchEvent(new KeyboardEvent('keydown', {
+            key: ';', code: 'Semicolon', keyCode: 186,
+            metaKey: true, ctrlKey: false,
+            bubbles: true, cancelable: true,
+        }));
+        document.dispatchEvent(new KeyboardEvent('keyup', {
+            key: ';', code: 'Semicolon', keyCode: 186,
+            metaKey: true, ctrlKey: false,
+            bubbles: true, cancelable: true,
+        }));
+
+        return 'opened (⌘;)';
+    } catch (e) {
+        return 'error: ' + e.message;
+    }
+})()