numux 2.15.0 → 2.16.1

package/README.md

@@ -212,7 +212,7 @@ export default defineConfig({
 <!-- generated:options -->
 | Flag | Description |
 |------|-------------|
-| `-s,` `--sort` `<config|alphabetical|topological>` | Tab display order |
+| `-s,` `--sort` `<config|alphabetical|topological|status>` | Tab display order |
 | `-w,` `--workspace` `<script>` | Run a package.json script across all workspaces |
 | `-n,` `--name` `<name=command>` | Add a named process |
 | `-c,` `--color` `<colors>` | Comma-separated colors (hex or names: black, red, green, yellow, blue, magenta, cyan, white, gray, orange, purple) |
@@ -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
@@ -275,7 +277,7 @@ Top-level options apply to all processes (process-level settings override):
 | `stopSignal` | `'SIGTERM' \| 'SIGINT' \| 'SIGHUP'` | Global stop signal, inherited by all processes |
 | `errorMatcher` | `boolean \| string` | Global error matcher, inherited by all processes. `true` = detect ANSI red output, string = regex |
 | `watch` | `string \| string[]` | Global watch patterns, inherited by processes without their own watch |
-| `sort` | `'config' \| 'alphabetical' \| 'topological'` | Tab display order. `'config'` preserves definition order (package.json script order for wildcards), `'alphabetical'` sorts by process name, `'topological'` sorts by dependency tiers. |
+| `sort` | `'config' \| 'alphabetical' \| 'topological' \| 'status'` | Tab display order. `'config'` preserves definition order (package.json script order for wildcards), `'alphabetical'` sorts by process name, `'topological'` sorts by dependency tiers, `'status'` uses config order but moves finished/stopped/failed/skipped tabs to the bottom. |
 | `prefix` | `boolean` | Use prefixed output mode instead of TUI (for CI/scripts) |
 | `timestamps` | `boolean \| string` | Add timestamps to output lines. `true` uses default `HH:mm:ss.SSS` format, or pass a format string (e.g. `"HH:mm:ss"`) |
 | `killOthers` | `boolean` | Kill all processes when any one exits (regardless of exit code) |

package/dist/man/numux.1

@@ -1,4 +1,4 @@
-.TH "NUMUX" "1" "April 2026" "2.15.0" "numux manual"
+.TH "NUMUX" "1" "May 2026" "2.16.1" "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
@@ -484,9 +486,9 @@ _
 T{
 \fBsort\fP
 T}|T{
-\fB&#39;config&#39; | &#39;alphabetical&#39; | &#39;topological&#39;\fP
+\fB&#39;config&#39; | &#39;alphabetical&#39; | &#39;topological&#39; | &#39;status&#39;\fP
 T}|T{
-Tab display order\. \fB&#39;config&#39;\fP preserves definition order (package\.json script order for wildcards), \fB&#39;alphabetical&#39;\fP sorts by process name, \fB&#39;topological&#39;\fP sorts by dependency tiers\.
+Tab display order\. \fB&#39;config&#39;\fP preserves definition order (package\.json script order for wildcards), \fB&#39;alphabetical&#39;\fP sorts by process name, \fB&#39;topological&#39;\fP sorts by dependency tiers, \fB&#39;status&#39;\fP uses config order but moves finished/stopped/failed/skipped tabs to the bottom\.
 T}
 _
 T{

package/dist/numux.js

@@ -230,7 +230,7 @@ export default defineConfig({
     options: { title: "Options", body: `<!-- generated:options -->
 | Flag | Description |
 |------|-------------|
-| \`-s,\` \`--sort\` \`<config|alphabetical|topological>\` | Tab display order |
+| \`-s,\` \`--sort\` \`<config|alphabetical|topological|status>\` | Tab display order |
 | \`-w,\` \`--workspace\` \`<script>\` | Run a package.json script across all workspaces |
 | \`-n,\` \`--name\` \`<name=command>\` | Add a named process |
 | \`-c,\` \`--color\` \`<colors>\` | Comma-separated colors (hex or names: black, red, green, yellow, blue, magenta, cyan, white, gray, orange, purple) |
@@ -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
@@ -281,7 +283,7 @@ numux logs api | tail -f           # Follow process log output
 | \`stopSignal\` | \`'SIGTERM' \\| 'SIGINT' \\| 'SIGHUP'\` | Global stop signal, inherited by all processes |
 | \`errorMatcher\` | \`boolean \\| string\` | Global error matcher, inherited by all processes. \`true\` = detect ANSI red output, string = regex |
 | \`watch\` | \`string \\| string[]\` | Global watch patterns, inherited by processes without their own watch |
-| \`sort\` | \`'config' \\| 'alphabetical' \\| 'topological'\` | Tab display order. \`'config'\` preserves definition order (package.json script order for wildcards), \`'alphabetical'\` sorts by process name, \`'topological'\` sorts by dependency tiers. |
+| \`sort\` | \`'config' \\| 'alphabetical' \\| 'topological' \\| 'status'\` | Tab display order. \`'config'\` preserves definition order (package.json script order for wildcards), \`'alphabetical'\` sorts by process name, \`'topological'\` sorts by dependency tiers, \`'status'\` uses config order but moves finished/stopped/failed/skipped tabs to the bottom. |
 | \`prefix\` | \`boolean\` | Use prefixed output mode instead of TUI (for CI/scripts) |
 | \`timestamps\` | \`boolean \\| string\` | Add timestamps to output lines. \`true\` uses default \`HH:mm:ss.SSS\` format, or pass a format string (e.g. \`"HH:mm:ss"\`) |
 | \`killOthers\` | \`boolean\` | Kill all processes when any one exits (regardless of exit code) |
@@ -546,7 +548,7 @@ var init_help = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.15.0",
+    version: "2.16.1",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -736,7 +738,7 @@ var FLAGS = [
     short: "-s",
     key: "sort",
     description: "Tab display order",
-    valueName: "<config|alphabetical|topological>",
+    valueName: "<config|alphabetical|topological|status>",
     completionHint: "none"
   },
   {
@@ -1910,7 +1912,7 @@ function validateErrorMatcher(name, value) {
   }
   return;
 }
-var VALID_SORT_VALUES = new Set(["config", "alphabetical", "topological"]);
+var VALID_SORT_VALUES = new Set(["config", "alphabetical", "topological", "status"]);
 function validateSort(value) {
   if (typeof value === "string") {
     if (!VALID_SORT_VALUES.has(value)) {
@@ -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";
 
@@ -4053,6 +4102,11 @@ var STATUS_ICON_HEX = {
   skipped: "#888888"
 };
 var TERMINAL_STATUSES = new Set(["finished", "stopped", "failed", "skipped"]);
+function getDisplayOrder(originalNames, statuses) {
+  const active = originalNames.filter((n) => !TERMINAL_STATUSES.has(statuses.get(n)));
+  const terminal = originalNames.filter((n) => TERMINAL_STATUSES.has(statuses.get(n)));
+  return [...active, ...terminal];
+}
 function formatTab(name, status) {
   return `${STATUS_ICONS[status]} ${name}`;
 }
@@ -4066,11 +4120,6 @@ function formatDescription(status, exitCode, restartCount) {
   }
   return desc;
 }
-function getDisplayOrder(originalNames, statuses) {
-  const active = originalNames.filter((n) => !TERMINAL_STATUSES.has(statuses.get(n)));
-  const terminal = originalNames.filter((n) => TERMINAL_STATUSES.has(statuses.get(n)));
-  return [...active, ...terminal];
-}
 function resolveOptionColors(names, statuses, processColors, inputWaiting, erroredProcesses, searchMatchProcesses) {
   return names.map((name) => {
     const status = statuses.get(name);
@@ -4160,12 +4209,14 @@ class TabBar {
   statuses;
   baseDescriptions;
   processColors;
+  reorderByStatus;
   inputWaiting = new Set;
   erroredProcesses = new Set;
   searchMatchCounts = new Map;
-  constructor(renderer, names, colors) {
+  constructor(renderer, names, colors, reorderByStatus = false) {
     this.originalNames = names;
     this.names = [...names];
+    this.reorderByStatus = reorderByStatus;
     this.statuses = new Map(names.map((n) => [n, "pending"]));
     this.baseDescriptions = new Map(names.map((n) => [n, "pending"]));
     this.processColors = colors ?? new Map;
@@ -4235,17 +4286,19 @@ class TabBar {
     return this.names.length;
   }
   refreshOptions() {
-    const currentIdx = this.renderable.getSelectedIndex();
-    const currentName = this.names[currentIdx];
-    this.names = getDisplayOrder(this.originalNames, this.statuses);
+    if (this.reorderByStatus) {
+      const currentIdx = this.renderable.getSelectedIndex();
+      const currentName = this.names[currentIdx];
+      this.names = getDisplayOrder(this.originalNames, this.statuses);
+      const newIdx = this.names.indexOf(currentName);
+      if (newIdx >= 0 && newIdx !== currentIdx) {
+        this.renderable.setSelectedIndex(newIdx);
+      }
+    }
     this.renderable.options = this.names.map((n) => ({
       name: formatTab(n, this.statuses.get(n)),
       description: this.getDescription(n)
     }));
-    const newIdx = this.names.indexOf(currentName);
-    if (newIdx >= 0 && newIdx !== currentIdx) {
-      this.renderable.setSelectedIndex(newIdx);
-    }
     this.updateOptionColors();
   }
   getDescription(name) {
@@ -4274,9 +4327,6 @@ class TabBar {
   setSelectedIndex(index) {
     this.renderable.setSelectedIndex(index);
   }
-  focus() {
-    this.renderable.focus();
-  }
 }
 
 // src/ui/app.ts
@@ -4326,7 +4376,7 @@ class App {
       border: false
     });
     const processHexColors = buildProcessHexColorMap(this.names, this.config);
-    this.tabBar = new TabBar(this.renderer, this.names, processHexColors);
+    this.tabBar = new TabBar(this.renderer, this.names, processHexColors, this.config.sort === "status");
     const contentRow = new BoxRenderable3(this.renderer, {
       id: "content-row",
       flexDirection: "row",
@@ -4433,7 +4483,7 @@ class App {
           return;
         }
         this.shutdown().then(() => {
-          process.exit(this.hasFailures() ? 1 : 0);
+          finalizeShutdown(this.logWriter, this.hasFailures() ? 1 : 0);
         });
         return;
       }
@@ -4569,7 +4619,6 @@ class App {
     });
     if (this.names.length > 0) {
       this.switchPane(this.names[0]);
-      this.tabBar.focus();
     }
     await this.manager.startAll(termCols, termRows);
   }
@@ -5155,46 +5204,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 +5259,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 +5465,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/dist/types.d.ts

@@ -93,7 +93,8 @@ export interface NumuxConfig<K extends string = string> {
     watch?: string | string[];
     /**
      * Tab display order. `'config'` preserves definition order (package.json script order for wildcards),
-     * `'alphabetical'` sorts by process name, `'topological'` sorts by dependency tiers.
+     * `'alphabetical'` sorts by process name, `'topological'` sorts by dependency tiers,
+     * `'status'` uses config order but moves finished/stopped/failed/skipped tabs to the bottom.
      * @default 'config'
      */
     sort?: SortOrder;
@@ -123,7 +124,7 @@ export interface NumuxConfig<K extends string = string> {
     logDir?: string;
     processes: Record<K, NumuxProcessConfig<K> | NumuxScriptPattern<K> | string | true>;
 }
-export type SortOrder = 'config' | 'alphabetical' | 'topological';
+export type SortOrder = 'config' | 'alphabetical' | 'topological' | 'status';
 /** Process config after validation — dependsOn is always normalized to an array */
 export interface ResolvedProcessConfig extends Omit<NumuxProcessConfig, 'dependsOn' | 'workspaces'> {
     dependsOn?: string[];

package/package.json

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