adhdev 0.1.53 → 0.1.54

package/package.json

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

package/providers/_builtin/CONTRIBUTING.md

@@ -0,0 +1,141 @@
+# Contributing to ADHDev Providers
+
+> How to add new providers or improve existing ones for ADHDev.
+
+## Quick Start
+
+### 1. Fork & Clone
+
+```bash
+git clone https://github.com/YOUR_USERNAME/adhdev-providers.git
+cd adhdev-providers
+```
+
+### 2. Create a Provider
+
+Create a `provider.js` in the appropriate category directory:
+
+```bash
+# IDE provider
+mkdir -p ide/my-ide && touch ide/my-ide/provider.js
+
+# CLI agent
+mkdir -p cli/my-cli && touch cli/my-cli/provider.js
+
+# ACP agent
+mkdir -p acp/my-agent && touch acp/my-agent/provider.js
+
+# VS Code extension
+mkdir -p extension/my-ext && touch extension/my-ext/provider.js
+```
+
+### 3. Provider Structure
+
+```javascript
+module.exports = {
+  type: 'my-ide',           // unique identifier (must not conflict)
+  name: 'My IDE',           // display name
+  category: 'ide',          // 'ide' | 'extension' | 'cli' | 'acp'
+  displayName: 'My IDE',
+  icon: '🔧',
+
+  // IDE: CDP configuration
+  cdpPorts: [9357, 9358],   // use next available ports (see table below)
+  cli: 'my-ide',
+  paths: { darwin: ['/Applications/My IDE.app'] },
+
+  // CDP scripts
+  scripts: {
+    readChat() { return `(() => { /* ... */ })()`; },
+    sendMessage(text) { return `(() => { /* ... */ })()`; },
+  },
+};
+```
+
+> 📖 Full guide: [PROVIDER_GUIDE.md](https://github.com/vilmire/adhdev/blob/main/docs/PROVIDER_GUIDE.md)
+
+### 4. Validate
+
+```bash
+# Syntax check
+node -c ide/my-ide/provider.js
+
+# Schema validation (required fields, port conflicts, etc.)
+node validate.js ide/my-ide/provider.js
+
+# Validate all providers
+node validate.js
+```
+
+### 5. Local Testing
+
+```bash
+# If ADHDev is installed:
+# Copy your provider to the user directory for instant loading
+mkdir -p ~/.adhdev/providers/ide/my-ide
+cp ide/my-ide/provider.js ~/.adhdev/providers/ide/my-ide/
+
+# Restart daemon to pick up changes
+adhdev daemon:restart
+
+# Test scripts via DevConsole
+# Open http://127.0.0.1:19280 → IDE tab → Scripts → Run
+```
+
+### 6. Submit PR
+
+```bash
+git checkout -b feat/add-my-ide
+git add -A
+git commit -m "feat: add My IDE provider"
+git push origin feat/add-my-ide
+# Open a Pull Request on GitHub
+```
+
+---
+
+## PR Checklist
+
+- [ ] `node validate.js` passes with no errors
+- [ ] `type` does not conflict with existing providers
+- [ ] CDP ports do not overlap with existing ones (for IDE providers)
+- [ ] At least `readChat` + `sendMessage` scripts implemented
+- [ ] Tested via DevConsole (if ADHDev is available)
+
+---
+
+## Reference Implementations
+
+| Category | Reference | Key Features |
+|----------|-----------|-------------|
+| **IDE (mainframe)** | `ide/cursor/provider.js` | CDP evaluate, `inputMethod` |
+| **IDE (webview)** | `ide/kiro/provider.js` | `webviewMatchText`, `webview*` scripts |
+| **CLI** | `cli/gemini-cli/provider.js` | `aliases`, spawn config |
+| **ACP** | `acp/gemini-cli/provider.js` | `auth`, `spawn`, `settings` |
+| **Extension** | `extension/cline/provider.js` | `extensionIdPattern`, webview |
+
+---
+
+## CDP Port Registry
+
+| Port | Provider |
+|------|----------|
+| 9333–9334 | Cursor |
+| 9335–9336 | Antigravity |
+| 9337–9338 | Windsurf |
+| 9339–9340 | VS Code |
+| 9341–9342 | VS Code Insiders |
+| 9343–9344 | VSCodium |
+| 9351–9352 | Kiro |
+| 9353–9354 | Trae |
+| 9355–9356 | PearAI |
+
+**Next available: 9357+**
+
+---
+
+## Need Help?
+
+- Full provider guide: [PROVIDER_GUIDE.md](https://github.com/vilmire/adhdev/blob/main/docs/PROVIDER_GUIDE.md)
+- DOM exploration tips: PROVIDER_GUIDE.md §6
+- DevConsole usage: PROVIDER_GUIDE.md §4

package/providers/_builtin/README.md

@@ -0,0 +1,51 @@
+# ADHDev Providers
+
+> IDE, CLI, Extension, and ACP provider definitions for [ADHDev](https://github.com/vilmire/adhdev).
+
+## Structure
+
+```
+├── ide/            — IDE providers (Cursor, Windsurf, Kiro, PearAI, etc.)
+├── cli/            — CLI agent providers (Gemini CLI, Claude Code, Codex CLI)
+├── extension/      — VS Code extension providers (Cline, Roo Code)
+├── acp/            — ACP agent providers (40+ agents)
+├── _helpers/       — Shared utility functions
+├── validate.js     — Provider schema validator
+└── CONTRIBUTING.md — How to add a new provider
+```
+
+## Adding a New Provider
+
+1. Create `provider.js` in the appropriate category:
+
+```bash
+mkdir -p ide/my-ide
+# Edit ide/my-ide/provider.js
+```
+
+2. Validate:
+
+```bash
+node validate.js ide/my-ide/provider.js
+```
+
+3. Submit a PR.
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full workflow, and  
+[PROVIDER_GUIDE.md](https://github.com/vilmire/adhdev/blob/main/docs/PROVIDER_GUIDE.md) for the complete specification.
+
+## How It Works
+
+This repository is consumed by ADHDev in three ways:
+
+| Method | When | Directory |
+|--------|------|-----------|
+| **Bundled** | `npm install -g adhdev` | `_builtin/` (offline fallback) |
+| **Auto-updated** | Every daemon start | `~/.adhdev/providers/.upstream/` |
+| **User custom** | Manual | `~/.adhdev/providers/` (never overwritten) |
+
+Loading priority: **User custom > Auto-updated > Bundled**
+
+## License
+
+MIT

package/providers/_builtin/_helpers/index.js

@@ -0,0 +1,188 @@
+/**
+ * Provider Helpers — 공유 유틸리티
+ * 
+ * 각 provider.js에서 require해 사용할 수 있는 공통 함수들.
+ * 사용은 선택사항 — 각 provider.js는 독립적이어도 됨.
+ * 
+ * 사용법 (provider.js 내부):
+ *   const { getWebviewDoc, htmlToMd, waitFor } = require('../../_helpers/index.js');
+ */
+
+/**
+ * Extension webview iframe의 contentDocument 접근
+ * @param {string} [selector='iframe'] - iframe 셀렉터
+ * @returns {string} CDP evaluate용 JS 코드 (document 변수를 설정)
+ */
+function getWebviewDoc(selector = 'iframe') {
+  return `
+    const _iframe = document.querySelector('${selector}');
+    const _doc = _iframe ? (_iframe.contentDocument || _iframe.contentWindow?.document) : document;
+  `;
+}
+
+/**
+ * React Fiber 데이터 추출 헬퍼 코드
+ * 특정 엔트리 포인트에서 시작해 memoizedState를 순회
+ * @param {string[]} entrySelectors - 엔트리 포인트 CSS 셀렉터
+ * @param {number} [maxDepth=200] - Fiber 트리 최대 순회 깊이
+ * @returns {string} CDP evaluate용 JS 코드 (변수 _fiberData를 설정)
+ */
+function getFiber(entrySelectors, maxDepth = 200) {
+  const sels = JSON.stringify(entrySelectors);
+  return `
+    let _fiberData = null;
+    const _entryPoints = ${sels};
+    for (const sel of _entryPoints) {
+      const el = document.querySelector(sel);
+      if (!el) continue;
+      const fk = Object.keys(el).find(k => k.startsWith('__reactFiber'));
+      if (!fk) continue;
+      let fib = el[fk];
+      for (let d = 0; d < ${maxDepth} && fib; d++) {
+        if (fib.memoizedState) {
+          let s = fib.memoizedState;
+          while (s) {
+            try {
+              const memo = s.memoizedState;
+              if (memo && typeof memo === 'object') {
+                _fiberData = memo;
+                break;
+              }
+            } catch(e) {}
+            s = s.next;
+          }
+        }
+        if (_fiberData) break;
+        fib = fib.return;
+      }
+      if (_fiberData) break;
+    }
+  `;
+}
+
+/**
+ * 텍스트 입력 + Enter 전송 코드 생성
+ * @param {string} varName - 텍스트가 저장된 변수명
+ * @param {string} selectorExpr - 에디터 요소 참조 JS 표현식
+ * @returns {string} CDP evaluate용 JS 코드
+ */
+function typeAndSubmit(varName, selectorExpr) {
+  return `
+    const _editor = ${selectorExpr};
+    if (_editor) {
+      _editor.focus();
+      document.execCommand('selectAll', false, null);
+      document.execCommand('delete', false, null);
+      document.execCommand('insertText', false, ${varName});
+      _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));
+    }
+  `;
+}
+
+/**
+ * 요소 대기 코드 생성
+ * @param {string} selector - CSS 셀렉터
+ * @param {number} [timeout=5000] - 최대 대기 시간 (ms)
+ * @returns {string} CDP evaluate용 JS 코드 (표현식 → 요소 또는 null)
+ */
+function waitFor(selector, timeout = 5000) {
+  return `
+    await new Promise((resolve) => {
+      const _t = Date.now();
+      const _check = () => {
+        const el = document.querySelector('${selector}');
+        if (el && el.offsetWidth > 0) return resolve(el);
+        if (Date.now() - _t > ${timeout}) return resolve(null);
+        setTimeout(_check, 200);
+      };
+      _check();
+    })
+  `;
+}
+
+/**
+ * HTML → Markdown 변환 함수 (CDP 코드 문자열)
+ * 대시보드가 ReactMarkdown+remarkGfm을 사용하므로 HTML을 GFM으로 변환 필요
+ * @returns {string} htmlToMd, childrenToMd 함수 선언 코드
+ */
+function htmlToMdCode() {
+  return `
+    function htmlToMd(node) {
+      if (node.nodeType === 3) return node.textContent || '';
+      if (node.nodeType !== 1) return '';
+      const tag = node.tagName;
+      if (tag === 'STYLE' || tag === 'SCRIPT' || tag === 'SVG') return '';
+      if (tag === 'TABLE') {
+        const rows = Array.from(node.querySelectorAll('tr'));
+        if (rows.length === 0) return '';
+        const table = rows.map(tr => Array.from(tr.querySelectorAll('th, td')).map(cell => (cell.textContent || '').trim().replace(/\\|/g, '\\\\|')));
+        if (table.length === 0) return '';
+        const colCount = Math.max(...table.map(r => r.length));
+        const header = table[0];
+        const sep = Array(colCount).fill('---');
+        const body = table.slice(1);
+        let md = '| ' + header.join(' | ') + ' |\\n';
+        md += '| ' + sep.join(' | ') + ' |\\n';
+        for (const row of body) {
+          while (row.length < colCount) row.push('');
+          md += '| ' + row.join(' | ') + ' |\\n';
+        }
+        return '\\n' + md + '\\n';
+      }
+      if (tag === 'UL') return '\\n' + Array.from(node.children).map(li => '- ' + childrenToMd(li).trim()).join('\\n') + '\\n';
+      if (tag === 'OL') return '\\n' + Array.from(node.children).map((li, i) => (i + 1) + '. ' + childrenToMd(li).trim()).join('\\n') + '\\n';
+      if (tag === 'LI') return childrenToMd(node);
+      if (tag === 'H1') return '\\n# ' + childrenToMd(node).trim() + '\\n';
+      if (tag === 'H2') return '\\n## ' + childrenToMd(node).trim() + '\\n';
+      if (tag === 'H3') return '\\n### ' + childrenToMd(node).trim() + '\\n';
+      if (tag === 'H4') return '\\n#### ' + childrenToMd(node).trim() + '\\n';
+      if (tag === 'STRONG' || tag === 'B') return '**' + childrenToMd(node).trim() + '**';
+      if (tag === 'EM' || tag === 'I') return '*' + childrenToMd(node).trim() + '*';
+      if (tag === 'PRE') {
+        const codeEl = node.querySelector('code');
+        const lang = codeEl ? (codeEl.className.match(/language-(\\w+)/)?.[1] || '') : '';
+        const code = (codeEl || node).textContent || '';
+        return '\\n\`\`\`' + lang + '\\n' + code.trim() + '\\n\`\`\`\\n';
+      }
+      if (tag === 'CODE') {
+        if (node.parentElement && node.parentElement.tagName === 'PRE') return node.textContent || '';
+        return '\`' + (node.textContent || '').trim() + '\`';
+      }
+      if (tag === 'BLOCKQUOTE') return '\\n> ' + childrenToMd(node).trim().replace(/\\n/g, '\\n> ') + '\\n';
+      if (tag === 'A') return '[' + childrenToMd(node).trim() + '](' + (node.getAttribute('href') || '') + ')';
+      if (tag === 'BR') return '\\n';
+      if (tag === 'P') return '\\n' + childrenToMd(node).trim() + '\\n';
+      return childrenToMd(node);
+    }
+    function childrenToMd(node) {
+      return Array.from(node.childNodes).map(htmlToMd).join('');
+    }
+  `;
+}
+
+/**
+ * 노이즈 텍스트 필터링 (상태 메시지, MCP 등)
+ * @param {string} text - 원본 텍스트
+ * @returns {boolean} true면 노이즈
+ */
+function isNoiseText(text) {
+  const low = (text || '').trim().toLowerCase();
+  if (low.length > 60) return false;
+  if (/^(analyzed\s+\d|edited\s+\d|ran\s+\S|terminal\s|reading|searching)/i.test(low)) return true;
+  if (/^(mcp|customizationmcp|serversexport)/i.test(low)) return true;
+  return false;
+}
+
+module.exports = {
+  getWebviewDoc,
+  getFiber,
+  typeAndSubmit,
+  waitFor,
+  htmlToMdCode,
+  isNoiseText,
+};

package/providers/_builtin/acp/agentpool/provider.js

@@ -0,0 +1,59 @@
+/**
+ * AgentPool — ACP Provider
+ * 
+ * Multi-agent Python framework with ACP integration
+ * https://phil65.github.io/agentpool/advanced/acp-integration/
+ * 
+ * Install: pip install agentpool  (Python/uvx)
+ * 
+ * @type {import('../../../../src/providers/contracts').ProviderModule}
+ */
+module.exports = {
+  type: 'agentpool-acp',
+  name: 'AgentPool (ACP)',
+  category: 'acp',
+
+  displayName: 'AgentPool',
+  icon: '🏊',
+  install: 'pip install agentpool  (Python/uvx)',
+
+  spawn: {
+    command: 'agentpool',
+    args: ['acp'],
+    shell: false,
+  },
+
+  auth: [
+    {
+      type: 'agent',
+      id: 'agentpool',
+      name: 'AgentPool Auth',
+      description: 'Configure provider through AgentPool setup',
+    },
+  ],
+
+  settings: {
+    approvalAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Approval Alerts',
+      description: 'Show notification when agent requires approval',
+    },
+    longGeneratingAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Long Generation Alert',
+      description: 'Alert when generation takes too long',
+    },
+    longGeneratingThresholdSec: {
+      type: 'number',
+      default: 180,
+      public: true,
+      label: 'Long Generation Threshold (sec)',
+      min: 30,
+      max: 600,
+    },
+  },
+};

package/providers/_builtin/acp/amp/provider.js

@@ -0,0 +1,61 @@
+/**
+ * Amp — ACP Provider
+ * 
+ * ACP wrapper for Amp - the frontier coding agent
+ * https://github.com/tao12345666333/amp-acp
+ * 
+ * Install: Binary download from GitHub releases (no npm package)
+ *   macOS: curl -L https://github.com/tao12345666333/amp-acp/releases/latest/download/amp-acp-darwin-aarch64.tar.gz | tar xz
+ *   Linux: curl -L https://github.com/tao12345666333/amp-acp/releases/latest/download/amp-acp-linux-x86_64.tar.gz | tar xz
+ * 
+ * @type {import('../../../../src/providers/contracts').ProviderModule}
+ */
+module.exports = {
+  type: 'amp-acp',
+  name: 'Amp (ACP)',
+  category: 'acp',
+
+  displayName: 'Amp',
+  icon: '⚡',
+  install: 'Binary download from GitHub: https://github.com/tao12345666333/amp-acp/releases',
+
+  spawn: {
+    command: 'amp-acp',
+    args: [],
+    shell: false,
+  },
+
+  auth: [
+    {
+      type: 'agent',
+      id: 'amp-auth',
+      name: 'Amp Authentication',
+      description: 'Authenticate through Amp setup flow',
+    },
+  ],
+
+  settings: {
+    approvalAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Approval Alerts',
+      description: 'Show notification when Amp requires approval',
+    },
+    longGeneratingAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Long Generation Alert',
+      description: 'Alert when generation takes too long',
+    },
+    longGeneratingThresholdSec: {
+      type: 'number',
+      default: 180,
+      public: true,
+      label: 'Long Generation Threshold (sec)',
+      min: 30,
+      max: 600,
+    },
+  },
+};

