numux 2.14.1 → 2.16.0

package/README.md

@@ -245,7 +245,9 @@ Auto-exits when all processes finish. Exit code 1 if any process failed.
 
 ## Logging
 
-numux writes per-process log files (ANSI-stripped) when `--log-dir` is set or `logDir` is configured. Each session creates a timestamped subdirectory with a `latest` symlink pointing to the most recent run.
+numux writes per-process log files (ANSI-stripped) for every run. By default they go to `<tmpdir>/numux/<project-name>/`, or to `--log-dir` / the `logDir` config when set. Each session creates a timestamped subdirectory with a `latest` symlink pointing to the most recent run.
+
+The TUI prints `Logs saved to: <session-dir>` on exit (Ctrl+C or signal). Multiple numux instances in the same project share the default base dir, so each session has its own timestamped folder but the `latest` symlink will point at whichever started most recently. If `numux logs` falls back to the default and a `latest` symlink is in use, it prints a warning. To avoid the collision, set `logDir` per config or pass `--log-dir`.
 
 <!-- generated:logging-usage -->
 ```sh

package/dist/man/numux.1

@@ -1,4 +1,4 @@
-.TH "NUMUX" "1" "April 2026" "2.14.1" "numux manual"
+.TH "NUMUX" "1" "May 2026" "2.16.0" "numux manual"
 .SH "NAME"
 \fBnumux\fR
 .P
@@ -380,7 +380,9 @@ numux \-\-prefix
 Auto\-exits when all processes finish\. Exit code 1 if any process failed\.
 .SH Logging
 .P
-numux writes per\-process log files (ANSI\-stripped) when \fB\-\-log\-dir\fP is set or \fBlogDir\fP is configured\. Each session creates a timestamped subdirectory with a \fBlatest\fP symlink pointing to the most recent run\.
+numux writes per\-process log files (ANSI\-stripped) for every run\. By default they go to \fB<tmpdir>/numux/<project\-name>/\fP, or to \fB\-\-log\-dir\fP / the \fBlogDir\fP config when set\. Each session creates a timestamped subdirectory with a \fBlatest\fP symlink pointing to the most recent run\.
+.P
+The TUI prints \fBLogs saved to: <session\-dir>\fP on exit (Ctrl+C or signal)\. Multiple numux instances in the same project share the default base dir, so each session has its own timestamped folder but the \fBlatest\fP symlink will point at whichever started most recently\. If \fBnumux logs\fP falls back to the default and a \fBlatest\fP symlink is in use, it prints a warning\. To avoid the collision, set \fBlogDir\fP per config or pass \fB\-\-log\-dir\fP\|\.
 <!\-\- generated:logging\-usage \-\->
 .RS 2
 .nf

package/dist/numux.js

@@ -257,7 +257,9 @@ numux --prefix
 \`\`\`
 
 Auto-exits when all processes finish. Exit code 1 if any process failed.` },
