feat: cli launcher npx kandev (#39)

* feat: cli launcher * feat: improved debug
2026-01-18 20:42:03 +00:00
parent 16b3fb5b92
commit bc6a5f28d9
29 changed files with 1682 additions and 33 deletions
@@ -0,0 +1,75 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+
+import {
+  DEFAULT_AGENTCTL_PORT,
+  DEFAULT_BACKEND_PORT,
+  DEFAULT_WEB_PORT,
+  HEALTH_TIMEOUT_MS,
+} from "./constants";
+import { waitForHealth } from "./health";
+import { pickAvailablePort } from "./ports";
+import { createProcessSupervisor } from "./process";
+import { launchWebApp } from "./web";
+
+export type DevOptions = {
+  repoRoot: string;
+  backendPort?: number;
+  webPort?: number;
+};
+
+export async function runDev({ repoRoot, backendPort, webPort }: DevOptions): Promise<void> {
+  const actualBackendPort = backendPort ?? (await pickAvailablePort(DEFAULT_BACKEND_PORT));
+  const actualWebPort = webPort ?? (await pickAvailablePort(DEFAULT_WEB_PORT));
+  const agentctlPort = await pickAvailablePort(DEFAULT_AGENTCTL_PORT);
+  const backendUrl = `http://localhost:${actualBackendPort}`;
+
+  const backendEnv = {
+    ...process.env,
+    KANDEV_SERVER_PORT: String(actualBackendPort),
+    KANDEV_AGENT_STANDALONE_PORT: String(agentctlPort),
+  };
+  const webEnv = {
+    ...process.env,
+    KANDEV_API_BASE_URL: backendUrl,
+    NEXT_PUBLIC_KANDEV_API_BASE_URL: backendUrl,
+    PORT: String(actualWebPort),
+    NEXT_PUBLIC_KANDEV_DEBUG: "true",
+  };
+
+  console.log("[kandev] dev mode: using local repo");
+  console.log("[kandev] backend port:", actualBackendPort);
+  console.log("[kandev] web port:", actualWebPort);
+  console.log("[kandev] agentctl port:", agentctlPort);
+
+  const supervisor = createProcessSupervisor();
+  supervisor.attachSignalHandlers();
+
+  const backendProc = spawn(
+    "make",
+    ["-C", path.join("apps", "backend"), "dev"],
+    { cwd: repoRoot, env: backendEnv, stdio: "inherit" },
+  );
+  supervisor.children.push(backendProc);
+
+  backendProc.on("exit", (code, signal) => {
+    console.error(`[kandev] backend exited (code=${code}, signal=${signal})`);
+    const exitCode = signal ? 0 : code ?? 1;
+    void supervisor.shutdown("backend exit").then(() => process.exit(exitCode));
+  });
+
+  await waitForHealth(backendUrl, backendProc, HEALTH_TIMEOUT_MS);
+  console.log(`[kandev] backend ready at ${backendUrl}`);
+
+  const webUrl = `http://localhost:${actualWebPort}`;
+  launchWebApp({
+    command: "pnpm",
+    args: ["-C", "apps", "--filter", "@kandev/web", "dev"],
+    cwd: repoRoot,
+    env: webEnv,
+    url: webUrl,
+    supervisor,
+    label: "web",
+  });
+  console.log(`[kandev] web ready at ${webUrl}`);
+}