package/providers/_builtin/acp/auggie/provider.js

@@ -0,0 +1,60 @@
+/**
+ * Auggie CLI — ACP Provider
+ * 
+ * Augment Code's powerful software agent
+ * https://github.com/augmentcode/auggie-zed-extension
+ * 
+ * Install: npm install -g @augmentcode/auggie
+ * 
+ * @type {import('../../../../src/providers/contracts').ProviderModule}
+ */
+module.exports = {
+  type: 'auggie-acp',
+  name: 'Auggie CLI (ACP)',
+  category: 'acp',
+
+  displayName: 'Auggie CLI',
+  icon: '🧠',
+  install: 'npm install -g @augmentcode/auggie',
+
+  spawn: {
+    command: 'auggie',
+    args: ['--acp'],
+    shell: false,
+    env: { AUGMENT_DISABLE_AUTO_UPDATE: '1' },
+  },
+
+  auth: [
+    {
+      type: 'agent',
+      id: 'augment',
+      name: 'Augment Code Auth',
+      description: 'Authenticate through Augment Code setup',
+    },
+  ],
+
+  settings: {
+    approvalAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Approval Alerts',
+      description: 'Show notification when agent requires approval',
+    },
+    longGeneratingAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Long Generation Alert',
+      description: 'Alert when generation takes too long',
+    },
+    longGeneratingThresholdSec: {
+      type: 'number',
+      default: 180,
+      public: true,
+      label: 'Long Generation Threshold (sec)',
+      min: 30,
+      max: 600,
+    },
+  },
+};

