@chriscode/devmux 1.0.0 → 1.3.1

package/dist/cli.js

@@ -1,18 +1,246 @@
 #!/usr/bin/env node
 import {
-  attachService,
   discoverFromTurbo,
-  ensureService,
   formatDiscoveredConfig,
+  getAllWatcherStatuses,
+  runWithServices,
+  startAllWatchers,
+  startWatcher,
+  stopAllWatchers,
+  stopWatcher
+} from "./chunk-6EU6ODXX.js";
+import {
+  clearQueue,
+  getPendingEvents
+} from "./chunk-32R7KDZB.js";
+import {
+  attachService,
+  ensureService,
   getAllStatus,
+  getProcessOnPort,
+  init_loader,
   loadConfig,
-  runWithServices,
+  loader_exports,
+  restartService,
   stopAllServices,
   stopService
-} from "./chunk-7JJYYMUP.js";
+} from "./chunk-ALENFKSX.js";
+import {
+  __toCommonJS,
+  init_esm_shims
+} from "./chunk-66UOCF5R.js";
 
 // src/cli.ts
+init_esm_shims();
+init_loader();
 import { defineCommand, runMain } from "citty";
+import { mkdirSync, existsSync, cpSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+
+// src/utils/diagnose.ts
+init_esm_shims();
+import { networkInterfaces } from "os";
+function getAddressesToCheck() {
+  const addresses = ["127.0.0.1", "0.0.0.0", "::1"];
+  const interfaces = networkInterfaces();
+  for (const [name, addrs] of Object.entries(interfaces)) {
+    if (!addrs) continue;
+    for (const addr of addrs) {
+      if (addr.internal) continue;
+      if (addr.address.startsWith("fe80")) continue;
+      if (addr.address.startsWith("169.254")) continue;
+      if (!addresses.includes(addr.address)) {
+        addresses.push(addr.address);
+      }
+    }
+  }
+  return addresses;
+}
+async function checkPortStatus(port, address) {
+  const proc = await getProcessOnPort(port);
+  if (proc) {
+    return {
+      address,
+      status: "occupied",
+      process: { name: proc.name, pid: proc.pid, cmd: proc.cmd }
+    };
+  }
+  return { address, status: "free" };
+}
+function detectBlockerType(processName, cmd) {
+  const lowerName = processName.toLowerCase();
+  const lowerCmd = cmd?.toLowerCase() || "";
+  const vpnPatterns = [
+    { pattern: /tailscale/, name: "Tailscale" },
+    { pattern: /wireguard/, name: "WireGuard" },
+    { pattern: /openvpn/, name: "OpenVPN" },
+    { pattern: /anyconnect/, name: "Cisco AnyConnect" },
+    { pattern: /forticlient/, name: "FortiClient" },
+    { pattern: /globalprotect/, name: "GlobalProtect" },
+    { pattern: /netextender/, name: "NetExtender" },
+    { pattern: /warp/, name: "Cloudflare WARP" },
+    { pattern: /zerotier/, name: "ZeroTier" },
+    { pattern: /hamachi/, name: "LogMeIn Hamachi" },
+    { pattern: /nordvpn/, name: "NordVPN" },
+    { pattern: /expressvpn/, name: "ExpressVPN" },
+    { pattern: /protonvpn/, name: "ProtonVPN" },
+    { pattern: /surfshark/, name: "Surfshark" },
+    { pattern: /tunnelbear/, name: "TunnelBear" },
+    { pattern: /ipvanish/, name: "IPVanish" }
+  ];
+  for (const { pattern, name } of vpnPatterns) {
+    if (pattern.test(lowerName) || pattern.test(lowerCmd)) {
+      return { type: "vpn", name };
+    }
+  }
+  const dockerPatterns = [
+    { pattern: /docker/, name: "Docker" },
+    { pattern: /containerd/, name: "containerd" },
+    { pattern: /podman/, name: "Podman" },
+    { pattern: /nerdctl/, name: "nerdctl" }
+  ];
+  for (const { pattern, name } of dockerPatterns) {
+    if (pattern.test(lowerName) || pattern.test(lowerCmd)) {
+      return { type: "docker", name };
+    }
+  }
+  const systemPatterns = [
+    { pattern: /systemd/, name: "systemd" },
+    { pattern: /launchd/, name: "launchd" },
+    { pattern: /inetd/, name: "inetd" },
+    { pattern: /xinetd/, name: "xinetd" }
+  ];
+  for (const { pattern, name } of systemPatterns) {
+    if (pattern.test(lowerName) || pattern.test(lowerCmd)) {
+      return { type: "system", name };
+    }
+  }
+  return { type: "other", name: processName };
+}
+function generateSuggestion(blockerType, blockerName, port) {
+  switch (blockerType) {
+    case "vpn":
+      if (blockerName === "Tailscale") {
+        return `Tailscale may be proxying this port. Run:
+  tailscale serve status
+  tailscale serve reset  # to clear all
+
+Or check for Funnel:
+  tailscale funnel status`;
+      }
+      return `${blockerName} may be intercepting traffic on this port. Check ${blockerName} settings or temporarily disconnect to test.`;
+    case "docker":
+      return `A Docker container is using this port. Check running containers:
+  docker ps --format "table {{.Names}}\\t{{.Ports}}"
+
+Stop the container or map it to a different port.`;
+    case "system":
+      return `A system service (${blockerName}) is listening on this port. You may need to:
+  sudo lsof -i :${port}
+  sudo systemctl stop <service>  # if using systemd`;
+    default:
+      return `Process is occupying the port. To free it:
+  lsof -ti :${port} | xargs kill -9`;
+  }
+}
+async function diagnosePort(port, serviceName) {
+  const addresses = getAddressesToCheck();
+  const bindings = [];
+  for (const address of addresses) {
+    const binding = await checkPortStatus(port, address);
+    if (binding) {
+      bindings.push(binding);
+    }
+  }
+  const occupiedBindings = bindings.filter((b) => b.status === "occupied");
+  const isBlocked = occupiedBindings.length > 0;
+  let blockerType;
+  let blockerName;
+  let suggestion;
+  if (isBlocked && occupiedBindings.length > 0) {
+    for (const binding of occupiedBindings) {
+      if (binding.process) {
+        const detected = detectBlockerType(binding.process.name, binding.process.cmd);
+        if (detected) {
+          if (detected.type === "vpn") {
+            blockerType = detected.type;
+            blockerName = detected.name;
+            break;
+          } else if (!blockerType) {
+            blockerType = detected.type;
+            blockerName = detected.name;
+          }
+        }
+      }
+    }
+    if (!blockerName && occupiedBindings[0].process) {
+      blockerName = occupiedBindings[0].process.name;
+      blockerType = "other";
+    }
+    if (blockerType && blockerName) {
+      suggestion = generateSuggestion(blockerType, blockerName, port);
+    }
+  }
+  return {
+    port,
+    serviceName,
+    bindings,
+    summary: {
+      isBlocked,
+      blockerType,
+      blockerName,
+      suggestion
+    }
+  };
+}
+function formatDiagnosis(result) {
+  const lines = [];
+  lines.push(`\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`);
+  lines.push(`       Port Diagnosis: ${result.serviceName}`);
+  lines.push(`\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`);
+  lines.push("");
+  lines.push(`Port ${result.port} status:`);
+  lines.push("");
+  for (const binding of result.bindings) {
+    const icon = binding.status === "free" ? "\u2705" : "\u274C";
+    const addressDisplay = binding.address.padEnd(20);
+    lines.push(`  ${icon} ${addressDisplay} ${binding.status.toUpperCase()}`);
+    if (binding.process) {
+      lines.push(`      \u2514\u2500 ${binding.process.name} (PID ${binding.process.pid})`);
+      if (binding.process.cmd) {
+        const shortCmd = binding.process.cmd.length > 60 ? binding.process.cmd.slice(0, 57) + "..." : binding.process.cmd;
+        lines.push(`         ${shortCmd}`);
+      }
+    }
+  }
+  lines.push("");
+  if (result.summary.isBlocked) {
+    lines.push("\u26A0\uFE0F  PORT IS BLOCKED");
+    if (result.summary.blockerName) {
+      lines.push(`   Blocker: ${result.summary.blockerName}`);
+    }
+    lines.push("");
+    if (result.summary.suggestion) {
+      lines.push("Suggestion:");
+      for (const line of result.summary.suggestion.split("\n")) {
+        lines.push(`  ${line}`);
+      }
+    }
+  } else {
+    lines.push("\u2705 Port is free on all interfaces");
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+
+// src/cli.ts
+if (process.platform === "win32" && !process.env.WSL_DISTRO_NAME) {
+  console.error("\u274C DevMux requires Windows Subsystem for Linux (WSL) on Windows");
+  console.error("   Install WSL: https://docs.microsoft.com/en-us/windows/wsl/install");
+  console.error("   Then run DevMux from within your WSL environment");
+  process.exit(1);
+}
 var ensure = defineCommand({
   meta: { name: "ensure", description: "Ensure a service is running (idempotent)" },
   args: {
@@ -35,16 +263,20 @@ var status = defineCommand({
     const config = loadConfig();
     const statuses = await getAllStatus(config);
     if (args.json) {
-      console.log(JSON.stringify(statuses, null, 2));
+      console.log(JSON.stringify({ instanceId: config.instanceId || null, services: statuses }, null, 2));
       return;
     }
     console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
     console.log("       Service Status");
+    if (config.instanceId) {
+      console.log(`       Instance: ${config.instanceId}`);
+    }
     console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
     console.log("");
     for (const s of statuses) {
       const icon = s.healthy ? "\u2705" : "\u274C";
-      const portInfo = s.port ? ` (port ${s.port})` : "";
+      const portDisplay = s.resolvedPort ?? s.port;
+      const portInfo = portDisplay ? ` (port ${portDisplay})` : "";
       console.log(`${icon} ${s.name}${portInfo}: ${s.healthy ? "Running" : "Not running"}`);
       if (s.tmuxSession) {
         console.log(`   \u2514\u2500 tmux: ${s.tmuxSession}`);
@@ -71,6 +303,34 @@ var stop = defineCommand({
     }
   }
 });
+var restart = defineCommand({
+  meta: { name: "restart", description: "Restart a service (stop + start)" },
+  args: {
+    service: { type: "positional", description: "Service name", required: true },
+    timeout: { type: "string", description: "Startup timeout in seconds" },
+    force: { type: "boolean", description: "Also kill processes on ports before restarting" }
+  },
+  async run({ args }) {
+    const config = loadConfig();
+    await restartService(config, args.service, {
+      timeout: args.timeout ? parseInt(args.timeout) : void 0,
+      killPorts: args.force
+    });
+  }
+});
+var start = defineCommand({
+  meta: { name: "start", description: "Start a service (alias for ensure)" },
+  args: {
+    service: { type: "positional", description: "Service name", required: true },
+    timeout: { type: "string", description: "Startup timeout in seconds" }
+  },
+  async run({ args }) {
+    const config = loadConfig();
+    await ensureService(config, args.service, {
+      timeout: args.timeout ? parseInt(args.timeout) : void 0
+    });
+  }
+});
 var attach = defineCommand({
   meta: { name: "attach", description: "Attach to a service's tmux session" },
   args: {
@@ -86,7 +346,7 @@ var run = defineCommand({
   args: {
     with: { type: "string", description: "Comma-separated services to ensure", required: true },
     "no-stop": { type: "boolean", description: "Don't stop services on exit" },
-    _: { type: "positional", description: "Command to run" }
+    "no-dashboard": { type: "boolean", description: "Skip auto-launching the dashboard" }
   },
   async run({ args }) {
     const config = loadConfig();
@@ -98,7 +358,8 @@ var run = defineCommand({
     }
     const exitCode = await runWithServices(config, command, {
       services,
-      stopOnExit: !args["no-stop"]
+      stopOnExit: !args["no-stop"],
+      dashboard: args["no-dashboard"] ? false : void 0
     });
     process.exit(exitCode);
   }
@@ -143,6 +404,213 @@ var init = defineCommand({
     console.log("Save this as devmux.config.json in your project root.");
   }
 });
+var diagnose = defineCommand({
+  meta: { name: "diagnose", description: "Diagnose port issues for a service" },
+  args: {
+    service: { type: "positional", description: "Service name", required: true },
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    const config = loadConfig();
+    const { getResolvedPort } = (init_loader(), __toCommonJS(loader_exports));
+    const port = getResolvedPort(config, args.service);
+    if (port === void 0) {
+      console.error(`\u274C No port configured for service: ${args.service}`);
+      process.exit(1);
+    }
+    const result = await diagnosePort(port, args.service);
+    if (args.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(formatDiagnosis(result));
+  }
+});
+var installSkill = defineCommand({
+  meta: { name: "install-skill", description: "Install DevMux skills to .claude/skills" },
+  run() {
+    const __dirname2 = dirname(fileURLToPath(import.meta.url));
+    const skillDir = join(__dirname2, "skill");
+    const targetDir = join(process.cwd(), ".claude", "skills", "devmux");
+    try {
+      if (!existsSync(skillDir)) {
+        throw new Error(`Skill directory not found at ${skillDir}`);
+      }
+      mkdirSync(targetDir, { recursive: true });
+      cpSync(skillDir, targetDir, { recursive: true });
+      console.log(`\u2705 Installed DevMux skill to .claude/skills/devmux/`);
+    } catch (e) {
+      console.error("\u274C Failed to install skills:");
+      console.error(e);
+      process.exit(1);
+    }
+  }
+});
+var watchStart = defineCommand({
+  meta: { name: "start", description: "Start watching a service for errors" },
+  args: {
+    service: { type: "positional", description: "Service name (or 'all')" }
+  },
+  run({ args }) {
+    const config = loadConfig();
+    const serviceName = args.service;
+    if (!serviceName || serviceName === "all") {
+      startAllWatchers(config);
+    } else {
+      startWatcher(config, serviceName);
+    }
+  }
+});
+var watchStop = defineCommand({
+  meta: { name: "stop", description: "Stop watching a service" },
+  args: {
+    service: { type: "positional", description: "Service name (or 'all')" }
+  },
+  run({ args }) {
+    const config = loadConfig();
+    const serviceName = args.service;
+    if (!serviceName || serviceName === "all") {
+      stopAllWatchers(config);
+    } else {
+      stopWatcher(config, serviceName);
+    }
+  }
+});
+var watchStatus = defineCommand({
+  meta: { name: "status", description: "Show watcher status" },
+  args: {
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  run({ args }) {
+    const config = loadConfig();
+    const statuses = getAllWatcherStatuses(config);
+    if (args.json) {
+      console.log(JSON.stringify(statuses, null, 2));
+      return;
+    }
+    console.log("");
+    console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+    console.log("        Watcher Status");
+    console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+    console.log("");
+    for (const s of statuses) {
+      const icon = s.pipeActive ? "\u{1F441}\uFE0F" : "\u26AB";
+      console.log(`${icon} ${s.service}: ${s.pipeActive ? "Watching" : "Not watching"}`);
+      if (s.pipeActive) {
+        console.log(`   \u2514\u2500 session: ${s.sessionName}`);
+      }
+    }
+    console.log("");
+  }
+});
+var watchQueue = defineCommand({
+  meta: { name: "queue", description: "Show pending errors in queue" },
+  args: {
+    json: { type: "boolean", description: "Output as JSON" },
+    clear: { type: "boolean", description: "Clear the queue" }
+  },
+  run({ args }) {
+    if (args.clear) {
+      clearQueue();
+      console.log("\u2705 Queue cleared");
+      return;
+    }
+    const events = getPendingEvents();
+    if (args.json) {
+      console.log(JSON.stringify(events, null, 2));
+      return;
+    }
+    if (events.length === 0) {
+      console.log("No pending errors in queue.");
+      return;
+    }
+    console.log("");
+    console.log(`\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`);
+    console.log(`        Pending Errors (${events.length})`);
+    console.log(`\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`);
+    console.log("");
+    for (const e of events) {
+      const severityIcon = e.severity === "critical" ? "\u{1F534}" : e.severity === "error" ? "\u{1F7E0}" : e.severity === "warning" ? "\u{1F7E1}" : "\u{1F535}";
+      console.log(`${severityIcon} [${e.service}] ${e.pattern}`);
+      console.log(`   ${e.rawContent.slice(0, 80)}${e.rawContent.length > 80 ? "..." : ""}`);
+      console.log(`   \u2514\u2500 ${e.firstSeen}`);
+      console.log("");
+    }
+  }
+});
+var watch = defineCommand({
+  meta: { name: "watch", description: "Manage error watchers for services" },
+  subCommands: {
+    start: watchStart,
+    stop: watchStop,
+    status: watchStatus,
+    queue: watchQueue
+  }
+});
+var telemetryStart = defineCommand({
+  meta: { name: "start", description: "Start the telemetry server" },
+  args: {
+    port: { type: "string", description: "Port to listen on (default: 9876)" },
+    host: { type: "string", description: "Host to bind to (default: 0.0.0.0)" }
+  },
+  async run({ args }) {
+    const { startServer } = await import("./server-manager-6EZWZK56.js");
+    startServer({
+      port: args.port ? parseInt(args.port) : void 0,
+      host: args.host
+    });
+  }
+});
+var telemetryStop = defineCommand({
+  meta: { name: "stop", description: "Stop the telemetry server" },
+  async run() {
+    const { stopServer } = await import("./server-manager-6EZWZK56.js");
+    stopServer();
+  }
+});
+var telemetryStatus = defineCommand({
+  meta: { name: "status", description: "Show telemetry server status" },
+  args: {
+    json: { type: "boolean", description: "Output as JSON" }
+  },
+  async run({ args }) {
+    const { getServerStatus } = await import("./server-manager-6EZWZK56.js");
+    const status2 = getServerStatus();
+    if (args.json) {
+      console.log(JSON.stringify(status2, null, 2));
+      return;
+    }
+    if (status2.running) {
+      console.log(`Telemetry Server: Running (PID: ${status2.pid})`);
+      console.log(`  Listening on: ws://${status2.host}:${status2.port}`);
+    } else {
+      console.log("Telemetry Server: Not running");
+      console.log("  Start with: devmux telemetry start");
+    }
+  }
+});
+var telemetry = defineCommand({
+  meta: { name: "telemetry", description: "Manage telemetry server for browser/app logs" },
+  subCommands: {
+    start: telemetryStart,
+    stop: telemetryStop,
+    status: telemetryStatus
+  }
+});
+var dashboard = defineCommand({
+  meta: { name: "dashboard", description: "Launch web dashboard for service monitoring (experimental)" },
+  args: {
+    port: { type: "string", description: "Port to listen on (default: 9000)" },
+    "no-open": { type: "boolean", description: "Don't open browser automatically" }
+  },
+  async run({ args }) {
+    const { startDashboard } = await import("./dashboard-3GHLOSV3.js");
+    startDashboard({
+      port: args.port ? parseInt(args.port) : void 0,
+      open: !args["no-open"]
+    });
+  }
+});
 var main = defineCommand({
   meta: {
     name: "devmux",
@@ -151,12 +619,19 @@ var main = defineCommand({
   },
   subCommands: {
     ensure,
+    start,
+    restart,
     status,
     stop,
     attach,
     run,
     discover,
-    init
+    init,
+    diagnose,
+    watch,
+    telemetry,
+    dashboard,
+    "install-skill": installSkill
   }
 });
 runMain(main);

package/dist/dashboard-3GHLOSV3.js

@@ -0,0 +1,8 @@
+import {
+  startDashboard
+} from "./chunk-T6I3CPOV.js";
+import "./chunk-ALENFKSX.js";
+import "./chunk-66UOCF5R.js";
+export {
+  startDashboard
+};