opencode-bioresearcher 1.11.1 → 1.12.0

package/skills/bioresearcher-onboard/scripts/bootstrap.sh

@@ -0,0 +1,127 @@
+#!/usr/bin/env bash
+# Stage 0 Zero-Dependency Bootstrap for bioresearcher-onboard.
+# Checks for existing Node >= 22.13; if missing, downloads pinned portable
+# Node.js LTS into .bioresearcher-runtime/node, verifies SHA256, and hands off
+# execution to onboard.mjs.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+RUNTIME_ROOT="${BIORESEARCHER_RUNTIME_DIR:-$PWD/.bioresearcher-runtime}"
+NODE_DIR="$RUNTIME_ROOT/node"
+NODE_BIN="$NODE_DIR/bin/node"
+
+NODE_REQ_MAJ=22
+NODE_REQ_MIN=13
+NODE_VER="v22.14.0"
+
+# 1. Probe if host already satisfies Node >= 22.13
+if command -v node >/dev/null 2>&1; then
+  if node -e "var v=process.versions.node.split('.');process.exit((v[0]>$NODE_REQ_MAJ||(v[0]==$NODE_REQ_MAJ&&v[1]>=$NODE_REQ_MIN))?0:1)" 2>/dev/null; then
+    echo "[bioresearcher-onboard] Found host $(node -v) at $(command -v node)"
+    exec node "$SCRIPT_DIR/onboard.mjs" "$@"
+  fi
+fi
+
+# If already vendored in working directory, reuse directly
+if [ -x "$NODE_BIN" ]; then
+  export PATH="$NODE_DIR/bin:$PATH"
+  exec "$NODE_BIN" "$SCRIPT_DIR/onboard.mjs" "$@"
+fi
+
+echo "[bioresearcher-onboard] Host Node >= 22.13 not found. Bootstrapping portable Node.js $NODE_VER into .bioresearcher-runtime/..."
+
+# 2. OS and Architecture Detection
+OS_RAW="$(uname -s)"
+case "$OS_RAW" in
+  Linux*)  OS="linux" ;;
+  Darwin*) OS="darwin" ;;
+  *) echo "Error: Unsupported operating system $OS_RAW. Windows users should run bootstrap.ps1." >&2; exit 1 ;;
+esac
+
+# Linux C library gate
+if [ "$OS" = "linux" ]; then
+  if ldd /bin/ls 2>&1 | grep -qi "musl"; then
+    echo "Error: Alpine/musl Linux detected. Official Node prebuilts require glibc." >&2
+    echo "Please install Node >= 22.13 via your system package manager (e.g. apk add nodejs)." >&2
+    exit 1
+  fi
+fi
+
+ARCH_RAW="$(uname -m)"
+case "$ARCH_RAW" in
+  x86_64|amd64) ARCH="x64" ;;
+  arm64|aarch64) ARCH="arm64" ;;
+  *) echo "Error: Unsupported CPU architecture $ARCH_RAW." >&2; exit 1 ;;
+esac
+
+# macOS Rosetta detection: probe true hardware arch
+if [ "$OS" = "darwin" ]; then
+  if [ "$(sysctl -in sysctl.proc_translated 2>/dev/null || echo 0)" = "1" ]; then
+    ARCH="arm64"
+  fi
+fi
+
+# 3. Mirror Selection Probe (1.2s timeout)
+if curl -s -I --connect-timeout 1.0 --max-time 1.2 "https://nodejs.org/dist/" >/dev/null 2>&1; then
+  MIRROR_BASE="https://nodejs.org/dist/${NODE_VER}"
+  NPM_REGISTRY="https://registry.npmjs.org"
+else
+  echo "[bioresearcher-onboard] nodejs.org unreachable or timed out; using npmmirror.com fast mirror"
+  MIRROR_BASE="https://npmmirror.com/mirrors/node/${NODE_VER}"
+  NPM_REGISTRY="https://registry.npmmirror.com"
+fi
+
+FILE="node-${NODE_VER}-${OS}-${ARCH}.tar.gz"
+DOWNLOAD_URL="${MIRROR_BASE}/${FILE}"
+
+# Pinned SHA256 checksums from official Node.js SHASUMS256.txt
+case "${OS}-${ARCH}" in
+  linux-x64)    EXPECTED_SHA="9d942932535988091034dc94cc5f42b6dc8784d6366df3a36c4c9ccb3996f0c2" ;;
+  linux-arm64)  EXPECTED_SHA="8cf30ff7250f9463b53c18f89c6c606dfda70378215b2c905d0a9a8b08bd45e0" ;;
+  darwin-x64)   EXPECTED_SHA="6698587713ab565a94a360e091df9f6d91c8fadda6d00f0cf6526e9b40bed250" ;;
+  darwin-arm64) EXPECTED_SHA="e9404633bc02a5162c5c573b1e2490f5fb44648345d64a958b17e325729a5e42" ;;
+  *) echo "Error: Missing checksum for target ${OS}-${ARCH}." >&2; exit 1 ;;
+esac
+
+mkdir -p "$RUNTIME_ROOT"
+TMP_ARCHIVE="$RUNTIME_ROOT/node.tar.gz"
+
+echo "[bioresearcher-onboard] Downloading $FILE..."
+curl -f -s -L --retry 2 -o "$TMP_ARCHIVE" "$DOWNLOAD_URL"
+
+# 4. Checksum verification
+if command -v sha256sum >/dev/null 2>&1; then
+  ACTUAL_SHA="$(sha256sum "$TMP_ARCHIVE" | awk '{print $1}')"
+elif command -v shasum >/dev/null 2>&1; then
+  ACTUAL_SHA="$(shasum -a 256 "$TMP_ARCHIVE" | awk '{print $1}')"
+else
+  ACTUAL_SHA=""
+fi
+
+if [ -n "$ACTUAL_SHA" ] && [ "$ACTUAL_SHA" != "$EXPECTED_SHA" ]; then
+  echo "Error: SHA256 checksum verification failed for $FILE." >&2
+  echo "Expected: $EXPECTED_SHA" >&2
+  echo "Actual:   $ACTUAL_SHA" >&2
+  rm -f "$TMP_ARCHIVE"
+  exit 1
+fi
+
+# 5. Extract and prune
+mkdir -p "$NODE_DIR"
+tar -xzf "$TMP_ARCHIVE" -C "$NODE_DIR" --strip-components=1
+rm -f "$TMP_ARCHIVE"
+
+# Remove non-runtime artifacts (saves ~49 MB)
+rm -rf "$NODE_DIR/include" "$NODE_DIR/share" "$NODE_DIR"/*.md "$NODE_DIR"/LICENSE
+
+# macOS Gatekeeper quarantine removal
+if [ "$OS" = "darwin" ]; then
+  xattr -dr com.apple.quarantine "$NODE_DIR" 2>/dev/null || true
+fi
+
+echo "[bioresearcher-onboard] Portable Node.js ready: $("$NODE_BIN" -v)"
+
+# 6. Hand off to Stage 1
+export PATH="$NODE_DIR/bin:$PATH"
+export NPM_CONFIG_REGISTRY="$NPM_REGISTRY"
+exec "$NODE_BIN" "$SCRIPT_DIR/onboard.mjs" "$@"

package/skills/bioresearcher-onboard/scripts/onboard.mjs

@@ -0,0 +1,512 @@
+#!/usr/bin/env node
+/**
+ * Stage 1 Onboarding Engine for bioresearcher-onboard.
+ * Installs biomcp@1.6.0 into .bioresearcher-runtime/node_modules, configures
+ * optional features via .biomcp.json, non-destructively merges harness
+ * configuration files, and runs pre-flight doctor verification.
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { spawnSync } from "node:child_process";
+
+const CWD = process.cwd();
+const RUNTIME_ROOT = process.env.BIORESEARCHER_RUNTIME_DIR || path.resolve(CWD, ".bioresearcher-runtime");
+const CACHE_DIR = path.join(RUNTIME_ROOT, "npm-cache");
+const IS_WIN = process.platform === "win32";
+
+// 1. Resolve Node and npm executables
+let nodeBin = process.execPath;
+const vendoredNode = IS_WIN
+  ? path.join(RUNTIME_ROOT, "node", "node.exe")
+  : path.join(RUNTIME_ROOT, "node", "bin", "node");
+
+if (fs.existsSync(vendoredNode)) {
+  nodeBin = vendoredNode;
+}
+
+let npmBin = IS_WIN
+  ? path.join(RUNTIME_ROOT, "node", "npm.cmd")
+  : path.join(RUNTIME_ROOT, "node", "bin", "npm");
+
+if (!fs.existsSync(npmBin)) {
+  npmBin = "npm";
+}
+
+// 2. Parse CLI options
+const args = process.argv.slice(2);
+const getArgVal = (prefix) => {
+  const match = args.find((a) => a.startsWith(prefix));
+  return match ? match.slice(match.indexOf("=") + 1) : null;
+};
+
+const options = {
+  withR: args.includes("--with-r") || process.env.ONBOARD_R === "1",
+  withMysql: args.includes("--with-mysql") || process.env.ONBOARD_MYSQL === "1",
+  withBiowasm: args.includes("--with-biowasm") || process.env.ONBOARD_BIOWASM === "1",
+  sqlitePath: getArgVal("--sqlite-path=") || process.env.ONBOARD_SQLITE_PATH || null,
+  client: getArgVal("--client=") || null,
+  registry: getArgVal("--registry=") || process.env.NPM_CONFIG_REGISTRY || "https://registry.npmjs.org",
+  nonInteractive: args.includes("--non-interactive") || !process.stdin.isTTY,
+};
+
+console.log("[bioresearcher-onboard] Initializing project-local BioMCP runtime...");
+
+// 3. Prepare isolated .bioresearcher-runtime directory
+fs.mkdirSync(RUNTIME_ROOT, { recursive: true });
+fs.mkdirSync(CACHE_DIR, { recursive: true });
+
+const runtimePkgJson = path.join(RUNTIME_ROOT, "package.json");
+if (!fs.existsSync(runtimePkgJson)) {
+  fs.writeFileSync(runtimePkgJson, JSON.stringify({ name: "bioresearcher-runtime", private: true }, null, 2));
+}
+
+// 4. Determine packages to install
+const packagesToInstall = ["biomcp@1.6.0"];
+if (options.withR) packagesToInstall.push("webr@0.6");
+if (options.withMysql) packagesToInstall.push("mysql2@3");
+
+console.log(`[bioresearcher-onboard] Installing dependencies (${packagesToInstall.join(", ")}) via ${options.registry}...`);
+
+const npmEnv = {
+  ...process.env,
+  npm_config_cache: CACHE_DIR,
+  npm_config_userconfig: IS_WIN ? "NUL" : "/dev/null",
+  npm_config_audit: "false",
+  npm_config_fund: "false",
+  npm_config_update_notifier: "false",
+  npm_config_registry: options.registry,
+};
+
+const installArgs = ["install", "--prefix", RUNTIME_ROOT, "--ignore-scripts", ...packagesToInstall];
+const installRes = spawnSync(npmBin, installArgs, {
+  env: npmEnv,
+  stdio: "inherit",
+  cwd: RUNTIME_ROOT,
+});
+
+if (installRes.status !== 0) {
+  console.error("[bioresearcher-onboard] Error: Failed to install packages into .bioresearcher-runtime");
+  process.exit(installRes.status || 1);
+}
+
+// 5. Verify bundle path
+const bundlePath = path.join(RUNTIME_ROOT, "node_modules", "biomcp", "dist", "bundle.js");
+if (!fs.existsSync(bundlePath)) {
+  console.error(`[bioresearcher-onboard] Error: BioMCP bundle not found at ${bundlePath}`);
+  process.exit(1);
+}
+
+// 6. Generate .biomcp.json if optional features are requested
+const featuresConfig = {};
+if (options.withR) {
+  featuresConfig.analysis_r = { enabled: true };
+}
+if (options.withBiowasm) {
+  featuresConfig.analysis_biowasm = { enabled: true };
+}
+if (options.sqlitePath) {
+  featuresConfig.database = {
+    enabled: true,
+    type: "sqlite",
+    sqlite_path: options.sqlitePath,
+  };
+} else if (options.withMysql) {
+  featuresConfig.database = {
+    enabled: true,
+    type: "mysql",
+  };
+}
+
+const biomcpJsonPath = path.resolve(CWD, ".biomcp.json");
+if (Object.keys(featuresConfig).length > 0) {
+  let existing = {};
+  if (fs.existsSync(biomcpJsonPath)) {
+    try {
+      existing = JSON.parse(fs.readFileSync(biomcpJsonPath, "utf8"));
+    } catch {}
+  }
+  existing.features = { ...existing.features, ...featuresConfig };
+
+  // Write atomically with 0o600 permissions
+  const tmpPath = `${biomcpJsonPath}.${Date.now()}.tmp`;
+  fs.writeFileSync(tmpPath, JSON.stringify(existing, null, 2), { mode: 0o600 });
+  fs.renameSync(tmpPath, biomcpJsonPath);
+  console.log(`[bioresearcher-onboard] Configured optional features in .biomcp.json`);
+}
+
+// 7. Non-destructive deep-merge of client harness configuration files
+// Normalize Windows paths to POSIX forward slashes for valid JSON strings
+const normalizedNodePath = IS_WIN ? nodeBin.replace(/\\/g, "/") : nodeBin;
+const normalizedBundlePath = IS_WIN ? bundlePath.replace(/\\/g, "/") : bundlePath;
+
+function stripJsonc(content) {
+  let result = "";
+  let inString = false;
+  let inSingleComment = false;
+  let inMultiComment = false;
+  let isEscaped = false;
+
+  for (let i = 0; i < content.length; i++) {
+    const ch = content[i];
+    const next = content[i + 1];
+
+    if (inSingleComment) {
+      if (ch === "\n") {
+        inSingleComment = false;
+        result += ch;
+      }
+      continue;
+    }
+
+    if (inMultiComment) {
+      if (ch === "*" && next === "/") {
+        inMultiComment = false;
+        i++;
+      }
+      continue;
+    }
+
+    if (inString) {
+      result += ch;
+      if (isEscaped) {
+        isEscaped = false;
+      } else if (ch === "\\") {
+        isEscaped = true;
+      } else if (ch === "\"") {
+        inString = false;
+      }
+      continue;
+    }
+
+    if (ch === "\"") {
+      inString = true;
+      isEscaped = false;
+      result += ch;
+      continue;
+    }
+
+    if (ch === "/" && next === "/") {
+      inSingleComment = true;
+      i++;
+      continue;
+    }
+
+    if (ch === "/" && next === "*") {
+      inMultiComment = true;
+      i++;
+      continue;
+    }
+
+    if (ch === ",") {
+      let j = i + 1;
+      let isTrailing = false;
+      let tempInSingle = false;
+      let tempInMulti = false;
+      while (j < content.length) {
+        const cj = content[j];
+        const nj = content[j + 1];
+        if (tempInSingle) {
+          if (cj === "\n") tempInSingle = false;
+          j++;
+          continue;
+        }
+        if (tempInMulti) {
+          if (cj === "*" && nj === "/") {
+            tempInMulti = false;
+            j += 2;
+            continue;
+          }
+          j++;
+          continue;
+        }
+        if (cj === "/" && nj === "/") {
+          tempInSingle = true;
+          j += 2;
+          continue;
+        }
+        if (cj === "/" && nj === "*") {
+          tempInMulti = true;
+          j += 2;
+          continue;
+        }
+        if (/\s/.test(cj)) {
+          j++;
+          continue;
+        }
+        if (cj === "}" || cj === "]") {
+          isTrailing = true;
+        }
+        break;
+      }
+      if (isTrailing) {
+        continue;
+      }
+    }
+
+    result += ch;
+  }
+
+  return result.trim();
+}
+
+function safeMergeJson(filePath, updater) {
+  let data = {};
+  let backedUp = false;
+  if (fs.existsSync(filePath)) {
+    const raw = fs.readFileSync(filePath, "utf8");
+    if (raw.trim().length > 0) {
+      try {
+        data = JSON.parse(stripJsonc(raw));
+      } catch (e) {
+        console.error(`[bioresearcher-onboard] Error: Failed to parse existing JSONC at ${filePath}: ${e.message}`);
+        console.error(`[bioresearcher-onboard] Aborting modification to prevent data loss. Existing file was not modified.`);
+        process.exit(1);
+      }
+    }
+    fs.copyFileSync(filePath, `${filePath}.bak`);
+    backedUp = true;
+  }
+
+  if (typeof data !== "object" || data === null || Array.isArray(data)) {
+    data = {};
+  }
+
+  const updated = updater(data);
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  const tmp = `${filePath}.${Date.now()}.tmp`;
+  fs.writeFileSync(tmp, JSON.stringify(updated, null, 2));
+  fs.renameSync(tmp, filePath);
+  if (backedUp) {
+    console.log(`[bioresearcher-onboard] Updated ${path.basename(filePath)} (backup saved to ${path.basename(filePath)}.bak)`);
+  } else {
+    console.log(`[bioresearcher-onboard] Created ${path.basename(filePath)}`);
+  }
+}
+
+// Probe harness configs upfront to avoid generating unintended files
+const opencodePath = path.resolve(CWD, "opencode.json");
+const claudePath = path.resolve(CWD, ".mcp.json");
+const cursorDir = path.resolve(CWD, ".cursor");
+const cursorPath = path.join(cursorDir, "mcp.json");
+
+const zcodeDir = path.resolve(CWD, ".zcode");
+const zcodePath = path.join(zcodeDir, "config.json");
+
+const piDir = path.resolve(CWD, ".pi");
+const piPath = path.join(piDir, "mcp.json");
+
+const codebuddyDir = path.resolve(CWD, ".codebuddy");
+const codebuddySettingsPath = path.join(codebuddyDir, "settings.json");
+const codebuddyMdPath = path.resolve(CWD, "CODEBUDDY.md");
+
+const workbuddyDir = path.resolve(CWD, ".workbuddy");
+const workbuddyPath = path.join(workbuddyDir, "mcp.json");
+const workbuddyMdPath = path.resolve(CWD, "WORKBUDDY.md");
+
+const opencodeExists = fs.existsSync(opencodePath);
+const claudeExists = fs.existsSync(claudePath);
+const cursorExists = fs.existsSync(cursorDir) || fs.existsSync(cursorPath);
+const zcodeExists = fs.existsSync(zcodeDir) || fs.existsSync(zcodePath) || Boolean(process.env.ZCODE_WORKSPACE);
+const piExists = fs.existsSync(piDir) || fs.existsSync(piPath) || Boolean(process.env.PI_CODING_AGENT_DIR);
+const codebuddyExists = fs.existsSync(codebuddyDir) || fs.existsSync(codebuddyMdPath) || Boolean(process.env.CODEBUDDY_CLI);
+const workbuddyExists = fs.existsSync(workbuddyDir) || fs.existsSync(workbuddyPath) || fs.existsSync(workbuddyMdPath);
+
+// Normalize client argument with aliases
+const clientArg = (options.client || "").toLowerCase().trim();
+const clientAliases = {
+  "claude": "claude-code",
+  "code-buddy": "codebuddy",
+  "work-buddy": "workbuddy",
+  "pi-agent": "pi",
+};
+const resolvedClient = clientAliases[clientArg] || clientArg;
+
+const validClients = ["opencode", "claude-code", "cursor", "zcode", "pi", "codebuddy", "workbuddy"];
+if (resolvedClient && !validClients.includes(resolvedClient)) {
+  console.error(`[bioresearcher-onboard] Error: Unknown client "${options.client}". Valid options: ${validClients.join(", ")}`);
+  process.exit(1);
+}
+
+let targetOpencode  = resolvedClient === "opencode"    || (!resolvedClient && opencodeExists);
+let targetClaude    = resolvedClient === "claude-code" || (!resolvedClient && claudeExists && !codebuddyExists);
+let targetCursor    = resolvedClient === "cursor"     || (!resolvedClient && cursorExists);
+let targetZcode     = resolvedClient === "zcode"      || (!resolvedClient && zcodeExists);
+let targetPi        = resolvedClient === "pi"         || (!resolvedClient && piExists);
+let targetCodebuddy = resolvedClient === "codebuddy"  || (!resolvedClient && codebuddyExists);
+let targetWorkbuddy = resolvedClient === "workbuddy"  || (!resolvedClient && workbuddyExists);
+
+// Default to opencode.json if no client specified and no config file exists yet
+const anyDetected = opencodeExists || claudeExists || cursorExists || zcodeExists || piExists || codebuddyExists || workbuddyExists;
+if (!resolvedClient && !anyDetected) {
+  targetOpencode = true;
+}
+
+// OpenCode: opencode.json (canonical v2 shape mcp.servers.<name>)
+if (targetOpencode) {
+  const npxCmd = IS_WIN ? "npx.cmd" : "npx";
+  safeMergeJson(opencodePath, (data) => {
+    data.$schema = data.$schema || "https://opencode.ai/config.json";
+    data.mcp = data.mcp || {};
+    data.mcp.servers = data.mcp.servers || {};
+    // Migrate legacy flat entry (pre-v2 onboard / old plugin config hook):
+    // preserve environment, convert flat timeout N to the triple form.
+    const legacy = data.mcp.biomcp;
+    if (data.mcp.servers.biomcp === undefined && legacy && typeof legacy === "object" && !Array.isArray(legacy)) {
+      const flatTimeout = typeof legacy.timeout === "number" ? legacy.timeout : 120000;
+      data.mcp.servers.biomcp = {
+        type: "local",
+        command: [npxCmd, "-y", "-p", "biomcp@1.6.0", "biomcp"],
+        environment: legacy.environment || {},
+        timeout: { startup: flatTimeout, catalog: flatTimeout, execution: flatTimeout },
+      };
+    } else if (data.mcp.servers.biomcp === undefined) {
+      data.mcp.servers.biomcp = {
+        type: "local",
+        command: [npxCmd, "-y", "-p", "biomcp@1.6.0", "biomcp"],
+        environment: {},
+        timeout: { startup: 120000, catalog: 120000, execution: 120000 },
+      };
+    }
+    // An existing canonical entry is left untouched; drop the migrated flat key.
+    if (legacy !== undefined) delete data.mcp.biomcp;
+    if (Object.keys(data.mcp).length === 0) delete data.mcp;
+    return data;
+  });
+}
+
+// Claude Code: .mcp.json
+if (targetClaude) {
+  safeMergeJson(claudePath, (data) => {
+    data.mcpServers = data.mcpServers || {};
+    data.mcpServers.biomcp = {
+      type: "stdio",
+      command: normalizedNodePath,
+      args: [normalizedBundlePath],
+      env: data.mcpServers.biomcp?.env || {},
+    };
+    return data;
+  });
+}
+
+// Cursor: .cursor/mcp.json
+if (targetCursor) {
+  safeMergeJson(cursorPath, (data) => {
+    data.mcpServers = data.mcpServers || {};
+    data.mcpServers.biomcp = {
+      command: normalizedNodePath,
+      args: [normalizedBundlePath],
+      env: data.mcpServers.biomcp?.env || {},
+    };
+    return data;
+  });
+}
+
+// ZCode: .zcode/config.json
+if (targetZcode) {
+  safeMergeJson(zcodePath, (data) => {
+    data.mcp = data.mcp || {};
+    data.mcp.servers = data.mcp.servers || {};
+    data.mcp.servers.biomcp = {
+      command: normalizedNodePath,
+      args: [normalizedBundlePath],
+      env: data.mcp.servers.biomcp?.env || {},
+      enable: true,
+    };
+    return data;
+  });
+}
+
+// Pi Coding Agent: .pi/mcp.json
+if (targetPi) {
+  safeMergeJson(piPath, (data) => {
+    data.mcpServers = data.mcpServers || {};
+    data.mcpServers.biomcp = {
+      command: normalizedNodePath,
+      args: [normalizedBundlePath],
+      env: data.mcpServers.biomcp?.env || {},
+    };
+    return data;
+  });
+}
+
+// CodeBuddy: .mcp.json + pre-approval in .codebuddy/settings.json
+if (targetCodebuddy) {
+  safeMergeJson(claudePath, (data) => {
+    data.mcpServers = data.mcpServers || {};
+    data.mcpServers.biomcp = {
+      type: "stdio",
+      command: normalizedNodePath,
+      args: [normalizedBundlePath],
+      env: data.mcpServers.biomcp?.env || {},
+    };
+    return data;
+  });
+
+  safeMergeJson(codebuddySettingsPath, (data) => {
+    const approved = new Set(data.enabledMcpjsonServers || []);
+    approved.add("biomcp");
+    data.enabledMcpjsonServers = Array.from(approved);
+    return data;
+  });
+}
+
+// WorkBuddy: .workbuddy/mcp.json
+if (targetWorkbuddy) {
+  safeMergeJson(workbuddyPath, (data) => {
+    data.mcpServers = data.mcpServers || {};
+    data.mcpServers.biomcp = {
+      type: "stdio",
+      command: normalizedNodePath,
+      args: [normalizedBundlePath],
+      env: data.mcpServers.biomcp?.env || {},
+    };
+    return data;
+  });
+}
+
+// 8. Run pre-flight verification via biomcp doctor --json
+console.log("[bioresearcher-onboard] Running pre-flight verification via biomcp doctor...");
+const cliPath = path.join(RUNTIME_ROOT, "node_modules", "biomcp", "dist", "cli.js");
+const doctorRes = spawnSync(nodeBin, [cliPath, "doctor", "--json"], {
+  cwd: CWD,
+  encoding: "utf8",
+});
+
+if (doctorRes.status === 0) {
+  try {
+    const report = JSON.parse(doctorRes.stdout);
+    console.log(`[bioresearcher-onboard] ✓ Pre-flight check PASSED (schema v${report.schema_version})`);
+    console.log(`  Node: ${report.node.version} (required ${report.node.required})`);
+    console.log(`  Install mode: ${report.server_context.install_mode}`);
+    for (const f of report.features) {
+      console.log(`  Feature ${f.id}: ${f.running_after_restart ? "ON after restart" : "off"}`);
+    }
+  } catch {
+    console.log("[bioresearcher-onboard] ✓ Doctor exit code 0");
+  }
+} else {
+  console.warn("[bioresearcher-onboard] Warning: Doctor reported potential blockers:");
+  console.log(doctorRes.stdout || doctorRes.stderr);
+}
+
+// 9. Git Hygiene: Ensure .bioresearcher-runtime is gitignored
+const gitignorePath = path.resolve(CWD, ".gitignore");
+let gitignoreContent = "";
+if (fs.existsSync(gitignorePath)) {
+  gitignoreContent = fs.readFileSync(gitignorePath, "utf8");
+}
+if (!gitignoreContent.includes(".bioresearcher-runtime")) {
+  const newline = gitignoreContent.length > 0 && !gitignoreContent.endsWith("\n") ? "\n" : "";
+  fs.appendFileSync(gitignorePath, `${newline}# BioMCP project-local runtime\n.bioresearcher-runtime/\n`);
+  console.log("[bioresearcher-onboard] Added .bioresearcher-runtime/ to .gitignore");
+}
+
+console.log("\n========================================================");
+console.log("✓ BioMCP runtime bootstrapped successfully!");
+console.log(`  Runtime directory: .bioresearcher-runtime/`);
+console.log(`  Node.js: ${nodeBin}`);
+console.log(`  BioMCP bundle: ${bundlePath}`);
+console.log("\n→ NEXT STEP: Restart your agent/client session to activate biomcp tools.");
+console.log("========================================================\n");

package/loader.js

@@ -1,3 +0,0 @@
-// Root loader for OpenCode shallow plugin auto-discovery (.opencode/plugins/bioresearcher.js).
-export { default } from "./bioresearcher/index.js";
-export * from "./bioresearcher/index.js";