@adhdev/daemon-core 0.6.58 → 0.6.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/daemon-core",
-  "version": "0.6.58",
+  "version": "0.6.60",
   "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/detection/ide-detector.ts

@@ -40,7 +40,7 @@ export interface IDEDefinition {
 }
 
 // No builtin IDE definitions — provider.js registered via registerToDetector() is the single source of truth
-// To add new IDE: create providers/_builtin/ide/{name}/provider.js then define paths/cli
+// To add new IDE: create providers in ~/.adhdev/providers/ide/{name}/provider.js
 const BUILTIN_IDE_DEFINITIONS: IDEDefinition[] = [];
 
 // ─── Runtime Registry ───────────────────────────

package/src/providers/provider-loader.ts

@@ -2,7 +2,7 @@
  * ProviderLoader — Provider discovery + OS/version override resolution
  * 
  * Role:
- * 1. Load provider.js from _builtin/ directory
+ * 1. Load providers from upstream auto-download (~/.adhdev/providers/.upstream/)
  * 2. Load user custom from ~/.adhdev/providers/ (overrides)
  * 3. Apply OS/version overrides (process.platform + detected IDE version)
  * 4. Hot-reload support (fs.watch)
@@ -53,14 +53,11 @@ export class ProviderLoader {
     /** Disable upstream auto-download (for dev/testing/OSS) */
     disableUpstream?: boolean;
   }) {
- // Builtin directories: providers/_builtin/
+ // Legacy builtin directories (no longer shipped; providers come from upstream auto-download)
     if (options?.builtinDir) {
         this.builtinDirs = Array.isArray(options.builtinDir) ? options.builtinDir : [options.builtinDir];
     } else {
-        // Handle both development (src/providers -> ../../providers) and production (dist -> ../providers)
-        const bundledDir = path.resolve(__dirname, '../providers/_builtin');
-        const devDir = path.resolve(__dirname, '../../providers/_builtin');
-        this.builtinDirs = [fs.existsSync(devDir) ? devDir : bundledDir];
+        this.builtinDirs = [];
     }
  // User custom directory: ~/.adhdev/providers/
     this.userDir = options?.userDir ||

package/providers/_builtin/.github/workflows/generate-registry.yml

@@ -1,76 +0,0 @@
-name: Generate Registry
-on:
-  push:
-    branches: [main]
-    paths:
-      - '**/provider.json'
-      - '**/scripts.js'
-
-jobs:
-  generate-registry:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Generate registry.json
-        run: |
-          python3 -c "
-          import json, glob
-
-          registry = {'version': '$(date +%Y.%m.%d)', 'providers': {}}
-
-          for pj in sorted(glob.glob('**/provider.json', recursive=True)):
-              parts = pj.split('/')
-              # Skip version subdirs (1.107/, 0.48/ etc)
-              if any(p[0].isdigit() and '.' in p for p in parts):
-                  continue
-              if 'legacy' in parts:
-                  continue
-              try:
-                  with open(pj) as f:
-                      d = json.load(f)
-                  if 'type' not in d or 'category' not in d:
-                      continue
-                  entry = {
-                      'providerVersion': d.get('providerVersion', '0.0.0'),
-                      'category': d['category'],
-                      'name': d.get('name', d['type']),
-                  }
-                  if d.get('compatibility'):
-                      entry['compatibility'] = d['compatibility']
-                  registry['providers'][d['type']] = entry
-              except: pass
-
-          with open('registry.json', 'w') as f:
-              json.dump(registry, f, indent=2, ensure_ascii=False)
-          print(f'Generated registry.json with {len(registry[\"providers\"])} providers')
-          "
-
-      - name: Commit registry.json
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add registry.json
-          git diff --cached --quiet || git commit -m "chore: auto-generate registry.json"
-          git push
-
-      - name: Update submodule pointer in parent repo (adhdev-cloud)
-        env:
-          PAT: ${{ secrets.PARENT_REPO_PAT }}
-        run: |
-          SUBMODULE_SHA=$(git rev-parse HEAD)
-          git clone --depth=1 https://x-access-token:${PAT}@github.com/vilmire/adhdev-cloud.git /tmp/adhdev-cloud
-          cd /tmp/adhdev-cloud
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git submodule update --init packages/daemon-core/providers/_builtin
-          cd packages/daemon-core/providers/_builtin
-          git fetch origin main
-          git checkout main
-          git reset --hard ${SUBMODULE_SHA}
-          cd /tmp/adhdev-cloud
-          git add packages/daemon-core/providers/_builtin
-          git diff --cached --quiet || git commit -m "chore: sync _builtin providers submodule [skip ci]"
-          git push

package/providers/_builtin/COMPATIBILITY.md

@@ -1,217 +0,0 @@
-# ADHDev Provider Compatibility Matrix
-
-> **Last updated:** 2026-03-22  
-> **How to contribute:** Submit a PR updating the status for your OS/version. See [Status Legend](#status-legend) below.
-
-## Status Legend
-
-| Symbol | Meaning |
-|--------|---------|
-| ✅ | Tested & working |
-| ⚠️ | Partial — works with known issues (add note) |
-| ❌ | Tested & not working |
-| ➖ | Not applicable (tool doesn't exist on this OS) |
-| ❓ | Untested — **needs volunteer** |
-
----
-
-## IDE Providers
-
-> Detected via process scanning + controlled via CDP (Chrome DevTools Protocol).
-
-### OS Compatibility
-
-| Provider | Display Name | macOS | Windows | Linux | Tested Versions | Notes |
-|----------|-------------|-------|---------|-------|-----------------|-------|
-| `antigravity` | Antigravity | ❓ | ❓ | ❓ | | |
-| `cursor` | Cursor | ❓ | ❓ | ❓ | | |
-| `kiro` | Kiro | ❓ | ❓ | ❓ | | |
-| `pearai` | PearAI | ❓ | ❓ | ❓ | | |
-| `trae` | Trae | ❓ | ❓ | ❓ | | |
-| `vscode` | Visual Studio Code | ❓ | ❓ | ❓ | | Detection only (no scripts) |
-| `vscode-insiders` | VS Code Insiders | ❓ | ❓ | ❓ | | Detection only (no scripts) |
-| `vscodium` | VSCodium | ❓ | ❓ | ❓ | | Detection only (no scripts) |
-| `windsurf` | Windsurf | ❓ | ❓ | ❓ | | |
-
-### Script Methods — IDE
-
-| Provider | readChat | sendMessage | openPanel | listSessions | switchSession | newSession | listModels | setModel | listModes | setMode | resolveAction | focusEditor |
-|----------|----------|-------------|-----------|--------------|---------------|------------|------------|----------|-----------|---------|---------------|-------------|
-| `antigravity` | ✅ | ✅ | ➖ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `cursor` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `kiro` | webview | webview | ✅ | webview | webview¹ | webview | webview | webview | webview | webview | ✅ | ✅ |
-| `pearai` | webview | webview | ✅ | ✅/webview | webview¹ | ✅ | webview | webview | webview | webview | webview | ✅ |
-| `trae` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `vscode` | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ |
-| `vscode-insiders` | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ |
-| `vscodium` | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ |
-| `windsurf` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-
-> ¹ `webview` = method operates via webview bridge (internal iframe communication), not direct DOM.  
-> `➖` = detection only, no AI chat integration scripts.
-
----
-
-## Extension Providers
-
-> VS Code extensions detected inside IDE instances, controlled via CDP within the host IDE.
-
-### OS Compatibility
-
-| Provider | Display Name | macOS | Windows | Linux | Tested Versions | Notes |
-|----------|-------------|-------|---------|-------|-----------------|-------|
-| `cline` | Cline | ❓ | ❓ | ❓ | | |
-| `roo-code` | Roo Code | ❓ | ❓ | ❓ | | |
-
-### Script Methods — Extension
-
-| Provider | readChat | sendMessage | openPanel | listSessions | switchSession | newSession | listModels | setModel | listModes | setMode | resolveAction | focusEditor |
-|----------|----------|-------------|-----------|--------------|---------------|------------|------------|----------|-----------|---------|---------------|-------------|
-| `cline` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `roo-code` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-
----
-
-## CLI Providers
-
-> Terminal-based agents spawned as child processes, controlled via PTY.
-
-### OS Compatibility
-
-| Provider | Display Name | macOS | Windows | Linux | Tested Versions | Notes |
-|----------|-------------|-------|---------|-------|-----------------|-------|
-| `claude-cli` | Claude Code | ❓ | ❓ | ❓ | | |
-| `codex-cli` | Codex CLI | ❓ | ❓ | ❓ | | |
-| `gemini-cli` | Gemini CLI | ❓ | ❓ | ❓ | | |
-
-### Supported Operations — CLI
-
-| Operation | Description | All CLI Providers |
-|-----------|-------------|-------------------|
-| `spawn` | Start agent process in PTY | ✅ |
-| `input` | Send text/command to stdin | ✅ |
-| `output` | Read stdout/stderr stream | ✅ |
-| `resize` | Resize terminal (cols/rows) | ✅ |
-| `kill` | Terminate process | ✅ |
-
----
-
-## ACP Providers
-
-> Agent Client Protocol agents spawned as subprocesses, communicating via JSON-RPC over stdio.
-
-### OS Compatibility
-
-| Provider | Display Name | macOS | Windows | Linux | Tested Versions | Notes |
-|----------|-------------|-------|---------|-------|-----------------|-------|
-| `agentpool` | AgentPool | ❓ | ❓ | ❓ | | |
-| `amp` | Amp (Sourcegraph) | ❓ | ❓ | ❓ | | |
-| `auggie` | Auggie (Augment Code) | ❓ | ❓ | ❓ | | |
-| `autodev` | AutoDev | ❓ | ❓ | ❓ | | |
-| `blackbox-ai` | Blackbox AI | ❓ | ❓ | ❓ | | |
-| `claude-agent` | Claude Code (ACP) | ❓ | ❓ | ❓ | | |
-| `cline-acp` | Cline (ACP) | ❓ | ❓ | ❓ | | |
-| `codex-cli` | Codex CLI (ACP) | ❓ | ❓ | ❓ | | |
-| `corust-agent` | Corust Agent | ❓ | ❓ | ❓ | | |
-| `cursor-acp` | Cursor (ACP) | ❓ | ❓ | ❓ | | |
-| `deepagents` | Deep Agents | ❓ | ❓ | ❓ | | |
-| `docker-cagent` | Docker cagent | ❓ | ❓ | ❓ | | |
-| `factory-droid` | Factory AI Droids | ❓ | ❓ | ❓ | | |
-| `fast-agent` | fast-agent | ❓ | ❓ | ❓ | | |
-| `gemini-cli` | Gemini CLI (ACP) | ❓ | ❓ | ❓ | | |
-| `github-copilot` | GitHub Copilot | ❓ | ❓ | ❓ | | |
-| `goose` | Goose | ❓ | ❓ | ❓ | | |
-| `junie` | Junie (JetBrains) | ❓ | ❓ | ❓ | | |
-| `kilo` | Kilo Code | ❓ | ❓ | ❓ | | |
-| `kimi-cli` | Kimi Code CLI | ❓ | ❓ | ❓ | | |
-| `mistral-vibe` | Mistral Vibe CLI | ❓ | ❓ | ❓ | | |
-| `openclaw` | OpenClaw | ❓ | ❓ | ❓ | | Requires running Gateway |
-| `opencode` | OpenCode | ❓ | ❓ | ❓ | | |
-| `openhands` | OpenHands | ❓ | ❓ | ❓ | | |
-| `pi-acp` | pi | ❓ | ❓ | ❓ | | |
-| `qoder` | Qoder CLI | ❓ | ❓ | ❓ | | |
-| `qwen-code` | Qwen Code | ❓ | ❓ | ❓ | | |
-| `stakpak` | Stakpak | ❓ | ❓ | ❓ | | |
-| `vtcode` | VT Code | ❓ | ❓ | ❓ | | |
-
-### Supported Operations — ACP
-
-**Client → Agent (Editor sends to Agent)**
-
-| Method | Description | Required |
-|--------|-------------|----------|
-| `initialize` | Handshake, version negotiation, capability exchange | ✅ Required |
-| `authenticate` | Token/password auth if agent requires it | Optional |
-| `session/new` | Create a new conversation session | ✅ Required |
-| `session/prompt` | Send user message with context (files, images) | ✅ Required |
-| `session/load` | Resume an existing session | Optional |
-| `session/set_mode` | Switch agent operating mode | Optional |
-| `session/cancel` | Abort an in-progress prompt (notification) | ✅ Required |
-
-**Agent → Client (Agent requests from Editor)**
-
-| Method | Description | Required |
-|--------|-------------|----------|
-| `session/update` | Stream progress, messages, tool calls (notification) | ✅ Required |
-| `session/request_permission` | Ask user approval for an action | Optional |
-| `fs/read_text_file` | Read file content including unsaved edits | Optional |
-| `fs/write_text_file` | Write or create a file | Optional |
-| `terminal/create` | Start a shell command | Optional |
-| `terminal/output` | Provide command output | Optional |
-| `terminal/wait_for_exit` | Wait for command completion | Optional |
-| `terminal/kill` | Terminate a running command | Optional |
-| `terminal/release` | Clean up a terminal | Optional |
-
----
-
-## How to Test & Report
-
-### 1. Run the test
-
-```bash
-# Start the daemon
-adhdev daemon
-
-# Or standalone mode
-node packages/daemon-standalone/dist/index.js
-```
-
-### 2. Verify in the dashboard
-- Open `http://localhost:3847`
-- Check if the provider is detected
-- Test: read_chat, send_chat, screenshot (IDE/Extension)
-- Test: spawn, input, output (CLI/ACP)
-
-### 3. Submit your result
-Fork this repo, update the table above with your result, and submit a PR with:
-
-```
-Provider: <provider-id>
-OS: <macOS 15.x / Windows 11 / Ubuntu 24.04 / etc>
-Provider Version: <e.g. Cursor 0.48>
-Status: ✅ / ⚠️ / ❌
-Notes: <any issues encountered>
-```
-
-### PR Title Format
-```
-compat: <provider-id> <os> <status>
-```
-Example: `compat: cursor macOS ✅`
-
----
-
-## Version-Specific Notes
-
-<!--
-Add version-specific compatibility notes here as they are discovered.
-Example:
-
-### Cursor
-| Version | macOS | Windows | Linux | Notes |
-|---------|-------|---------|-------|-------|
-| 0.48.x | ✅ | ❓ | ❓ | |
-| 0.47.x | ⚠️ | ❓ | ❓ | CDP port changed |
--->
-
-_No version-specific notes yet. Submit a PR to add yours!_

package/providers/_builtin/CONTRIBUTING.md

@@ -1,200 +0,0 @@
-# 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
-
-```bash
-# IDE provider
-mkdir -p ide/my-ide/scripts/1.0
-touch ide/my-ide/provider.json
-
-# CLI agent
-mkdir -p cli/my-cli
-touch cli/my-cli/provider.json
-
-# ACP agent
-mkdir -p acp/my-agent
-touch acp/my-agent/provider.json
-
-# VS Code extension
-mkdir -p extension/my-ext/scripts/1.0
-touch extension/my-ext/provider.json
-```
-
-### 3. Provider Structure
-
-#### provider.json (required)
-
-```json
-{
-  "type": "my-ide",
-  "name": "My IDE",
-  "category": "ide",
-  "displayName": "My IDE",
-  "icon": "🔧",
-  "providerVersion": "1.0.0",
-  "versionCommand": "my-ide --version",
-  "compatibility": [
-    { "ideVersion": ">=1.0.0", "scriptDir": "scripts/1.0" }
-  ],
-  "defaultScriptDir": "scripts/1.0",
-  "cdpPorts": [9357, 9358],
-  "cli": "my-ide",
-  "processNames": { "darwin": "My IDE" },
-  "paths": { "darwin": ["/Applications/My IDE.app"] }
-}
-```
-
-#### scripts/1.0/scripts.js (IDE/Extension)
-
-```javascript
-module.exports = {
-  readChat() { return `(() => { /* DOM scraping */ })()`; },
-  sendMessage(text) { return `(() => { /* type + send */ })()`; },
-  listModels() { return `(() => { /* list available models */ })()`; },
-  setModel(model) { return `(() => { /* select model */ })()`; },
-  // ... more scripts
-};
-```
-
-#### Alternative: Individual Script Files
-
-Instead of one `scripts.js`, you can create individual files:
-
-```
-scripts/1.0/
-  read_chat.js          → exports single function, auto-mapped to readChat
-  send_message.js       → sendMessage
-  list_models.js        → listModels
-  set_model.js          → setModel
-```
-
-Both approaches work. `scripts.js` takes priority if both exist.
-
-> 📖 Full guide: [PROVIDER_GUIDE.md](https://github.com/vilmire/adhdev/blob/main/docs/PROVIDER_GUIDE.md)
-
-### 4. Version Compatibility
-
-The `compatibility` array maps IDE versions to script directories:
-
-```json
-"compatibility": [
-  { "ideVersion": ">=1.1.0", "scriptDir": "scripts/1.1" },
-  { "ideVersion": ">=1.0.0", "scriptDir": "scripts/1.0" }
-]
-```
-
-**Rules:**
-- Order matters: first match wins (most recent version first)
-- Version ranges use semver syntax: `>=1.0.0`, `<2.0.0`, `>=1.0.0 <1.5.0`
-- `defaultScriptDir`: used when IDE version is unknown or doesn't match any range
-- Each script directory should be self-contained (all scripts for that version)
-
-**When to create a new version directory:**
-- IDE DOM structure changed (selectors broke)
-- New UI elements to interact with
-- Major API changes
-
-**When NOT to create a new version:**
-- Minor visual changes that don't affect selectors
-- Backend-only updates
-- Same DOM structure with new features (extend existing scripts)
-
-### 5. Validate
-
-```bash
-# Syntax check
-node -c ide/my-ide/scripts/1.0/scripts.js
-
-# Schema validation (required fields, port conflicts, etc.)
-node validate.js ide/my-ide/provider.json
-
-# Validate all providers
-node validate.js
-```
-
-### 6. Local Testing
-
-```bash
-# Copy your provider to the user directory for instant loading
-mkdir -p ~/.adhdev/providers/ide/my-ide
-cp -r ide/my-ide/* ~/.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
-```
-
-### 7. 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
-```
-
-`registry.json` is auto-regenerated by GitHub Actions — **do not edit manually**.
-
----
-
-## PR Checklist
-
-- [ ] `node validate.js` passes with no errors
-- [ ] `type` does not conflict with existing providers
-- [ ] CDP ports do not overlap (for IDE providers)
-- [ ] `provider.json` has `providerVersion`, `compatibility`, `defaultScriptDir`
-- [ ] At least `readChat` + `sendMessage` scripts implemented
-- [ ] Tested via DevConsole (if ADHDev is available)
-- [ ] `registry.json` NOT manually edited
-
----
-
-## Reference Implementations
-
-| Category | Reference | Key Features |
-|----------|-----------|-------------|
-| **IDE** | `ide/antigravity/` | `compatibility` matrix, versioned scripts |
-| **IDE (webview)** | `ide/kiro/` | `webviewMatchText`, `webview*` scripts |
-| **CLI** | `cli/gemini-cli/` | `aliases`, spawn config |
-| **ACP** | `acp/gemini-cli/` | `auth`, `spawn`, `settings` |
-| **Extension** | `extension/cline/` | `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

@@ -1,119 +0,0 @@
-# ADHDev Providers
-
-> IDE, CLI, Extension, and ACP provider definitions for [ADHDev](https://github.com/vilmire/adhdev).
-
-## Structure
-
-```
-├── ide/            — IDE providers (Cursor, Antigravity, Windsurf, Kiro, etc.)
-├── cli/            — CLI agent providers (Gemini CLI, Claude Code, Codex CLI)
-├── extension/      — VS Code extension providers (Cline, Roo Code)
-├── acp/            — ACP agent providers (35 agents)
-├── registry.json   — Auto-generated provider index (used by daemon)
-├── validate.js     — Provider schema validator
-├── CONTRIBUTING.md — How to add a new provider
-└── COMPATIBILITY.md — OS/version compatibility matrix
-```
-
-## Provider Format
-
-Each provider consists of:
-
-```
-ide/my-ide/
-  provider.json              ← Metadata + version compatibility
-  scripts/
-    1.0/                     ← Scripts for IDE version 1.0.x
-      scripts.js             ← Main scripts entry point
-      set_model.js           ← Individual script files
-      set_mode.js
-    0.9/                     ← Scripts for IDE version 0.9.x
-      scripts.js
-```
-
-### provider.json
-
-```json
-{
-  "type": "my-ide",
-  "name": "My IDE",
-  "category": "ide",
-  "providerVersion": "1.0.0",
-  "versionCommand": "my-ide --version",
-  "compatibility": [
-    { "ideVersion": ">=1.0.0", "scriptDir": "scripts/1.0" },
-    { "ideVersion": ">=0.9.0", "scriptDir": "scripts/0.9" }
-  ],
-  "defaultScriptDir": "scripts/1.0",
-  "cdpPorts": [9357, 9358],
-  "processNames": { "darwin": "My IDE" }
-}
-```
-
-### Version Resolution
-
-When the daemon starts:
-1. Detects installed IDE version (`versionCommand`)
-2. Matches against `compatibility` array (first match wins)
-3. Loads scripts from the matched `scriptDir`
-4. If no match → uses `defaultScriptDir` + shows warning
-
-## Adding a New Provider
-
-1. Create `provider.json` in the appropriate category
-2. Create version-specific script directories
-3. Validate: `node validate.js ide/my-ide/provider.json`
-4. Submit a PR
-
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full workflow.
-
-## 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**
-
-### registry.json
-
-Auto-generated index of all providers. Contains:
-- Provider type, name, category
-- `providerVersion` (for incremental update checks)
-- `compatibility` matrix (which IDE versions → which scripts)
-
-Updated automatically by GitHub Actions on every push.
-
-## Supporting a New IDE Version
-
-When an IDE releases a new version with DOM changes:
-
-1. Create a new script directory:
-   ```bash
-   mkdir -p ide/my-ide/scripts/1.1
-   ```
-
-2. Copy from the previous version and modify:
-   ```bash
-   cp -r ide/my-ide/scripts/1.0/* ide/my-ide/scripts/1.1/
-   # Edit scripts to match new DOM structure
-   ```
-
-3. Update `provider.json`:
-   ```json
-   "compatibility": [
-     { "ideVersion": ">=1.1.0", "scriptDir": "scripts/1.1" },
-     { "ideVersion": ">=1.0.0", "scriptDir": "scripts/1.0" }
-   ],
-   "defaultScriptDir": "scripts/1.1"
-   ```
-
-4. Submit a PR. `registry.json` is auto-regenerated.
-
-## License
-
-MIT