adhdev 0.1.53 → 0.1.54

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

@@ -45,11 +45,15 @@ module.exports = {
   inputMethod: 'cdp-type-and-send',
   inputSelector: '[contenteditable="true"][role="textbox"]',
 
-  // Kiro의 채팅 UI는 webview iframe 내부
-  webviewMatchText: 'kiro-chat',
+  // Kiro의 채팅 UI는 webview iframe 내부 (extensionId=kiro.kiroAgent)
+  webviewMatchText: 'kiro',
 
   scripts: {
     webviewReadChat() { return loadScript('webview_read_chat.js'); },
+    webviewSendMessage(text) {
+      const s = loadScript('webview_send_message.js');
+      return s ? s.replace(/\$\{\s*MESSAGE\s*\}/g, JSON.stringify(text)) : null;
+    },
     sendMessage(text) {
       const s = loadScript('send_message.js');
       return s ? s.replace(/\$\{\s*MESSAGE\s*\}/g, JSON.stringify(text)) : null;

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

@@ -0,0 +1,72 @@
+/**
+ * Kiro — webview_send_message (webview iframe 내부에서 실행)
+ *
+ * Kiro의 채팅 입력은 webview iframe 안의 ProseMirror/tiptap 에디터.
+ * execCommand('insertText') + Enter 키 이벤트로 메시지 전송.
+ *
+ * 파라미터: ${ MESSAGE }
+ */
+(async () => {
+    try {
+        const msg = ${ MESSAGE };
+
+        // ─── 1. 입력 필드 찾기 ───
+        const editor =
+            document.querySelector('.tiptap.ProseMirror') ||
+            document.querySelector('[contenteditable="true"]') ||
+            document.querySelector('textarea');
+
+        if (!editor) return JSON.stringify({ sent: false, error: 'no input found in webview' });
+
+        const isTextarea = editor.tagName === 'TEXTAREA';
+
+        if (isTextarea) {
+            editor.focus();
+            const nativeSetter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value')?.set;
+            if (nativeSetter) nativeSetter.call(editor, msg);
+            else editor.value = msg;
+            editor.dispatchEvent(new Event('input', { bubbles: true }));
+            await new Promise(r => setTimeout(r, 300));
+
+            const enterOpts = { key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true, cancelable: true, composed: true };
+            editor.dispatchEvent(new KeyboardEvent('keydown', enterOpts));
+            editor.dispatchEvent(new KeyboardEvent('keypress', enterOpts));
+            editor.dispatchEvent(new KeyboardEvent('keyup', enterOpts));
+            return JSON.stringify({ sent: true });
+        }
+
+        // ─── 2. contenteditable (ProseMirror / tiptap) ───
+        editor.focus();
+        await new Promise(r => setTimeout(r, 100));
+
+        // 전체 선택 + 삭제 + 삽입
+        const sel = window.getSelection();
+        const range = document.createRange();
+        range.selectNodeContents(editor);
+        sel.removeAllRanges();
+        sel.addRange(range);
+        await new Promise(r => setTimeout(r, 50));
+
+        document.execCommand('delete', false, null);
+        await new Promise(r => setTimeout(r, 50));
+        document.execCommand('insertText', false, msg);
+
+        editor.dispatchEvent(new Event('input', { bubbles: true }));
+        await new Promise(r => setTimeout(r, 400));
+
+        // ─── 3. Enter 키 전송 ───
+        const enterOpts = {
+            key: 'Enter', code: 'Enter',
+            keyCode: 13, which: 13,
+            bubbles: true, cancelable: true, composed: true,
+        };
+        editor.dispatchEvent(new KeyboardEvent('keydown', enterOpts));
+        await new Promise(r => setTimeout(r, 50));
+        editor.dispatchEvent(new KeyboardEvent('keypress', enterOpts));
+        editor.dispatchEvent(new KeyboardEvent('keyup', enterOpts));
+
+        return JSON.stringify({ sent: true });
+    } catch (e) {
+        return JSON.stringify({ sent: false, error: e.message });
+    }
+})()

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

@@ -50,6 +50,10 @@ module.exports = {
 
   scripts: {
     webviewReadChat() { return loadScript('webview_read_chat.js'); },
+    webviewSendMessage(text) {
+      const s = loadScript('webview_send_message.js');
+      return s ? s.replace(/\$\{\s*MESSAGE\s*\}/g, JSON.stringify(text)) : null;
+    },
     sendMessage(text) {
       const s = loadScript('send_message.js');
       return s ? s.replace(/\$\{\s*MESSAGE\s*\}/g, JSON.stringify(text)) : null;
@@ -70,8 +74,16 @@ module.exports = {
     },
     openPanel() { return loadScript('open_panel.js'); },
     focusEditor() { return loadScript('focus_editor.js'); },
+    // 세션 관리 (IDE 메인 프레임)
+    newSession() { return loadScript('new_session.js'); },
+    listSessions() { return loadScript('list_sessions.js'); },
     // 세션 관리 (webview)
     webviewNewSession() { return loadScript('webview_new_session.js'); },
+    webviewListSessions() { return loadScript('webview_list_sessions.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;

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

@@ -0,0 +1,38 @@
+/**
+ * PearAI — list_sessions (IDE 메인 프레임에서 실행)
+ * 
+ * 히스토리 패널 토글 버튼을 클릭하여 히스토리 뷰를 오픈합니다.
+ * 히스토리 뷰가 열리면 webviewListSessions로 항목을 읽을 수 있습니다.
+ */
+(() => {
+    try {
+        // Panel title bar에서 히스토리 관련 버튼 찾기
+        const actionBtns = document.querySelectorAll('.action-item a.action-label, .action-item .action-label');
+        for (const btn of actionBtns) {
+            const title = (btn.getAttribute('title') || '').toLowerCase();
+            const ariaLabel = (btn.getAttribute('aria-label') || '').toLowerCase();
+            const cls = btn.className || '';
+            
+            if (title.includes('history') || title.includes('히스토리') ||
+                ariaLabel.includes('history') || ariaLabel.includes('히스토리') ||
+                cls.includes('codicon-history')) {
+                btn.click();
+                return JSON.stringify({ toggled: true, method: 'panelAction', title: btn.getAttribute('title') });
+            }
+        }
+
+        // Broader search
+        const allBtns = document.querySelectorAll('a[title], button[title]');
+        for (const btn of allBtns) {
+            const title = (btn.getAttribute('title') || '').toLowerCase();
+            if (title.includes('history') || title.includes('task history')) {
+                btn.click();
+                return JSON.stringify({ toggled: true, method: 'titleBtn', title: btn.getAttribute('title') });
+            }
+        }
+
+        return JSON.stringify({ toggled: false, error: 'History toggle button not found' });
+    } catch (e) {
+        return JSON.stringify({ toggled: false, error: e.message });
+    }
+})()

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

@@ -0,0 +1,55 @@
+/**
+ * PearAI — new_session (IDE 메인 프레임에서 실행)
+ * 
+ * Panel title bar의 "+" 버튼(New Task)을 찾아 클릭합니다.
+ * PearAI(Roo Code 기반)에서 새 태스크 버튼은 webview 바깥의 VS Code panel 헤더에 위치합니다.
+ */
+(() => {
+    try {
+        // Strategy 1: Find the codicon-add / plus button in panel title actions
+        const actionBtns = document.querySelectorAll('.panel .title .actions-container .action-item a, .pane-header .actions-container .action-item a, .title-actions .action-item a');
+        for (const btn of actionBtns) {
+            const title = btn.getAttribute('title') || '';
+            const ariaLabel = btn.getAttribute('aria-label') || '';
+            const cls = btn.className || '';
+            
+            if (title.toLowerCase().includes('new task') || 
+                title.toLowerCase().includes('new chat') ||
+                ariaLabel.toLowerCase().includes('new task') ||
+                ariaLabel.toLowerCase().includes('new chat') ||
+                cls.includes('codicon-add') ||
+                cls.includes('codicon-plus')) {
+                btn.click();
+                return JSON.stringify({ created: true, method: 'panelAction', title: title || ariaLabel });
+            }
+        }
+
+        // Strategy 2: Broader search for action items with "+" or "new" 
+        const allActions = document.querySelectorAll('.action-item a.action-label');
+        for (const a of allActions) {
+            const title = (a.getAttribute('title') || '').toLowerCase();
+            const cls = a.className || '';
+            if ((title.includes('new') && title.includes('task')) ||
+                (title.includes('plus') || cls.includes('codicon-add'))) {
+                a.click();
+                return JSON.stringify({ created: true, method: 'actionLabel', title: a.getAttribute('title') });
+            }
+        }
+
+        // Strategy 3: Use keybinding (Cmd+Shift+P -> "new task")
+        // Simulate keyboard shortcut for Roo Code: typically there's a command 
+        // registered as roo-cline.plusButtonClicked or similar
+        const allBtns = document.querySelectorAll('a[title], button[title]');
+        const matches = [];
+        for (const btn of allBtns) {
+            const t = btn.getAttribute('title') || '';
+            if (t.toLowerCase().includes('new') || t.toLowerCase().includes('plus') || t === '+') {
+                matches.push({ tag: btn.tagName, title: t, cls: (btn.className || '').substring(0, 60) });
+            }
+        }
+
+        return JSON.stringify({ created: false, error: 'New Task button not found in panel', candidates: matches.slice(0, 5) });
+    } catch (e) {
+        return JSON.stringify({ created: false, error: e.message });
+    }
+})()

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

@@ -0,0 +1,62 @@
+/**
+ * PearAI — webview_list_sessions (webview iframe 내부에서 실행)
+ *
+ * PearAI(Roo Code/Cline 기반) 히스토리 뷰에서 세션 목록을 추출.
+ * 각 항목은 data-testid="task-item-{UUID}" 로 식별됨.
+ */
+(() => {
+    try {
+        // ─── 히스토리 항목: data-testid="task-item-*" ───
+        const taskItems = document.querySelectorAll('[data-testid^="task-item-"]');
+        
+        if (taskItems.length > 0) {
+            const sessions = [];
+            for (let i = 0; i < taskItems.length; i++) {
+                const item = taskItems[i];
+                if (!item) continue;
+                
+                const testId = item.getAttribute('data-testid') || '';
+                const taskId = testId.replace('task-item-', '');
+                
+                // 전체 텍스트에서 제목 추출
+                const fullText = (item.textContent || '').trim();
+                
+                // 구조: "MARCH 16, 1:31 AM 173 B test123 Tokens:10.4k 229"
+                // 전략: Tokens: 앞의 마지막 의미있는 텍스트를 제목으로 사용
+                let title = '';
+                let date = '';
+                
+                // 날짜 추출
+                const dateMatch = fullText.match(/^([A-Z]+\s+\d+,\s*\d+:\d+\s*[AP]M)/);
+                if (dateMatch) date = dateMatch[1];
+                
+                // 제목 추출: 날짜와 크기(B/kB) 뒤, Tokens: 앞
+                const titleMatch = fullText.match(/[AP]M[\d.\s]*[kMG]?B\s*(.*?)(?:Tokens:|$)/s);
+                if (titleMatch && titleMatch[1]) {
+                    title = titleMatch[1].trim();
+                }
+                
+                // fallback: 첫 80자
+                if (!title) {
+                    title = fullText.substring(0, 80);
+                }
+                
+                sessions.push({
+                    id: taskId,
+                    title: title.substring(0, 100),
+                    date: date,
+                    active: false
+                });
+            }
+            return JSON.stringify({ sessions: sessions });
+        }
+
+        // ─── 히스토리 뷰가 열려 있지 않음 ───
+        return JSON.stringify({ 
+            sessions: [], 
+            note: 'History view not open. Toggle history first.' 
+        });
+    } catch (e) {
+        return JSON.stringify({ sessions: [], error: String(e.message || e) });
+    }
+})()

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

@@ -1,19 +1,47 @@
 /**
  * PearAI — webview_new_session (webview iframe 내부에서 실행)
  *
- * "Start New Task" 버튼 클릭.
- * PearAI Agent(Roo Code/Cline 기반)는 Task 단위로 세션 관리.
+ * Roo Code/Cline 기반 PearAI에서 새 세션(태스크)을 시작합니다.
+ * 1) "New Task" 텍스트를 가진 버튼 클릭 시도
+ * 2) 실패 시, vscode postMessage API로 newTask 명령 전송 시도
+ * 3) 실패 시, chat-text-area를 초기화하여 새 세션 상태로 진입
  */
 (() => {
     try {
+        // Strategy 1: Find "New Task" button text
         const buttons = document.querySelectorAll('button, [role="button"]');
         for (const btn of buttons) {
             const text = (btn.textContent || '').trim();
-            if (text.includes('Start New Task') || text.includes('New Task')) {
+            if (text.includes('Start New Task') || text.includes('New Task') || text.includes('New Chat')) {
                 btn.click();
-                return JSON.stringify({ created: true, method: 'button' });
+                return JSON.stringify({ created: true, method: 'button', text });
             }
         }
+
+        // Strategy 2: Look for a "+" (plus/add) button that might create new tasks
+        for (const btn of buttons) {
+            const title = btn.getAttribute('title') || '';
+            const ariaLabel = btn.getAttribute('aria-label') || '';
+            if (title.includes('New') || ariaLabel.includes('New') || 
+                title.includes('new') || ariaLabel.includes('new')) {
+                btn.click();
+                return JSON.stringify({ created: true, method: 'title', title: title || ariaLabel });
+            }
+        }
+
+        // Strategy 3: Use vscode API to post message for new task
+        if (typeof acquireVsCodeApi !== 'undefined') {
+            const vscode = acquireVsCodeApi();
+            vscode.postMessage({ type: 'newTask' });
+            return JSON.stringify({ created: true, method: 'vscodeApi' });
+        }
+
+        // Strategy 4: If already in empty state (no messages), report as already new
+        const messages = document.querySelectorAll('[class*="message"], [class*="chat-row"]');
+        if (messages.length === 0) {
+            return JSON.stringify({ created: true, method: 'alreadyNew', note: 'No messages - already in new session state' });
+        }
+
         return JSON.stringify({ created: false, error: 'New Task button not found' });
     } catch (e) {
         return JSON.stringify({ created: false, error: e.message });

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

@@ -0,0 +1,72 @@
+/**
+ * Kiro — webview_send_message (webview iframe 내부에서 실행)
+ *
+ * Kiro의 채팅 입력은 webview iframe 안의 ProseMirror/tiptap 에디터.
+ * execCommand('insertText') + Enter 키 이벤트로 메시지 전송.
+ *
+ * 파라미터: ${ MESSAGE }
+ */
+(async () => {
+    try {
+        const msg = ${ MESSAGE };
+
+        // ─── 1. 입력 필드 찾기 ───
+        const editor =
+            document.querySelector('.tiptap.ProseMirror') ||
+            document.querySelector('[contenteditable="true"]') ||
+            document.querySelector('textarea');
+
+        if (!editor) return JSON.stringify({ sent: false, error: 'no input found in webview' });
+
+        const isTextarea = editor.tagName === 'TEXTAREA';
+
+        if (isTextarea) {
+            editor.focus();
+            const nativeSetter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value')?.set;
+            if (nativeSetter) nativeSetter.call(editor, msg);
+            else editor.value = msg;
+            editor.dispatchEvent(new Event('input', { bubbles: true }));
+            await new Promise(r => setTimeout(r, 300));
+
+            const enterOpts = { key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true, cancelable: true, composed: true };
+            editor.dispatchEvent(new KeyboardEvent('keydown', enterOpts));
+            editor.dispatchEvent(new KeyboardEvent('keypress', enterOpts));
+            editor.dispatchEvent(new KeyboardEvent('keyup', enterOpts));
+            return JSON.stringify({ sent: true });
+        }
+
+        // ─── 2. contenteditable (ProseMirror / tiptap) ───
+        editor.focus();
+        await new Promise(r => setTimeout(r, 100));
+
+        // 전체 선택 + 삭제 + 삽입
+        const sel = window.getSelection();
+        const range = document.createRange();
+        range.selectNodeContents(editor);
+        sel.removeAllRanges();
+        sel.addRange(range);
+        await new Promise(r => setTimeout(r, 50));
+
+        document.execCommand('delete', false, null);
+        await new Promise(r => setTimeout(r, 50));
+        document.execCommand('insertText', false, msg);
+
+        editor.dispatchEvent(new Event('input', { bubbles: true }));
+        await new Promise(r => setTimeout(r, 400));
+
+        // ─── 3. Enter 키 전송 ───
+        const enterOpts = {
+            key: 'Enter', code: 'Enter',
+            keyCode: 13, which: 13,
+            bubbles: true, cancelable: true, composed: true,
+        };
+        editor.dispatchEvent(new KeyboardEvent('keydown', enterOpts));
+        await new Promise(r => setTimeout(r, 50));
+        editor.dispatchEvent(new KeyboardEvent('keypress', enterOpts));
+        editor.dispatchEvent(new KeyboardEvent('keyup', enterOpts));
+
+        return JSON.stringify({ sent: true });
+    } catch (e) {
+        return JSON.stringify({ sent: false, error: e.message });
+    }
+})()

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

@@ -0,0 +1,34 @@
+/**
+ * PearAI — webview_switch_session (webview iframe 내부에서 실행)
+ *
+ * data-testid="task-item-{UUID}" 항목을 클릭하여 세션 전환.
+ * SESSION_ID는 task UUID 형태 (예: "51a08aba-1078-410c-a601-0e859205b12c")
+ */
+(() => {
+    try {
+        const targetId = ${SESSION_ID};
+
+        // ─── UUID 기반 매칭 ───
+        const selector = '[data-testid="task-item-' + targetId + '"]';
+        const targetItem = document.querySelector(selector);
+        if (targetItem) {
+            targetItem.click();
+            return JSON.stringify({ switched: true, id: targetId });
+        }
+
+        // ─── 인덱스 기반 fallback (숫자로 전달된 경우) ───
+        const index = parseInt(targetId, 10);
+        if (!isNaN(index)) {
+            const allItems = document.querySelectorAll('[data-testid^="task-item-"]');
+            if (allItems[index]) {
+                allItems[index].click();
+                const taskId = (allItems[index].getAttribute('data-testid') || '').replace('task-item-', '');
+                return JSON.stringify({ switched: true, id: taskId, method: 'index' });
+            }
+        }
+
+        return JSON.stringify({ switched: false, error: 'Task item not found: ' + targetId });
+    } catch (e) {
+        return JSON.stringify({ switched: false, error: e.message });
+    }
+})()

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

@@ -1,13 +1,63 @@
 /**
  * Trae — send_message
  *
- * Trae는 .chat-input-v2-input-box-editable (contenteditable) 사용.
- * 메인 DOM에서 접근 가능 → selector를 반환하여 데몬의 typeAndSend가 처리.
+ * Trae는 .chat-input-v2-input-box-editable (contenteditable / Lexical) 사용.
+ * Lexical의 내부 state를 올바르게 업데이트하기 위해 Selection API + execCommand 사용.
  *
  * 파라미터: ${ MESSAGE }
  */
-(() => {
+(async () => {
     try {
+        const msg = ${ MESSAGE };
+
+        // ─── 1. 입력 필드 찾기 ───
+        const editor =
+            document.querySelector('.chat-input-v2-input-box-editable') ||
+            document.querySelector('[contenteditable="true"][role="textbox"]') ||
+            document.querySelector('[data-lexical-editor="true"]');
+
+        if (!editor) return JSON.stringify({ sent: false, error: 'no input found' });
+
+        // ─── 2. 포커스 + 전체 선택 + 삭제 + 삽입 ───
+        editor.focus();
+        await new Promise(r => setTimeout(r, 100));
+
+        // Selection API로 전체 선택
+        const sel = window.getSelection();
+        const range = document.createRange();
+        range.selectNodeContents(editor);
+        sel.removeAllRanges();
+        sel.addRange(range);
+        await new Promise(r => setTimeout(r, 50));
+
+        // 삭제 후 삽입 (Lexical state 동기화)
+        document.execCommand('delete', false, null);
+        await new Promise(r => setTimeout(r, 50));
+        document.execCommand('insertText', false, msg);
+        
+        // Input 이벤트
+        editor.dispatchEvent(new Event('input', { bubbles: true }));
+        await new Promise(r => setTimeout(r, 500));
+
+        // ─── 3. send 버튼 클릭 ───
+        const sendBtn = document.querySelector('.chat-input-v2-send-button');
+        if (sendBtn && !sendBtn.disabled) {
+            sendBtn.click();
+            return JSON.stringify({ sent: true, method: 'button' });
+        }
+
+        // 버튼이 아직 disabled이면 Enter 키 시도
+        const enterOpts = {
+            key: 'Enter', code: 'Enter',
+            keyCode: 13, which: 13,
+            bubbles: true, cancelable: true, composed: true,
+        };
+        editor.dispatchEvent(new KeyboardEvent('keydown', enterOpts));
+        await new Promise(r => setTimeout(r, 50));
+        editor.dispatchEvent(new KeyboardEvent('keypress', enterOpts));
+        editor.dispatchEvent(new KeyboardEvent('keyup', enterOpts));
+
+        // 여전히 안 되면 needsTypeAndSend 폴백
         return JSON.stringify({
             sent: false,
             needsTypeAndSend: true,

package/providers/_builtin/validate.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+/**
+ * ADHDev Provider Validator
+ * 
+ * Usage:
+ *   node validate.js                     # validate all providers
+ *   node validate.js ide/my-ide/provider.js  # validate a single file
+ */
+const fs = require('fs');
+const path = require('path');
+
+const REQUIRED_FIELDS = ['type', 'name', 'category'];
+const VALID_CATEGORIES = ['ide', 'extension', 'cli', 'acp'];
+const USED_PORTS = new Map();
+const USED_TYPES = new Map();
+
+let errors = 0;
+let warnings = 0;
+let validated = 0;
+
+function validate(filePath) {
+  const rel = path.relative(process.cwd(), filePath);
+  
+  // 1. Syntax check
+  try {
+    delete require.cache[require.resolve(filePath)];
+  } catch {}
+  
+  let mod;
+  try {
+    mod = require(filePath);
+  } catch (e) {
+    console.error(`❌ ${rel}: syntax error — ${e.message}`);
+    errors++;
+    return;
+  }
+
+  // 2. Required fields
+  for (const field of REQUIRED_FIELDS) {
+    if (!mod[field]) {
+      console.error(`❌ ${rel}: missing required field '${field}'`);
+      errors++;
+      return;
+    }
+  }
+
+  // 3. Valid category
+  if (!VALID_CATEGORIES.includes(mod.category)) {
+    console.error(`❌ ${rel}: invalid category '${mod.category}' (must be: ${VALID_CATEGORIES.join(', ')})`);
+    errors++;
+    return;
+  }
+
+  // 4. Unique type
+  if (USED_TYPES.has(mod.type)) {
+    console.error(`❌ ${rel}: duplicate type '${mod.type}' (also in ${USED_TYPES.get(mod.type)})`);
+    errors++;
+    return;
+  }
+  USED_TYPES.set(mod.type, rel);
+
+  // 5. IDE-specific checks
+  if (mod.category === 'ide') {
+    if (!mod.cdpPorts || !Array.isArray(mod.cdpPorts) || mod.cdpPorts.length < 2) {
+      console.warn(`⚠  ${rel}: IDE missing cdpPorts [primary, fallback]`);
+      warnings++;
+    } else {
+      for (const port of mod.cdpPorts) {
+        if (USED_PORTS.has(port)) {
+          console.error(`❌ ${rel}: CDP port ${port} conflicts with ${USED_PORTS.get(port)}`);
+          errors++;
+        }
+        USED_PORTS.set(port, rel);
+      }
+    }
+
+    if (!mod.cli) {
+      console.warn(`⚠  ${rel}: IDE missing 'cli' field`);
+      warnings++;
+    }
+
+    if (!mod.paths) {
+      console.warn(`⚠  ${rel}: IDE missing 'paths' (install detection won't work)`);
+      warnings++;
+    }
+  }
+
+  // 6. ACP-specific checks
+  if (mod.category === 'acp') {
+    if (!mod.spawn || !mod.spawn.command) {
+      console.warn(`⚠  ${rel}: ACP missing spawn.command`);
+      warnings++;
+    }
+  }
+
+  // 7. Scripts check
+  if (mod.category === 'ide' || mod.category === 'extension') {
+    const hasRead = mod.scripts?.readChat || mod.scripts?.webviewReadChat;
+    const hasSend = mod.scripts?.sendMessage || mod.scripts?.webviewSendMessage;
+    if (!hasRead) {
+      console.warn(`⚠  ${rel}: no readChat/webviewReadChat script`);
+      warnings++;
+    }
+    if (!hasSend) {
+      console.warn(`⚠  ${rel}: no sendMessage/webviewSendMessage script`);
+      warnings++;
+    }
+  }
+
+  // 8. Webview IDE consistency
+  if (mod.category === 'ide' && mod.webviewMatchText) {
+    if (!mod.scripts?.webviewReadChat) {
+      console.warn(`⚠  ${rel}: has webviewMatchText but no webviewReadChat script`);
+      warnings++;
+    }
+  }
+
+  validated++;
+  console.log(`✅ ${rel}: ${mod.type} (${mod.category}) — ${mod.name}`);
+}
+
+function scanDir(dir) {
+  if (!fs.existsSync(dir)) return;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name.startsWith('_') || entry.name.startsWith('.')) continue;
+      scanDir(full);
+    } else if (entry.name === 'provider.js') {
+      validate(full);
+    }
+  }
+}
+
+// ─── Main ───
+const args = process.argv.slice(2);
+
+if (args.length > 0) {
+  // Validate specific file(s)
+  for (const arg of args) {
+    const filePath = path.resolve(arg);
+    if (!fs.existsSync(filePath)) {
+      console.error(`❌ File not found: ${arg}`);
+      errors++;
+      continue;
+    }
+    validate(filePath);
+  }
+} else {
+  // Validate all
+  console.log('🔍 Validating all providers...\n');
+  scanDir(process.cwd());
+}
+
+console.log(`\n━━━ Result: ${validated} passed, ${errors} errors, ${warnings} warnings ━━━`);
+process.exit(errors > 0 ? 1 : 0);