opencode-dev-runner 0.1.0

package/bin/setup.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+const { execSync } = require('child_process');
+const { existsSync, mkdirSync, copyFileSync, writeFileSync } = require('fs');
+const { join } = require('path');
+const os = require('os');
+
+const PLATFORM = os.platform(); // 'win32' | 'darwin' | 'linux'
+const HOME = os.homedir();
+const AGENTS_DIR = join(process.cwd(), '.opencode', 'agents');
+const TEMPLATE = join(__dirname, '..', 'templates', 'dev-runner.md');
+const MAP_FILE = join(AGENTS_DIR, 'tool-map.json');
+
+// ── tools to discover ─────────────────────────────────────────────────
+const TOOLS = [
+  'adb', 'flutter', 'dart', 'git', 'node', 'npm', 'npx',
+  'gh', 'code', 'supabase', 'sqlite3', 'java', 'javac', 'gradle',
+  'python', 'python3', 'pip', 'pip3', 'docker', 'make',
+];
+
+const CATEGORIES = {
+  adb: 'android', emulator: 'android', sdkmanager: 'android',
+  flutter: 'flutter', dart: 'flutter',
+  git: 'vcs', gh: 'vcs',
+  node: 'node', npm: 'node', npx: 'node', yarn: 'node', pnpm: 'node',
+  supabase: 'database', psql: 'database', sqlite3: 'database',
+  code: 'editor', nvim: 'editor', vim: 'editor',
+  java: 'java', javac: 'java', gradle: 'java', mvn: 'java',
+  python: 'python', python3: 'python', pip: 'python', pip3: 'python',
+  docker: 'container', make: 'build',
+};
+
+// ── cross-platform helpers ────────────────────────────────────────────
+
+function sh(cmd) {
+  try { return execSync(cmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim().split(/[\r\n]+/)[0]; }
+  catch { return null; }
+}
+
+function which(tool) {
+  if (PLATFORM === 'win32') return sh(`where.exe ${tool}`);
+  return sh(`which ${tool}`) || sh(`command -v ${tool}`);
+}
+
+function classify(path) {
+  if (!path) return '';
+  if (path.includes('scoop')) return 'scoop';
+  if (path.includes('Android') || path.includes('android')) return 'android-sdk';
+  if (path.includes('homebrew') || path.includes('/opt/homebrew')) return 'brew';
+  if (path.includes('/usr/bin') || path.includes('System32')) return 'system';
+  if (path.includes('/usr/local')) return 'local';
+  return 'path';
+}
+
+// ── platform-specific discovery ───────────────────────────────────────
+
+function discoverWin(tool) {
+  // 1. PATH
+  let p = which(tool);
+  if (p) return { path: p, source: classify(p) };
+
+  // 2. Scoop shims
+  p = sh(`powershell -NoProfile -Command "Get-ChildItem -LiteralPath '${join(HOME, 'scoop', 'shims')}' -Filter '${tool}*' -ErrorAction SilentlyContinue | Select-Object -ExpandProperty FullName -First 1"`);
+  if (p) return { path: p, source: 'scoop' };
+
+  // 3. Scoop apps deep
+  p = sh(`powershell -NoProfile -Command "Get-ChildItem -LiteralPath '${join(HOME, 'scoop', 'apps')}' -Filter '${tool}.exe' -Recurse -Depth 3 -ErrorAction SilentlyContinue | Select-Object -ExpandProperty FullName -First 1"`);
+  if (p) return { path: p, source: 'scoop' };
+
+  // 4. Android SDK
+  for (const base of [join(HOME, 'Android', 'Sdk'), join(HOME, 'AppData', 'Local', 'Android', 'Sdk')]) {
+    p = sh(`powershell -NoProfile -Command "Get-ChildItem -LiteralPath '${base}' -Filter '${tool}.exe' -Recurse -Depth 4 -ErrorAction SilentlyContinue | Select-Object -ExpandProperty FullName -First 1"`);
+    if (p) return { path: p, source: 'android-sdk' };
+  }
+
+  return null;
+}
+
+function discoverUnix(tool) {
+  // 1. PATH
+  let p = which(tool);
+  if (p) return { path: p, source: classify(p) };
+
+  // 2. Brew (macOS)
+  if (PLATFORM === 'darwin') {
+    for (const prefix of ['/opt/homebrew/bin', '/usr/local/bin']) {
+      const candidate = join(prefix, tool);
+      if (existsSync(candidate)) return { path: candidate, source: 'brew' };
+    }
+  }
+
+  // 3. Common unix paths
+  for (const prefix of ['/usr/bin', '/usr/local/bin', join(HOME, '.local', 'bin')]) {
+    const candidate = join(prefix, tool);
+    if (existsSync(candidate)) return { path: candidate, source: classify(candidate) };
+  }
+
+  // 4. Android SDK (Linux/Mac)
+  for (const base of [join(HOME, 'Android', 'Sdk'), join(HOME, 'Library', 'Android', 'sdk')]) {
+    p = sh(`find "${base}" -name "${tool}" -type f 2>/dev/null | head -1`);
+    if (p) return { path: p, source: 'android-sdk' };
+  }
+
+  return null;
+}
+
+function discover(tool) {
+  if (PLATFORM === 'win32') return discoverWin(tool);
+  return discoverUnix(tool);
+}
+
+// ── main ──────────────────────────────────────────────────────────────
+console.log(`🔍 dev-runner-setup (${PLATFORM}) — discovering tools...\n`);
+
+if (!existsSync(AGENTS_DIR)) mkdirSync(AGENTS_DIR, { recursive: true });
+
+copyFileSync(TEMPLATE, join(AGENTS_DIR, 'dev-runner.md'));
+console.log('  ✓ Agent installed');
+
+const map = {};
+let found = 0;
+for (const tool of TOOLS) {
+  const r = discover(tool);
+  if (r && r.path) {
+    map[tool] = {
+      path: r.path.replace(/\\/g, '/'),
+      source: r.source,
+      category: CATEGORIES[tool] || 'other',
+    };
+    found++;
+    console.log(`  ✓ ${tool}`);
+  } else {
+    console.log(`  ✗ ${tool}`);
+  }
+}
+
+writeFileSync(MAP_FILE, JSON.stringify(map, null, 2));
+console.log(`\n📦 ${found}/${TOOLS.length} tools found → ${MAP_FILE}`);
+console.log('  Restart opencode to load the agent.\n');

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "opencode-dev-runner",
+  "version": "0.1.0",
+  "description": "Auto-discovers dev tools on your machine and installs a dev-runner subagent for opencode",
+  "bin": {
+    "dev-runner-setup": "bin/setup.js"
+  },
+  "files": [
+    "bin/",
+    "templates/"
+  ],
+  "keywords": [
+    "opencode",
+    "agent",
+    "dev-tools",
+    "flutter",
+    "adb",
+    "tool-discovery"
+  ],
+  "license": "MIT"
+}