package/providers/_builtin/acp/autodev/provider.js

@@ -0,0 +1,59 @@
+/**
+ * AutoDev — ACP Provider
+ * 
+ * AI-powered coding assistant by Phodal
+ * https://github.com/phodal/auto-dev
+ * 
+ * Install: Download from https://github.com/phodal/auto-dev/releases
+ * 
+ * @type {import('../../../../src/providers/contracts').ProviderModule}
+ */
+module.exports = {
+  type: 'autodev-acp',
+  name: 'AutoDev (ACP)',
+  category: 'acp',
+
+  displayName: 'AutoDev',
+  icon: '🤖',
+  install: 'Download from https://github.com/phodal/auto-dev/releases',
+
+  spawn: {
+    command: 'autodev',
+    args: ['acp'],
+    shell: false,
+  },
+
+  auth: [
+    {
+      type: 'agent',
+      id: 'autodev',
+      name: 'AutoDev Auth',
+      description: 'Configure provider through AutoDev setup',
+    },
+  ],
+
+  settings: {
+    approvalAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Approval Alerts',
+      description: 'Show notification when agent requires approval',
+    },
+    longGeneratingAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Long Generation Alert',
+      description: 'Alert when generation takes too long',
+    },
+    longGeneratingThresholdSec: {
+      type: 'number',
+      default: 180,
+      public: true,
+      label: 'Long Generation Threshold (sec)',
+      min: 30,
+      max: 600,
+    },
+  },
+};