-    logging: { title: "Logging", body: `numux writes per-process log files (ANSI-stripped) when \`--log-dir\` is set or \`logDir\` is configured. Each session creates a timestamped subdirectory with a \`latest\` symlink pointing to the most recent run.
+    logging: { title: "Logging", body: `numux writes per-process log files (ANSI-stripped) for every run. By default they go to \`<tmpdir>/numux/<project-name>/\`, or to \`--log-dir\` / the \`logDir\` config when set. Each session creates a timestamped subdirectory with a \`latest\` symlink pointing to the most recent run.
+
+The TUI prints \`Logs saved to: <session-dir>\` on exit (Ctrl+C or signal). Multiple numux instances in the same project share the default base dir, so each session has its own timestamped folder but the \`latest\` symlink will point at whichever started most recently. If \`numux logs\` falls back to the default and a \`latest\` symlink is in use, it prints a warning. To avoid the collision, set \`logDir\` per config or pass \`--log-dir\`.
 
 <!-- generated:logging-usage -->
 \`\`\`sh
@@ -546,7 +548,7 @@ var init_help = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.14.1",
+    version: "2.16.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -2900,6 +2902,53 @@ function evaluateCondition(condition) {
 // src/ui/app.ts
 import { BoxRenderable as BoxRenderable3, createCliRenderer } from "@opentui/core";
 
+// src/utils/shutdown.ts
+var finalized = false;
+function finalizeShutdown(logWriter, exitCode) {
+  if (finalized)
+    process.exit(exitCode);
+  finalized = true;
+  if (logWriter && !logWriter.isTemporary) {
+    process.stderr.write(`Logs saved to: ${logWriter.getDirectory()}
+`);
+  }
+  logWriter?.cleanup();
+  process.exit(exitCode);
+}
+function setupShutdownHandlers(app, logWriter) {
+  let shuttingDown = false;
+  const shutdown = () => {
+    if (shuttingDown) {
+      process.exit(1);
+    }
+    shuttingDown = true;
+    app.shutdown().finally(() => {
+      finalizeShutdown(logWriter, app.hasFailures() ? 1 : 0);
+    });
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+  process.on("uncaughtException", (err) => {
+    log("Uncaught exception:", err?.message ?? err);
+    app.shutdown().finally(() => {
+      process.stderr.write(`numux: unexpected error: ${err?.stack ?? err}
+`);
+      logWriter?.cleanup();
+      process.exit(1);
+    });
+  });
+  process.on("unhandledRejection", (reason) => {
+    const stack = reason instanceof Error ? reason.stack : String(reason);
+    log("Unhandled rejection:", stack);
+    app.shutdown().finally(() => {
+      process.stderr.write(`numux: unhandled rejection: ${stack}
+`);
+      logWriter?.cleanup();
+      process.exit(1);
+    });
+  });
+}
+
 // src/ui/help-overlay.ts
 import { BoxRenderable, TextRenderable } from "@opentui/core";
 
@@ -2921,7 +2970,7 @@ function toHintPair(hint) {
 }
 var STATUS_HINTS_COMPACT = [
   ["\u2190\u2192", "tabs"],
-  SHORTCUTS.search,
+  SHORTCUTS.stopStart,
   SHORTCUTS.copy,
   ["Enter", "input"],
   ["H", "help"]
@@ -4274,9 +4323,6 @@ class TabBar {
   setSelectedIndex(index) {
     this.renderable.setSelectedIndex(index);
   }
-  focus() {
-    this.renderable.focus();
-  }
 }
 
 // src/ui/app.ts
@@ -4433,7 +4479,7 @@ class App {
           return;
         }
         this.shutdown().then(() => {
-          process.exit(this.hasFailures() ? 1 : 0);
+          finalizeShutdown(this.logWriter, this.hasFailures() ? 1 : 0);
         });
         return;
       }
@@ -4569,7 +4615,6 @@ class App {
     });
     if (this.names.length > 0) {
       this.switchPane(this.names[0]);
-      this.tabBar.focus();
     }
     await this.manager.startAll(termCols, termRows);
   }
@@ -5155,46 +5200,6 @@ function defaultLogDir(cwd) {
   return join2(tmpdir2(), "numux", resolveProjectName(cwd));
 }
 
-// src/utils/shutdown.ts
-function setupShutdownHandlers(app, logWriter) {
-  let shuttingDown = false;
-  const shutdown = () => {
-    if (shuttingDown) {
-      process.exit(1);
-    }
-    shuttingDown = true;
-    app.shutdown().finally(() => {
-      if (logWriter && !logWriter.isTemporary) {
-        process.stderr.write(`Logs saved to: ${logWriter.getDirectory()}
-`);
-      }
-      logWriter?.cleanup();
-      process.exit(app.hasFailures() ? 1 : 0);
-    });
-  };
-  process.on("SIGINT", shutdown);
-  process.on("SIGTERM", shutdown);
-  process.on("uncaughtException", (err) => {
-    log("Uncaught exception:", err?.message ?? err);
-    app.shutdown().finally(() => {
-      process.stderr.write(`numux: unexpected error: ${err?.stack ?? err}
-`);
-      logWriter?.cleanup();
-      process.exit(1);
-    });
-  });
-  process.on("unhandledRejection", (reason) => {
-    const stack = reason instanceof Error ? reason.stack : String(reason);
-    log("Unhandled rejection:", stack);
-    app.shutdown().finally(() => {
-      process.stderr.write(`numux: unhandled rejection: ${stack}
-`);
-      logWriter?.cleanup();
-      process.exit(1);
-    });
-  });
-}
-
 // src/index.ts
 var HELP = generateHelp();
 var INIT_TEMPLATE = `import { defineConfig } from 'numux'
@@ -5250,9 +5255,14 @@ async function main() {
     process.exit(0);
   }
   if (parsed.logs) {
-    const logDir2 = parsed.logDir ?? await resolveLogDir(parsed.configPath);
+    const resolved = parsed.logDir ? { dir: parsed.logDir, explicit: true } : await resolveLogDir(parsed.configPath);
+    const logDir2 = resolved.dir;
     const latestDir = resolve8(logDir2, "latest");
-    const target = existsSync6(latestDir) ? latestDir : logDir2;
+    const usingLatest = existsSync6(latestDir);
+    const target = usingLatest ? latestDir : logDir2;
+    if (!resolved.explicit && usingLatest) {
+      console.warn('Warning: using default log directory; "latest" may have been overwritten by another numux instance in this project.');
+    }
     if (parsed.logsProcess) {
       const logFile2 = resolve8(target, `${parsed.logsProcess}.log`);
       if (!existsSync6(logFile2)) {
@@ -5451,10 +5461,10 @@ async function resolveLogDir(configPath) {
   try {
     const raw = await loadConfig(configPath);
     if (typeof raw.logDir === "string" && raw.logDir.trim()) {
-      return resolve8(raw.logDir.trim());
+      return { dir: resolve8(raw.logDir.trim()), explicit: true };
     }
   } catch {}
-  return defaultLogDir(process.cwd());
+  return { dir: defaultLogDir(process.cwd()), explicit: false };
 }
 main().catch((err) => {
   console.error(err instanceof Error ? err.message : err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numux",
-  "version": "2.14.1",
+  "version": "2.16.0",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",