@gachlab/devup 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to `@gachlab/devup` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.1] — 2026-05-22
+
+Patch focused on two real-world footguns surfaced as soon as 0.8.0 hit users.
+
+### Fixed
+- **Spawner port pre-flight was unreliable.** The check used `checkPort` — a connect-based test designed for health checks — which can miss bindings (e.g. a server bound but not yet accepting connections, or listening on a different address family). When the check missed, the service crashed with a raw `EADDRINUSE` Node stack trace dumped to the logs panel. Replaced with `isPortBindable()` — a bind-based test using `net.createServer().listen()` — which catches every case that would actually conflict.
+- **Pre-flight failures now record a crashed state.** Previously the spawner returned silently when the port was occupied, leaving no entry in the services list. Now the failed service appears in the stats panel as `crashed` with the `⚠ port N already in use` line in its log, matching the behaviour of other pre-flight failures.
+
+### Added
+- **TUI refuses to start when a daemon is already running for the project.** Running `devup` (TUI) on top of `devup up -d` would race for the same ports — every API would fail with EADDRINUSE. The TUI now detects the PID file before mounting Ink and exits with a clear pointer to `devup down` and the `devup ctl` family.
+
+### Internals
+- New public `isPortBindable(port, host?)` in `src/process/health.ts`. `checkPort` keeps its connect-based semantics for health checks and `waitForPort`. Three new tests cover free / occupied / bound-but-not-accepting cases.
+
 ## [0.8.0] — 2026-05-22
 
 **Headless devup.** The control plane grows up: streaming events, a CLI client that speaks it end-to-end, and the long-requested daemon mode so the stack can be left running while you keep working in the same terminal — `docker compose up -d` for Node monorepos.

package/dist/index.js

@@ -459,6 +459,23 @@ function checkPort(port, host = "127.0.0.1", timeoutMs = 2e3) {
     socket.connect(port, host);
   });
 }
+async function isPortBindable(port) {
+  for (const host of ["0.0.0.0", "::"]) {
+    if (!await tryBind(port, host)) return false;
+  }
+  return true;
+}
+function tryBind(port, host) {
+  return new Promise((resolve4) => {
+    const server = net.createServer();
+    server.once("error", (err) => {
+      if (err.code === "EADDRINUSE" || err.code === "EACCES") resolve4(false);
+      else resolve4(true);
+    });
+    server.once("listening", () => server.close(() => resolve4(true)));
+    server.listen(port, host);
+  });
+}
 function checkHttp(port, opts = {}) {
   const path = opts.path ?? "/";
   const host = opts.host ?? "127.0.0.1";
@@ -1026,9 +1043,10 @@ var Spawner = class {
   async start(svc, colorIdx, isRestart = false) {
     const cwd = join4(this.baseCwd, svc.cwd);
     if (svc.type === "api") {
-      const occupied = await checkPort(svc.port);
-      if (occupied && !isRestart) {
+      const bindable = await isPortBindable(svc.port);
+      if (!bindable && !isRestart) {
         this.log(svc.name, `\u26A0 port ${svc.port} already in use \u2014 skipping`, colorIdx);
+        this.recordCrashedState(svc, colorIdx);
         return;
       }
     }
@@ -3996,6 +4014,16 @@ ${formatValidationWarnings(warnings)}`);
       proxyOpts
     }));
   }
+  const daemonStatus = isDaemonRunning(config.name);
+  if (daemonStatus.pid && !daemonStatus.stale) {
+    console.error(`\u274C A devup daemon is already running for "${config.name}" (pid=${daemonStatus.pid}).`);
+    console.error("");
+    console.error("Stop it first with `devup down`, or interact via the control plane:");
+    console.error("  devup ctl status");
+    console.error("  devup ctl logs <svc> --follow");
+    console.error("  devup ctl restart <svc>");
+    process.exit(1);
+  }
   const isInteractive = process.stdin.isTTY ?? false;
   const { waitUntilExit } = render(
     React7.createElement(App, {