package/providers/_builtin/acp/autohand/provider.js

@@ -0,0 +1,59 @@
+/**
+ * Autohand Code — ACP Provider
+ * 
+ * AI coding agent powered by Autohand AI
+ * https://github.com/autohandai/autohand-acp
+ * 
+ * Install: npm install -g @autohandai/autohand-acp
+ * 
+ * @type {import('../../../../src/providers/contracts').ProviderModule}
+ */
+module.exports = {
+  type: 'autohand-acp',
+  name: 'Autohand Code (ACP)',
+  category: 'acp',
+
+  displayName: 'Autohand Code',
+  icon: '🤖',
+  install: 'npm install -g @autohandai/autohand-acp',
+
+  spawn: {
+    command: 'autohand-acp',
+    args: [],
+    shell: false,
+  },
+
+  auth: [
+    {
+      type: 'agent',
+      id: 'autohand',
+      name: 'Autohand Auth',
+      description: 'Authenticate through Autohand AI setup',
+    },
+  ],
+
+  settings: {
+    approvalAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Approval Alerts',
+      description: 'Show notification when agent requires approval',
+    },
+    longGeneratingAlert: {
+      type: 'boolean',
+      default: true,
+      public: true,
+      label: 'Long Generation Alert',
+      description: 'Alert when generation takes too long',
+    },
+    longGeneratingThresholdSec: {
+      type: 'number',
+      default: 180,
+      public: true,
+      label: 'Long Generation Threshold (sec)',
+      min: 30,
+      max: 600,
+    },
+  },
+};