numux 1.20.0 → 1.22.0

package/README.md

@@ -164,6 +164,7 @@ Template properties (color, env, dependsOn, etc.) are inherited by all matched p
 | `--exclude <a,b,...>` | Exclude these processes |
 | `--kill-others` | Kill all processes when any exits |
 | `--no-restart` | Disable auto-restart for crashed processes |
+| `-s, --sort <mode>` | Tab display order: `config` (default), `alphabetical`, `topological` |
 | `--no-watch` | Disable file watching even if config has `watch` patterns |
 | `-t, --timestamps` | Add `[HH:MM:SS]` timestamps to prefixed output |
 | `--log-dir <path>` | Write per-process output to `<path>/<name>.log` |
@@ -193,6 +194,12 @@ Top-level options apply to all processes (process-level settings override):
 | `env` | `Record<string, string>` | Environment variables merged into all processes (process `env` overrides per key) |
 | `envFile` | `string \| string[] \| false` | `.env` file(s) for all processes (process `envFile` replaces if set; `false` disables) |
 | `showCommand` | `boolean` | Print the command being run as the first line of output (default: `true`) |
+| `maxRestarts` | `number` | Restart limit for all processes (default: `Infinity`) |
+| `readyTimeout` | `number` | Ready timeout in ms for all processes |
+| `stopSignal` | `'SIGTERM' \| 'SIGINT' \| 'SIGHUP'` | Stop signal for all processes (default: `'SIGTERM'`) |
+| `errorMatcher` | `boolean \| string` | Error detection for all processes (`true` = ANSI red, string = regex) |
+| `watch` | `string \| string[]` | Watch patterns for all processes (process `watch` replaces if set) |
+| `sort` | `'config' \| 'alphabetical' \| 'topological'` | Tab display order (default: `'config'` — definition order) |
 
 ```ts
 export default defineConfig({

package/dist/numux.js

@@ -36,7 +36,7 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "1.20.0",
+    version: "1.22.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -95,6 +95,15 @@ import { resolve as resolve8 } from "path";
 // src/cli-flags.ts
 var commaSplit = (raw) => raw.split(",").map((s) => s.trim()).filter(Boolean);
 var FLAGS = [
+  {
+    type: "value",
+    long: "--sort",
+    short: "-s",
+    key: "sort",
+    description: "Tab display order",
+    valueName: "<config|alphabetical|topological>",
+    completionHint: "none"
+  },
   {
     type: "value",
     long: "--workspace",
@@ -1035,6 +1044,11 @@ function validateConfig(raw, warnings) {
   const globalCwd = typeof config.cwd === "string" ? config.cwd : undefined;
   const globalShowCommand = typeof config.showCommand === "boolean" ? config.showCommand : undefined;
   const globalEnvFile = validateEnvFile(config.envFile);
+  const globalMaxRestarts = typeof config.maxRestarts === "number" && config.maxRestarts >= 0 ? config.maxRestarts : undefined;
+  const globalReadyTimeout = typeof config.readyTimeout === "number" && config.readyTimeout > 0 ? config.readyTimeout : undefined;
+  const globalStopSignal = validateStopSignal(config.stopSignal);
+  const globalErrorMatcher = validateErrorMatcher("(global)", config.errorMatcher);
+  const globalWatch = validateStringOrStringArray(config.watch);
   let globalEnv;
   if (config.env && typeof config.env === "object") {
     for (const [k, v] of Object.entries(config.env)) {
@@ -1044,6 +1058,7 @@ function validateConfig(raw, warnings) {
     }
     globalEnv = config.env;
   }
+  const sort = validateSort(config.sort);
   const validated = {};
   for (const name of names) {
     let proc = processes[name];
@@ -1115,6 +1130,11 @@ function validateConfig(raw, warnings) {
     const processEnvFile = validateEnvFile(p.envFile);
     const showCommand = typeof p.showCommand === "boolean" ? p.showCommand : globalShowCommand ?? true;
     const platform = validatePlatform(name, p.platform);
+    const processMaxRestarts = typeof p.maxRestarts === "number" && p.maxRestarts >= 0 ? p.maxRestarts : undefined;
+    const processReadyTimeout = typeof p.readyTimeout === "number" && p.readyTimeout > 0 ? p.readyTimeout : undefined;
+    const processStopSignal = validateStopSignal(p.stopSignal);
+    const processErrorMatcher = validateErrorMatcher(name, p.errorMatcher);
+    const processWatch = validateStringOrStringArray(p.watch);
     validated[name] = {
       command: p.command,
       cwd: processCwd ?? globalCwd,
@@ -1123,20 +1143,20 @@ function validateConfig(raw, warnings) {
       dependsOn: Array.isArray(p.dependsOn) ? p.dependsOn : undefined,
       readyPattern,
       persistent,
-      maxRestarts: typeof p.maxRestarts === "number" && p.maxRestarts >= 0 ? p.maxRestarts : undefined,
-      readyTimeout: typeof p.readyTimeout === "number" && p.readyTimeout > 0 ? p.readyTimeout : undefined,
+      maxRestarts: processMaxRestarts ?? globalMaxRestarts,
+      readyTimeout: processReadyTimeout ?? globalReadyTimeout,
       delay: typeof p.delay === "number" && p.delay > 0 ? p.delay : undefined,
       condition: typeof p.condition === "string" && p.condition.trim() ? p.condition.trim() : undefined,
       platform,
-      stopSignal: validateStopSignal(p.stopSignal),
+      stopSignal: processStopSignal ?? globalStopSignal,
       color: typeof p.color === "string" ? p.color : Array.isArray(p.color) ? p.color : undefined,
-      watch: validateStringOrStringArray(p.watch),
+      watch: processWatch ?? globalWatch,
       interactive: typeof p.interactive === "boolean" ? p.interactive : false,
-      errorMatcher: validateErrorMatcher(name, p.errorMatcher),
+      errorMatcher: processErrorMatcher ?? globalErrorMatcher,
       showCommand
     };
   }
-  return { processes: validated };
+  return { ...sort ? { sort } : {}, processes: validated };
 }
 function validateStringOrStringArray(value) {
   if (typeof value === "string")
@@ -1166,6 +1186,16 @@ function validateErrorMatcher(name, value) {
   }
   return;
 }
+var VALID_SORT_VALUES = new Set(["config", "alphabetical", "topological"]);
+function validateSort(value) {
+  if (typeof value === "string") {
+    if (!VALID_SORT_VALUES.has(value)) {
+      throw new Error(`sort must be one of: ${[...VALID_SORT_VALUES].join(", ")}. Got "${value}"`);
+    }
+    return value;
+  }
+  return;
+}
 var VALID_PLATFORMS = new Set(["aix", "darwin", "freebsd", "linux", "openbsd", "sunos", "win32"]);
 function validatePlatform(name, value) {
   const arr = validateStringOrStringArray(value);
@@ -1733,7 +1763,14 @@ class ProcessManager {
     return [...this.states.values()];
   }
   getProcessNames() {
-    return this.tiers.flat();
+    switch (this.config.sort) {
+      case "alphabetical":
+        return Object.keys(this.config.processes).sort();
+      case "topological":
+        return this.tiers.flat();
+      default:
+        return Object.keys(this.config.processes);
+    }
   }
   async startAll(cols, rows) {
     log("Starting all processes");
@@ -3469,6 +3506,9 @@ async function main() {
       }
     }
   }
+  if (parsed.sort) {
+    config.sort = parsed.sort;
+  }
   if (parsed.envFile !== undefined) {
     for (const proc of Object.values(config.processes)) {
       proc.envFile = parsed.envFile;

package/dist/types.d.ts

@@ -72,14 +72,38 @@ export interface NumuxConfig<K extends string = string> {
      * @default true
      */
     showCommand?: boolean;
+    /**
+     * Global restart limit, inherited by all processes
+     * @default Infinity
+     */
+    maxRestarts?: number;
+    /** Global ready timeout (ms), inherited by all processes */
+    readyTimeout?: number;
+    /**
+     * Global stop signal, inherited by all processes
+     * @default 'SIGTERM'
+     */
+    stopSignal?: 'SIGTERM' | 'SIGINT' | 'SIGHUP';
+    /** Global error matcher, inherited by all processes. `true` = detect ANSI red output, string = regex */
+    errorMatcher?: boolean | string;
+    /** Global watch patterns, inherited by processes without their own watch */
+    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.
+     * @default 'config'
+     */
+    sort?: SortOrder;
     processes: Record<K, NumuxProcessConfig<K> | NumuxScriptPattern<K> | string>;
 }
+export type SortOrder = 'config' | 'alphabetical' | 'topological';
 /** Process config after validation — dependsOn is always normalized to an array */
 export interface ResolvedProcessConfig extends Omit<NumuxProcessConfig, 'dependsOn'> {
     dependsOn?: string[];
 }
 /** Validated config with all shorthand expanded to full objects */
 export interface ResolvedNumuxConfig {
+    sort?: SortOrder;
     processes: Record<string, ResolvedProcessConfig>;
 }
 export type ProcessStatus = 'pending' | 'starting' | 'ready' | 'running' | 'stopping' | 'stopped' | 'finished' | 'failed' | 'skipped';

package/package.json

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