@beeos-ai/cli 1.0.16 → 1.0.18

package/dist/index.js

@@ -1546,22 +1546,36 @@ var init_device = __esm({
         const lines = result.stdout.split("\n").slice(1);
         for (const line of lines) {
           const parts = line.trim().split(/\s+/);
-          if (parts.length >= 2 && parts[1] === "device") {
-            devices.push({ serial: parts[0] });
-          }
+          if (parts.length < 2)
+            continue;
+          const serial = parts[0];
+          const rawStatus = parts[1];
+          let status2;
+          if (rawStatus === "device")
+            status2 = "device";
+          else if (rawStatus === "unauthorized")
+            status2 = "unauthorized";
+          else
+            status2 = "offline";
+          devices.push({ serial, status: status2, rawStatus });
         }
         return devices;
       },
       async detectSingleDevice() {
-        const devices = await this.listAdbDevices();
-        if (devices.length === 0) {
+        const all = await this.listAdbDevices();
+        const ready = all.filter((d) => d.status === "device");
+        if (ready.length === 0) {
+          if (all.length > 0) {
+            const issues = all.map((d) => `${d.serial}=${d.rawStatus}`).join(", ");
+            throw new Error(`No ADB devices ready (only: ${issues}). Accept the USB prompt on the phone or check the cable.`);
+          }
           throw new Error("No ADB devices found. Connect a device and try again.");
         }
-        if (devices.length > 1) {
-          const serials = devices.map((d) => d.serial).join(", ");
+        if (ready.length > 1) {
+          const serials = ready.map((d) => d.serial).join(", ");
           throw new Error(`Multiple ADB devices found: ${serials}. Use --serial to specify one.`);
         }
-        return devices[0].serial;
+        return ready[0].serial;
       },
       async spawnForDevice(serial, agentBin, bridgeUrl, httpEnabled, httpPort, agentGatewayUrl) {
         const p = getPlatformAdapter();
@@ -3347,13 +3361,13 @@ function inferInitChoices(state) {
   if (state.hasIdentity && state.binding) {
     return {
       defaultDecision: "upgrade",
-      options: ["upgrade", "rebind-new-key", "skip"]
+      options: ["upgrade", "rebind", "reset-all", "skip"]
     };
   }
   if (state.hasIdentity) {
     return {
       defaultDecision: "upgrade",
-      options: ["upgrade", "rebind-new-key", "skip"]
+      options: ["upgrade", "reset-all", "skip"]
     };
   }
   return { defaultDecision: "fresh", options: ["fresh", "skip"] };
@@ -3364,8 +3378,10 @@ function initDecisionLabel(decision) {
       return "Install + bind";
     case "upgrade":
       return "Upgrade CLI & agents (keep binding & key)";
-    case "rebind-new-key":
-      return "Re-bind (rotate Ed25519 key)";
+    case "rebind":
+      return "Re-bind (keep key, refresh binding \u2014 same instance)";
+    case "reset-all":
+      return "Reset everything (NEW key, NEW instance \u2014 for compromised key)";
     case "skip":
       return "Skip (do nothing)";
   }
@@ -5109,6 +5125,20 @@ var init_fallback_banner = __esm({
   }
 });
 
+// src/json-envelope.ts
+function jsonOk(data) {
+  return { ok: true, data };
+}
+function emitJsonEnvelope(env) {
+  console.log(JSON.stringify(env, null, 2));
+}
+var init_json_envelope = __esm({
+  "src/json-envelope.ts"() {
+    "use strict";
+    init_dist();
+  }
+});
+
 // src/commands/device/fleet-notify.ts
 async function notifyFleetReloadBestEffort(baseUrl = FLEET_STATUS_BASE_URL) {
   try {
@@ -5245,6 +5275,207 @@ var init_upgrade2 = __esm({
   }
 });
 
+// src/lib/instance-picker.ts
+import readline from "readline";
+function resolveIO(ctx) {
+  return {
+    input: ctx.input ?? process.stdin,
+    output: ctx.output ?? process.stdout
+  };
+}
+function isTTY(ctx, io) {
+  if (ctx.isTTY !== void 0) return ctx.isTTY;
+  return Boolean(io.input.isTTY);
+}
+function ask(io, question) {
+  const rl = readline.createInterface({ input: io.input, output: io.output });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+}
+function statusBlurb(status2) {
+  switch (status2) {
+    case "device":
+      return "device";
+    case "unauthorized":
+      return "unauthorized \u2014 accept the USB prompt on the phone";
+    case "offline":
+      return "offline \u2014 check the USB cable / `adb kill-server`";
+  }
+}
+async function pickInstanceInteractive(candidates, ctx) {
+  const io = resolveIO(ctx);
+  if (!isTTY(ctx, io)) {
+    return { kind: "skip" };
+  }
+  const frameworks = candidates.filter(
+    (c) => c.kind === "framework"
+  );
+  const devices = candidates.filter(
+    (c) => c.kind === "device"
+  );
+  if (ctx.caller === "init") {
+    if (frameworks.length === 1 && devices.length === 0) {
+      return { kind: "framework", id: frameworks[0].id };
+    }
+    return renderMixedMenu(frameworks, devices, io);
+  }
+  if (devices.length === 0) {
+    if (ctx.caller === "discover") {
+      io.output.write("No ADB devices found. Connect a device and try again.\n");
+    }
+    return { kind: "skip" };
+  }
+  if (devices.length === 1) {
+    return askYesNoSingleDevice(devices[0], io);
+  }
+  return renderDeviceMenu(devices, io);
+}
+async function renderMixedMenu(frameworks, devices, io) {
+  const items = [];
+  let idx = 1;
+  for (const fw of frameworks) {
+    items.push({
+      idx: idx++,
+      kind: "framework",
+      id: fw.id,
+      label: fw.label,
+      isDefault: fw.isDefault === true
+    });
+  }
+  for (const d of devices) {
+    items.push({
+      idx: idx++,
+      kind: "device",
+      serial: d.serial,
+      status: d.status,
+      selectable: d.status === "device"
+    });
+  }
+  const defaultItem = items.find((i) => i.kind === "framework" && i.isDefault) ?? items[0];
+  io.output.write("\n");
+  io.output.write("What would you like to bind on this machine?\n");
+  io.output.write("\n");
+  if (frameworks.length > 0) {
+    io.output.write("  Local agent:\n");
+    for (const it of items) {
+      if (it.kind !== "framework") continue;
+      const def = it.isDefault ? "  (default)" : "";
+      io.output.write(`    [${it.idx}] ${it.label}${def}
+`);
+    }
+    io.output.write("\n");
+  }
+  if (devices.length > 0) {
+    io.output.write(`  ADB devices (${devices.length} found):
+`);
+    for (const it of items) {
+      if (it.kind !== "device") continue;
+      const tag = statusBlurb(it.status);
+      io.output.write(`    [${it.idx}] ${it.serial.padEnd(20)} ${tag}
+`);
+    }
+    io.output.write("\n");
+  }
+  io.output.write("  [s] Skip\n");
+  io.output.write("\n");
+  return promptForChoice(items, defaultItem.idx, io);
+}
+async function renderDeviceMenu(devices, io) {
+  const items = devices.map((d, i) => ({
+    idx: i + 1,
+    kind: "device",
+    serial: d.serial,
+    status: d.status,
+    selectable: d.status === "device"
+  }));
+  io.output.write("\n");
+  io.output.write(`Detected ${devices.length} ADB devices:
+`);
+  for (const it of items) {
+    io.output.write(`  [${it.idx}] ${it.serial.padEnd(20)} ${statusBlurb(it.status)}
+`);
+  }
+  io.output.write("\n");
+  return promptForChoice(
+    items,
+    /* defaultIdx */
+    -1,
+    io
+  );
+}
+async function askYesNoSingleDevice(device, io) {
+  if (device.status !== "device") {
+    io.output.write(
+      `Found 1 ADB device (serial=${device.serial}) but its status is ${statusBlurb(device.status)}.
+Skipping. Fix the device state and re-run.
+`
+    );
+    return { kind: "skip" };
+  }
+  for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+    const answer = (await ask(io, `Found 1 ADB device (serial=${device.serial}). Attach now? [Y/n]: `)).trim().toLowerCase();
+    if (answer === "" || answer === "y" || answer === "yes") {
+      return { kind: "device", serial: device.serial };
+    }
+    if (answer === "n" || answer === "no" || answer === "s" || answer === "skip") {
+      return { kind: "skip" };
+    }
+    io.output.write(`  invalid input '${answer}'. Please answer Y or n.
+`);
+  }
+  io.output.write("  too many invalid inputs \u2014 skipping.\n");
+  return { kind: "skip" };
+}
+async function promptForChoice(items, defaultIdx, io) {
+  const range = `1-${items.length}`;
+  const defaultHint = defaultIdx > 0 ? `default ${defaultIdx}` : "default skip";
+  for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+    const raw = await ask(io, `Choose [${range} / s] (${defaultHint}): `);
+    const trimmed = raw.trim().toLowerCase();
+    if (trimmed === "" && defaultIdx > 0) {
+      return itemToSelection(items[defaultIdx - 1], io);
+    }
+    if (trimmed === "" || trimmed === "s" || trimmed === "skip") {
+      return { kind: "skip" };
+    }
+    const n = Number.parseInt(trimmed, 10);
+    if (!Number.isFinite(n) || n < 1 || n > items.length) {
+      io.output.write(`  invalid input '${raw.trim()}'. Please pick a number in ${range} or 's'.
+`);
+      continue;
+    }
+    const picked = items[n - 1];
+    if (picked.kind === "device" && !picked.selectable) {
+      io.output.write(
+        `  device ${picked.serial} is ${statusBlurb(picked.status)} and cannot be attached yet.
+  Fix the device state on the phone and re-run.
+`
+      );
+      continue;
+    }
+    return itemToSelection(picked, io);
+  }
+  io.output.write("  too many invalid inputs \u2014 skipping.\n");
+  return { kind: "skip" };
+}
+function itemToSelection(item, _io) {
+  if (item.kind === "framework") {
+    return { kind: "framework", id: item.id };
+  }
+  return { kind: "device", serial: item.serial };
+}
+var MAX_RETRIES;
+var init_instance_picker = __esm({
+  "src/lib/instance-picker.ts"() {
+    "use strict";
+    MAX_RETRIES = 3;
+  }
+});
+
 // src/commands/device/state.ts
 import lockfile from "proper-lockfile";
 function deviceAgentTargetId(serial) {
@@ -5310,7 +5541,7 @@ var init_state2 = __esm({
 
 // src/commands/device/attach.ts
 import { spawn as spawn2 } from "child_process";
-import readline from "readline";
+import readline2 from "readline";
 function resolvePerDeviceAgentGatewayUrl(cfg, override) {
   if (override === void 0) return resolveAgentGatewayUrl(cfg);
   const trimmed = override.trim();
@@ -5342,6 +5573,24 @@ function resolvePerDeviceAgentGatewayUrl(cfg, override) {
   }
   return trimmed;
 }
+async function pickAttachSerial() {
+  const devices = await deviceRuntime.listAdbDevices();
+  const ready = devices.filter((d) => d.status === "device");
+  if (ready.length <= 1) {
+    return deviceRuntime.detectSingleDevice();
+  }
+  if (!process.stdin.isTTY) {
+    return deviceRuntime.detectSingleDevice();
+  }
+  const candidates = devices.map((d) => ({
+    kind: "device",
+    serial: d.serial,
+    status: d.status
+  }));
+  const sel = await pickInstanceInteractive(candidates, { caller: "attach" });
+  if (sel.kind === "device") return sel.serial;
+  return deviceRuntime.detectSingleDevice();
+}
 async function attach(options) {
   const cfg = await loadOrCreateConfig();
   const reporter = new CliReporter();
@@ -5353,7 +5602,7 @@ async function attach(options) {
   if (options.all) {
     return attachAll(cfg, reporter, withVideo, options);
   }
-  const serial = options.serial ?? await deviceRuntime.detectSingleDevice();
+  const serial = options.serial ?? await pickAttachSerial();
   const name = options.name ?? serial;
   await deviceRuntime.ensureAgent(reporter);
   reporter.stop();
@@ -5468,11 +5717,26 @@ async function attach(options) {
   await maybeNotifyFleetWithHint(cfg);
 }
 async function attachAll(cfg, reporter, withVideo, options) {
-  const devices = await deviceRuntime.listAdbDevices();
+  const all = await deviceRuntime.listAdbDevices();
+  const devices = all.filter((d) => d.status === "device");
+  const skipped = all.filter((d) => d.status !== "device");
   if (devices.length === 0) {
-    console.log("No ADB devices detected");
+    if (skipped.length > 0) {
+      console.log("No ADB devices ready to attach. Issues:");
+      for (const d of skipped) {
+        console.log(`  ${d.serial}: ${d.rawStatus}`);
+      }
+    } else {
+      console.log("No ADB devices detected");
+    }
     return;
   }
+  if (skipped.length > 0) {
+    console.log(`Skipping ${skipped.length} device(s) not in 'device' state:`);
+    for (const d of skipped) {
+      console.log(`  ${d.serial}: ${d.rawStatus}`);
+    }
+  }
   console.log(`Discovered ${devices.length} device(s) via adb.`);
   await deviceRuntime.ensureAgent(reporter);
   reporter.stop();
@@ -5712,7 +5976,7 @@ async function maybeNotifyFleetWithHint(cfg) {
   console.log("it, the device is recorded in ~/.beeos/devices.json but");
   console.log("no process is supervising the per-device agent.");
   console.log("");
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
   const answer = await new Promise((resolve) => {
     rl.question("Enable fleet now (registers a launchd service)? [Y/n]: ", (a) => {
       rl.close();
@@ -5886,7 +6150,7 @@ Android SDK Platform-Tools (adb) is licensed under the Android SDK License Agree
 Set BEEOS_ACCEPT_ADB_LICENSE=1 in your environment to skip this prompt next time.
 `
   );
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
   const ans = await new Promise((resolve) => {
     rl.question("Agree to the Android SDK license and download platform-tools? [Y/n]: ", (a) => {
       rl.close();
@@ -5900,6 +6164,7 @@ var init_attach = __esm({
     "use strict";
     init_dist();
     init_progress2();
+    init_instance_picker();
     init_fallback_banner();
     init_fleet_notify();
     init_state2();
@@ -6136,11 +6401,65 @@ var init_refresh_config = __esm({
   }
 });
 
+// src/commands/device/discover.ts
+async function run6(options = {}) {
+  const reporter = new CliReporter();
+  await ensureAdb(reporter, { autoInstall: false });
+  reporter.stop();
+  let devices;
+  try {
+    devices = await deviceRuntime.listAdbDevices();
+  } catch (e) {
+    if (options.json) {
+      emitJsonEnvelope(jsonOk({ devices: [], selected: null, action: "skip" }));
+      return;
+    }
+    console.log("ADB is not available \u2014 install Android platform-tools or run `beeos device attach` once to auto-install.");
+    console.log(`  (${e instanceof Error ? e.message : String(e)})`);
+    return;
+  }
+  if (options.json) {
+    emitJsonEnvelope(
+      jsonOk({
+        devices: devices.map((d) => ({
+          serial: d.serial,
+          status: d.status,
+          rawStatus: d.rawStatus
+        })),
+        selected: null,
+        action: "list"
+      })
+    );
+    return;
+  }
+  const candidates = devices.map((d) => ({
+    kind: "device",
+    serial: d.serial,
+    status: d.status
+  }));
+  const sel = await pickInstanceInteractive(candidates, { caller: "discover" });
+  if (sel.kind === "skip") return;
+  if (sel.kind === "device") {
+    await attach({ serial: sel.serial });
+  }
+}
+var init_discover = __esm({
+  "src/commands/device/discover.ts"() {
+    "use strict";
+    init_dist();
+    init_progress2();
+    init_json_envelope();
+    init_instance_picker();
+    init_attach();
+  }
+});
+
 // src/commands/device/index.ts
 var device_exports = {};
 __export(device_exports, {
   attach: () => attach,
   detach: () => detach,
+  discover: () => run6,
   exec: () => exec,
   list: () => list,
   nextHttpPort: () => nextHttpPort,
@@ -6156,6 +6475,7 @@ var init_device2 = __esm({
     init_exec();
     init_upgrade2();
     init_refresh_config();
+    init_discover();
     init_state2();
   }
 });
@@ -6379,18 +6699,8 @@ var NodePlatformAdapter = class {
 init_dist();
 init_progress2();
 init_fallback_banner();
+init_json_envelope();
 import os6 from "os";
-
-// src/json-envelope.ts
-init_dist();
-function jsonOk(data) {
-  return { ok: true, data };
-}
-function emitJsonEnvelope(env) {
-  console.log(JSON.stringify(env, null, 2));
-}
-
-// src/commands/start.ts
 async function run(agentFramework, options) {
   const p = getPlatformAdapter();
   await ensureDirs();
@@ -6581,6 +6891,7 @@ async function run2(agentFramework) {
 
 // src/commands/status.ts
 init_dist();
+init_json_envelope();
 async function run3(options = {}) {
   const home = beeoHome();
   const cfg = await loadOrCreateConfig();
@@ -6646,6 +6957,7 @@ function formatService(s) {
 
 // src/commands/update.ts
 init_dist();
+init_json_envelope();
 init_upgrade2();
 async function run4(agentFramework, options = {}) {
   if (agentFramework === "device") {
@@ -6686,6 +6998,7 @@ async function run4(agentFramework, options = {}) {
 
 // src/commands/bind-status.ts
 init_dist();
+init_json_envelope();
 async function run5(bindId, options) {
   const cfg = await loadOrCreateConfig();
   const resp = await getBindStatus(cfg.platform.api_url, bindId);
@@ -6749,14 +7062,15 @@ init_device2();
 
 // src/commands/init.ts
 init_dist();
-import readline2 from "readline";
+import readline3 from "readline";
 
 // src/commands/doctor.ts
 init_dist();
+init_json_envelope();
 import fs9 from "fs/promises";
 import path9 from "path";
 var LOG_SIZE_WARN_BYTES = 50 * 1024 * 1024;
-async function run6(options) {
+async function run7(options) {
   const state = await detectExistingInstall();
   const cfg = await loadOrCreateConfig();
   const p = getPlatformAdapter();
@@ -7062,9 +7376,11 @@ function formatAgentGatewayStatus(h) {
 }
 
 // src/commands/init.ts
+init_attach();
 init_progress2();
 init_fallback_banner();
-async function run7(options) {
+init_instance_picker();
+async function run8(options) {
   await ensureDirs();
   if (options.device) {
     const { attach: attach2 } = await Promise.resolve().then(() => (init_device2(), device_exports));
@@ -7073,7 +7389,7 @@ async function run7(options) {
   }
   const state = await detectExistingInstall();
   if (options.json) {
-    await run6({ json: true });
+    await run7({ json: true });
   } else {
     printBanner();
     for (const line of summarizeExistingInstall(state)) {
@@ -7099,10 +7415,45 @@ async function run7(options) {
     }
     console.log("Ensuring OpenClaw is running...\n");
   }
-  if (decision === "rebind-new-key") {
+  if (decision === "rebind") {
+    await removeBindingInfo();
+  }
+  if (decision === "reset-all") {
     await rotateIdentity();
     await removeBindingInfo();
   }
+  if (decision === "fresh" && !options.framework && !options.yes && !options.json && process.stdin.isTTY) {
+    const sel = await pickFreshInstance(options);
+    if (sel.kind === "skip") {
+      console.log("Skipped. Re-run `beeos init` or `beeos device attach` whenever ready.");
+      return;
+    }
+    if (sel.kind === "device") {
+      await attach({ serial: sel.serial });
+      return;
+    }
+    const descriptor2 = frameworkById(sel.id);
+    if (!descriptor2 || descriptor2.status !== "available") {
+      throw new BeeosError({
+        code: "framework_unavailable",
+        message: `Agent framework '${sel.id}' is not available.`,
+        hint: "Pick a different framework or reinstall the CLI.",
+        details: { requested: sel.id, available: availableFrameworks().map((f) => f.id) }
+      });
+    }
+    await run(descriptor2.id, {
+      force: true,
+      json: options.json,
+      browser: options.browser !== false
+    });
+    if (!options.json && !options.skipServicePrompt) {
+      await maybePromptServiceInstall();
+    }
+    if (!options.json) {
+      printNextSteps();
+    }
+    return;
+  }
   const frameworkId = await decideFramework(state, decision, options);
   const descriptor = frameworkById(frameworkId);
   if (!descriptor || descriptor.status !== "available") {
@@ -7201,6 +7552,32 @@ async function decideFramework(state, decision, options) {
   }
   return picked.id;
 }
+async function safeListAdbDevices() {
+  const adbPath = await findAdb().catch(() => null);
+  if (!adbPath) return [];
+  try {
+    return await deviceRuntime.listAdbDevices();
+  } catch {
+    return [];
+  }
+}
+async function pickFreshInstance(_opts) {
+  const frameworks = availableFrameworks().map((f) => ({
+    kind: "framework",
+    id: f.id,
+    label: f.displayName,
+    description: f.description,
+    isDefault: f.id === defaultFrameworkId()
+  }));
+  const devices = (await safeListAdbDevices()).map((d) => ({
+    kind: "device",
+    serial: d.serial,
+    status: d.status
+  }));
+  return pickInstanceInteractive([...frameworks, ...devices], {
+    caller: "init"
+  });
+}
 async function maybePromptServiceInstall() {
   try {
     const mgr = await getServiceManager();
@@ -7252,7 +7629,7 @@ function printNextSteps() {
   console.log("");
 }
 function prompt(question) {
-  const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline3.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
     rl.question(question, (answer) => {
       rl.close();
@@ -7328,6 +7705,7 @@ async function pickInstalledPackages() {
 
 // src/commands/service.ts
 init_dist();
+init_json_envelope();
 async function install(options) {
   const mgr = await getServiceManager();
   const check = await mgr.selfCheck();
@@ -7412,7 +7790,8 @@ async function status(options) {
 
 // src/commands/migrate.ts
 init_dist();
-async function run8(options) {
+init_json_envelope();
+async function run9(options) {
   await ensureDirs();
   const mgr = await getServiceManager();
   const mig = await migrateLegacySupervisor(mgr);
@@ -7449,6 +7828,7 @@ async function run8(options) {
 
 // src/commands/logs.ts
 init_dist();
+init_json_envelope();
 function resolveLogTarget(input, services) {
   const exact = services.find((s) => s.id === input);
   if (exact) {
@@ -7470,7 +7850,7 @@ function resolveLogTarget(input, services) {
     matchedFrom: "fallback"
   };
 }
-async function run9(idArg, options) {
+async function run10(idArg, options) {
   const mgr = await getServiceManager();
   let services = [];
   try {
@@ -7544,12 +7924,12 @@ setPlatformAdapter(new NodePlatformAdapter());
 var program = new Command();
 var cliVersion = getCliVersion(import.meta.url, resolveActiveDistTag());
 program.name("beeos").version(cliVersion.display).description("BeeOS \u2014 run AI agents from your desktop");
-program.command("init").description("One-shot install + bind flow (default entry from the curl installer)").option("--framework <name>", "Agent framework to install (default: openclaw)").option("--yes", "Non-interactive \u2014 accept the default action", false).option("--json", "Output machine-readable JSON (implies --yes)", false).option("--no-browser", "Don't auto-open a browser for bind confirmation").option("--headless", "Never open a browser (use terminal QR only)", false).option("--skip-service-prompt", "Skip the system-service install prompt", false).option("--device", "Jump straight into `beeos device attach` instead", false).action((opts) => run7(opts));
-program.command("doctor").description("Inspect local BeeOS state (install, binding, services, warnings)").option("--json", "Output machine-readable JSON", false).action((opts) => run6(opts));
-program.command("migrate").description("Migrate legacy Node supervisor state to OS-native services (one-shot)").option("--json", "Output machine-readable JSON", false).action((opts) => run8(opts));
+program.command("init").description("One-shot install + bind flow (default entry from the curl installer)").option("--framework <name>", "Agent framework to install (default: openclaw)").option("--yes", "Non-interactive \u2014 accept the default action", false).option("--json", "Output machine-readable JSON (implies --yes)", false).option("--no-browser", "Don't auto-open a browser for bind confirmation").option("--headless", "Never open a browser (use terminal QR only)", false).option("--skip-service-prompt", "Skip the system-service install prompt", false).option("--device", "Jump straight into `beeos device attach` instead", false).action((opts) => run8(opts));
+program.command("doctor").description("Inspect local BeeOS state (install, binding, services, warnings)").option("--json", "Output machine-readable JSON", false).action((opts) => run7(opts));
+program.command("migrate").description("Migrate legacy Node supervisor state to OS-native services (one-shot)").option("--json", "Output machine-readable JSON", false).action((opts) => run9(opts));
 program.command("logs").description(
   "Tail logs for a BeeOS service. Pass an ADB serial or service id; omit to list every registered service's log file path."
-).argument("[id]", "Service id (e.g. `device-agent-<serial>`) or raw ADB serial").option("-f, --follow", "Stream new log lines (Ctrl-C to exit)", false).option("-n, --lines <n>", "Initial trailing lines to print (default 50)", (v) => Number(v)).option("--json", "Output machine-readable JSON (resolves the path; does not stream)", false).action((id, opts) => run9(id, opts));
+).argument("[id]", "Service id (e.g. `device-agent-<serial>`) or raw ADB serial").option("-f, --follow", "Stream new log lines (Ctrl-C to exit)", false).option("-n, --lines <n>", "Initial trailing lines to print (default 50)", (v) => Number(v)).option("--json", "Output machine-readable JSON (resolves the path; does not stream)", false).action((id, opts) => run10(id, opts));
 var serviceCmd = program.command("service").description("Inspect and manage the OS-native service manager (launchd / systemd --user / Task Scheduler)");
 serviceCmd.command("install").description("Verify the OS service manager is available (per-target services install automatically)").option("--json", "Output machine-readable JSON", false).action((opts) => install(opts));
 serviceCmd.command("uninstall").description("Uninstall every BeeOS-managed OS service").option("--json", "Output machine-readable JSON", false).action((opts) => uninstall(opts));
@@ -7577,6 +7957,9 @@ deviceCmd.command("upgrade").description("Upgrade the device-agent (and scrcpy/v
 deviceCmd.command("refresh-config").description(
   "Re-fetch this device's VLM/ARouter config from Agent Gateway and rewrite ~/.beeos/<instance_id>.config.json (use after dashboard changes)."
 ).option("--serial <serial>", "ADB device serial number").option("--all", "Refresh every attached device", false).action(refreshConfig);
+deviceCmd.command("discover").description(
+  "List ADB devices and pick one to attach (interactive). Use this when you've plugged in a phone after `beeos init` and want to attach it without remembering --serial."
+).option("--json", "Output machine-readable JSON envelope ({ok,data})", false).action((opts) => run6(opts));
 program.parseAsync(process.argv).catch((err) => {
   const wantsJson = process.argv.includes("--json");
   if (isBeeosError(err)) {