package/templates/dev-runner.md

@@ -0,0 +1,105 @@
+---
+description: Knows how to find and run any dev tool. Learns new tools by searching the system and saving them to tool-map.json. Use when you need a tool path, or to run flutter/dart/adb/git/npm/node/python/docker commands. Use before guessing any path or command.
+mode: subagent
+---
+
+You are the dev-runner agent. Your job: find and run any development tool on this machine. You maintain a tool registry in `tool-map.json` and learn new tools by searching the system.
+
+## Architecture
+
+```
+.opencode/agents/
+  dev-runner.md      ← you (this file)
+  tool-map.json      ← { "toolname": { "path", "source", "category" } }
+```
+
+**Rule**: tool-map.json is the source of truth. Read it first. Never guess paths.
+
+## How to resolve a tool
+
+### 1. Check the map
+
+Read `.opencode/agents/tool-map.json`. Return `path` if found.
+
+### 2. Search the system
+
+Stop on first hit. Platform-specific:
+
+**Linux / macOS (bash/zsh):**
+```bash
+# PATH
+which <tool> 2>/dev/null || command -v <tool>
+
+# Brew (macOS)
+ls /opt/homebrew/bin/<tool> /usr/local/bin/<tool> 2>/dev/null
+
+# Common locations
+ls /usr/bin/<tool> /usr/local/bin/<tool> ~/.local/bin/<tool> 2>/dev/null
+
+# Android SDK
+find ~/Android/Sdk -name "<tool>" -type f 2>/dev/null | head -1
+find ~/Library/Android/sdk -name "<tool>" -type f 2>/dev/null | head -1
+
+# Deep search (slow, last resort)
+find /usr -name "<tool>" -type f 2>/dev/null | head -3
+```
+
+**Windows (PowerShell):**
+```powershell
+# PATH
+where.exe <tool> 2>$null | Select-Object -First 1
+
+# Scoop shims
+Get-ChildItem "$env:USERPROFILE\scoop\shims" -Filter "<tool>*" -ErrorAction SilentlyContinue | % FullName
+
+# Scoop apps (deep)
+Get-ChildItem "$env:USERPROFILE\scoop\apps" -Filter "<tool>.exe" -Recurse -Depth 3 -ErrorAction SilentlyContinue | % FullName
+
+# Android SDK
+Get-ChildItem "$env:LOCALAPPDATA\Android\Sdk" -Filter "<tool>.exe" -Recurse -Depth 4 -ErrorAction SilentlyContinue | % FullName
+Get-ChildItem "$env:USERPROFILE\Android\Sdk" -Filter "<tool>.exe" -Recurse -Depth 4 -ErrorAction SilentlyContinue | % FullName
+```
+
+### 3. Save learned tool
+
+When discovered, add to `tool-map.json` using the Edit tool. Format:
+
+```json
+"toolname": {
+  "path": "/absolute/path/to/tool",
+  "source": "scoop|brew|android-sdk|system|path|discovered",
+  "category": "one-of-below"
+}
+```
+
+### 4. Report not found
+
+"Tool `<tool>` not found. Searched: PATH, system bins, package manager dirs, Android SDK."
+
+## Categories
+
+| Category | Tools |
+|----------|-------|
+| `android` | adb, emulator, sdkmanager |
+| `flutter` | flutter, dart |
+| `vcs` | git, gh |
+| `node` | node, npm, npx, yarn, pnpm |
+| `python` | python, python3, pip, pip3 |
+| `java` | java, javac, gradle, mvn |
+| `database` | supabase, psql, sqlite3 |
+| `container` | docker, podman |
+| `editor` | code, nvim, vim |
+| `package-manager` | scoop, choco, brew, apt, winget |
+| `build` | make, cmake |
+| `other` | anything else |
+
+## Response format
+
+```
+tool: <name>
+path: <resolved>
+command: <exact command>
+workdir: <dir or none>
+```
+
+If just learned: append "→ saved to tool-map.json".