numux 2.16.0 → 2.16.2

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) |
@@ -277,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" "May 2026" "2.16.0" "numux manual"
+.TH "NUMUX" "1" "May 2026" "2.16.2" "numux manual"
 .SH "NAME"
 \fBnumux\fR
 .P
@@ -486,9 +486,9 @@ _
 T{
 \fBsort\fP
 T}|T{
-\fB'config' | 'alphabetical' | 'topological'\fP
+\fB'config' | 'alphabetical' | 'topological' | 'status'\fP
 T}|T{
-Tab display order\. \fB'config'\fP preserves definition order (package\.json script order for wildcards), \fB'alphabetical'\fP sorts by process name, \fB'topological'\fP sorts by dependency tiers\.
+Tab display order\. \fB'config'\fP preserves definition order (package\.json script order for wildcards), \fB'alphabetical'\fP sorts by process name, \fB'topological'\fP sorts by dependency tiers, \fB'status'\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) |
@@ -283,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) |
@@ -548,7 +548,7 @@ var init_help = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.16.0",
+    version: "2.16.2",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -738,7 +738,7 @@ var FLAGS = [
     short: "-s",
     key: "sort",
     description: "Tab display order",
-    valueName: "<config|alphabetical|topological>",
+    valueName: "<config|alphabetical|topological|status>",
     completionHint: "none"
   },
   {
@@ -1912,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)) {
@@ -3556,7 +3556,7 @@ function openLink(link) {
 }
 
 // src/ui/pane.ts
-var RENDER_LIMIT = 5000;
+var RENDER_LIMIT = 1500;
 var MAX_SCROLLBACK_LINES = 1e6;
 var MAX_BUFFER_BYTES = 500 * 1024 * 1024;
 
@@ -3570,6 +3570,9 @@ class Pane {
   _timestampFormat = null;
   lineTimestamps = [];
   lineCounter = 0;
+  signedLineCount = 0;
+  timestampUpdateTimer = null;
+  static TIMESTAMP_UPDATE_DEBOUNCE_MS = 32;
   _onScroll = null;
   _onCopy = null;
   _onLinkClick = null;
@@ -3630,6 +3633,8 @@ class Pane {
       this.bytesFed = 0;
       this.lineTimestamps = [];
       this.lineCounter = 0;
+      this.signedLineCount = 0;
+      this.timestampGutter?.clearAllLineSigns();
     }
     const now = Date.now();
     if (this.lineCounter === 0) {
@@ -3644,10 +3649,18 @@ class Pane {
     }
     const text = this.decoder.decode(data, { stream: true });
     this.terminal.feed(text);
-    if (this._timestampFormat) {
-      this.updateTimestampSigns();
+    if (this._timestampFormat && this.lineTimestamps.length !== this.signedLineCount) {
+      this.scheduleTimestampUpdate();
     }
   }
+  scheduleTimestampUpdate() {
+    if (this.timestampUpdateTimer)
+      return;
+    this.timestampUpdateTimer = setTimeout(() => {
+      this.timestampUpdateTimer = null;
+      this.updateTimestampSigns();
+    }, Pane.TIMESTAMP_UPDATE_DEBOUNCE_MS);
+  }
   resize(cols, rows) {
     this.terminal.cols = cols;
     this.terminal.rows = rows;
@@ -3725,6 +3738,11 @@ class Pane {
     this.bytesFed = 0;
     this.lineTimestamps = [];
     this.lineCounter = 0;
+    this.signedLineCount = 0;
+    if (this.timestampUpdateTimer) {
+      clearTimeout(this.timestampUpdateTimer);
+      this.timestampUpdateTimer = null;
+    }
     if (this._timestampFormat) {
       this.timestampGutter?.clearAllLineSigns();
     }
@@ -3736,6 +3754,11 @@ class Pane {
     if (wasEnabled === isEnabled && this._timestampFormat === newFormat)
       return;
     this._timestampFormat = newFormat;
+    if (this.timestampUpdateTimer) {
+      clearTimeout(this.timestampUpdateTimer);
+      this.timestampUpdateTimer = null;
+    }
+    this.signedLineCount = 0;
     if (isEnabled && !wasEnabled) {
       this.scrollBox.remove(this.terminal.id);
       const gutterWidth = (newFormat?.length ?? 8) + 1;
@@ -3775,8 +3798,14 @@ class Pane {
       signs.set(i, { before: formatTimestamp(new Date(this.lineTimestamps[i]), fmt) });
     }
     this.timestampGutter.setLineSigns(signs);
+    this.signedLineCount = this.lineTimestamps.length;
   }
   destroy() {
+    if (this.timestampUpdateTimer) {
+      clearTimeout(this.timestampUpdateTimer);
+      this.timestampUpdateTimer = null;
+    }
+    this.timestampGutter?.clearTarget();
     this.terminal.destroy();
   }
 }
@@ -4102,6 +4131,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}`;
 }
@@ -4115,11 +4149,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);
@@ -4209,12 +4238,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;
@@ -4284,17 +4315,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) {
@@ -4372,7 +4405,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",

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.16.0",
+  "version": "2.16.2",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",