numux 1.26.0 → 2.0.1

package/README.md

@@ -40,7 +40,6 @@ export default defineConfig({
     migrate: {
       command: 'bun run migrate',
       dependsOn: ['db'],
-      persistent: false,
     },
     api: {
       command: 'bun run dev:api',
@@ -53,7 +52,6 @@ export default defineConfig({
     confirm: {
       command: 'sh -c "printf \'Deploy to staging? [y/n] \' && read answer && echo $answer"',
       interactive: true,
-      persistent: false,
     },
   },
 })
@@ -168,7 +166,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 (regardless of exit code) |
 | `--kill-others-on-fail` | Kill all processes when any exits with a non-zero exit code |
-| `--no-restart` | Disable auto-restart for crashed processes |
+| `--max-restarts <n>` | Max auto-restarts 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 |
@@ -199,8 +197,7 @@ 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`) |
-| `persistent` | `boolean` | Set to `false` to make all processes one-shot by default (default: `true`) |
-| `maxRestarts` | `number` | Restart limit for all processes (default: `Infinity`) |
+| `maxRestarts` | `number` | Restart limit for all processes (default: `0`) |
 | `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) |
@@ -232,8 +229,7 @@ Each process accepts:
 | `dependsOn` | `string[]` | — | Processes that must be ready first |
 | `readyPattern` | `string \| RegExp` | — | Regex matched against stdout to signal readiness. Use `RegExp` to capture groups (see below) |
 | `readyTimeout` | `number` | — | Milliseconds to wait for `readyPattern` before failing |
-| `persistent` | `boolean` | `true` | `false` for one-shot commands (exit 0 = ready) |
-| `maxRestarts` | `number` | `Infinity` | Max auto-restart attempts before giving up |
+| `maxRestarts` | `number` | `0` | Max auto-restart attempts on non-zero exit (0 = no restarts) |
 | `delay` | `number` | — | Milliseconds to wait before starting the process |
 | `condition` | `string` | — | Env var name; process skipped if falsy. Prefix with `!` to negate |
 | `platform` | `string \| string[]` | — | OS(es) this process runs on (e.g. `'darwin'`, `'linux'`). Non-matching processes are removed; dependents still start |
@@ -301,7 +297,6 @@ export default defineConfig({
   processes: {
     seed: {
       command: 'bun run seed',
-      persistent: false,
       condition: 'SEED_DB',    // only runs when SEED_DB is set and truthy
     },
     storybook: {
@@ -319,11 +314,10 @@ Falsy values: unset, empty string, `"0"`, `"false"`, `"no"`, `"off"` (case-insen
 Each process starts as soon as its declared `dependsOn` dependencies are ready — it does not wait for unrelated processes. If a process fails, its dependents are skipped.
 
 A process becomes **ready** when:
-- **persistent + readyPattern** — the pattern matches in stdout
-- **persistent + no readyPattern** — immediately after spawn
-- **non-persistent** — exits with code 0
+- **Has `readyPattern`** — the pattern matches in stdout (long-running server)
+- **No `readyPattern`** — exits with code 0 (one-shot task)
 
-Persistent processes that crash are auto-restarted with exponential backoff (1s–30s). Backoff resets after 10s of uptime.
+Processes that crash (non-zero exit) can be auto-restarted by setting `maxRestarts` (default: `0`). Restarts use exponential backoff (1s–30s), which resets after 10s of uptime.
 
 ### Dependency output capture
 

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.26.0",
+    version: "2.0.1",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -72,7 +72,8 @@ var require_package = __commonJS((exports, module) => {
       test: "bun test",
       typecheck: "bunx tsc --noEmit",
       lint: "biome check .",
-      fix: "biome check . --fix --unsafe"
+      fix: "biome check . --fix --unsafe",
+      prepare: "git config core.hooksPath .githooks"
     },
     files: [
       "dist/"
@@ -83,6 +84,8 @@ var require_package = __commonJS((exports, module) => {
     },
     devDependencies: {
       "@biomejs/biome": "^2.4.4",
+      "@commitlint/cli": "^20.4.2",
+      "@commitlint/config-conventional": "^20.4.2",
       "@types/bun": "^1.3.9"
     }
   };
@@ -201,10 +204,18 @@ var FLAGS = [
     description: "Kill all processes when any exits with non-zero code"
   },
   {
-    type: "boolean",
-    long: "--no-restart",
-    key: "noRestart",
-    description: "Disable auto-restart for crashed processes"
+    type: "value",
+    long: "--max-restarts",
+    key: "maxRestarts",
+    description: "Max auto-restarts for crashed processes",
+    valueName: "<n>",
+    completionHint: "none",
+    parse(raw, flag) {
+      const n = Number(raw);
+      if (!Number.isInteger(n) || n < 0)
+        throw new Error(`${flag} must be a non-negative integer, got "${raw}"`);
+      return n;
+    }
   },
   {
     type: "boolean",
@@ -350,7 +361,6 @@ function parseArgs(argv) {
     killOthers: false,
     killOthersOnFail: false,
     timestamps: false,
-    noRestart: false,
     noWatch: false,
     autoColors: false,
     configPath: undefined,
@@ -395,23 +405,31 @@ function parseArgs(argv) {
   }
   return result;
 }
+var RUNNERS = new Set(["npm", "npx", "yarn", "pnpm", "bun", "bunx"]);
+function deriveProcessName(cmd) {
+  const parts = cmd.split(/\s+/);
+  const first = parts[0].split("/").pop();
+  if (parts.length > 1 && RUNNERS.has(first)) {
+    return parts[parts.length - 1];
+  }
+  return first;
+}
 function buildConfigFromArgs(commands, named, options) {
   const processes = {};
-  const maxRestarts = options?.noRestart ? 0 : undefined;
   const colors = options?.colors;
   let colorIndex = 0;
   for (const { name, command } of named) {
     const color = colors?.[colorIndex++ % colors.length];
-    processes[name] = { command, persistent: true, maxRestarts, ...color ? { color } : {} };
+    processes[name] = { command, ...color ? { color } : {} };
   }
   for (let i = 0;i < commands.length; i++) {
     const cmd = commands[i];
-    let name = cmd.split(/\s+/)[0].split("/").pop();
+    let name = deriveProcessName(cmd);
     if (processes[name]) {
       name = `${name}-${i}`;
     }
     const color = colors?.[colorIndex++ % colors.length];
-    processes[name] = { command: cmd, persistent: true, maxRestarts, ...color ? { color } : {} };
+    processes[name] = { command: cmd, ...color ? { color } : {} };
   }
   return { processes };
 }
@@ -1035,7 +1053,7 @@ function buildProcessHexColorMap(names, config) {
 }
 
 // src/config/validator.ts
-function validateConfig(raw, warnings) {
+function validateConfig(raw, _warnings) {
   if (!raw || typeof raw !== "object") {
     throw new Error("Config must be an object");
   }
@@ -1053,7 +1071,6 @@ function validateConfig(raw, warnings) {
   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 globalPersistent = typeof config.persistent === "boolean" ? config.persistent : undefined;
   const globalStopSignal = validateStopSignal(config.stopSignal);
   const globalErrorMatcher = validateErrorMatcher("(global)", config.errorMatcher);
   const globalWatch = validateStringOrStringArray(config.watch);
@@ -1115,7 +1132,6 @@ function validateConfig(raw, warnings) {
         }
       }
     }
-    const persistent = typeof p.persistent === "boolean" ? p.persistent : globalPersistent ?? true;
     const readyPattern = p.readyPattern instanceof RegExp ? p.readyPattern : typeof p.readyPattern === "string" ? p.readyPattern : undefined;
     if (typeof readyPattern === "string") {
       try {
@@ -1126,12 +1142,6 @@ function validateConfig(raw, warnings) {
         });
       }
     }
-    if (readyPattern && !persistent) {
-      warnings?.push({
-        process: name,
-        message: "readyPattern is ignored on non-persistent processes (readiness is determined by exit code)"
-      });
-    }
     if (p.env && typeof p.env === "object") {
       for (const [k, v] of Object.entries(p.env)) {
         if (typeof v !== "string") {
@@ -1156,8 +1166,7 @@ function validateConfig(raw, warnings) {
       envFile: processEnvFile ?? globalEnvFile,
       dependsOn: Array.isArray(p.dependsOn) ? p.dependsOn : undefined,
       readyPattern,
-      persistent,
-      maxRestarts: processMaxRestarts ?? globalMaxRestarts,
+      maxRestarts: processMaxRestarts ?? globalMaxRestarts ?? 0,
       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,
@@ -1293,8 +1302,7 @@ function resolveWorkspaceProcesses(script, cwd) {
     usedNames.add(name);
     processes[name] = {
       command: `${pm} run ${script}`,
-      cwd: dir,
-      persistent: true
+      cwd: dir
     };
   }
   if (Object.keys(processes).length === 0) {
@@ -1467,12 +1475,11 @@ function extractCaptures(match) {
 function createReadinessChecker(config) {
   const shouldCapture = config.readyPattern instanceof RegExp;
   const pattern = config.readyPattern ? config.readyPattern instanceof RegExp ? config.readyPattern : new RegExp(config.readyPattern) : null;
-  const persistent = config.persistent !== false;
   let outputBuffer = "";
   let _captures = null;
   return {
     feedOutput(data) {
-      if (!(persistent && pattern))
+      if (!pattern)
         return false;
       outputBuffer += data;
       if (outputBuffer.length > BUFFER_CAP2) {
@@ -1491,11 +1498,8 @@ function createReadinessChecker(config) {
     get captures() {
       return _captures;
     },
-    get isImmediatelyReady() {
-      return persistent && !pattern;
-    },
     get dependsOnExit() {
-      return !persistent;
+      return !pattern;
     }
   };
 }
@@ -1585,10 +1589,7 @@ class ProcessRunner {
 `;
       this.handler.onOutput(encoder.encode(msg));
     }
-    this.handler.onStatus(this.config.persistent !== false ? "running" : "starting");
-    if (this.readiness.isImmediatelyReady) {
-      this.markReady();
-    }
+    this.handler.onStatus("running");
     this.startReadyTimeout(gen);
     this.proc.exited.then((code) => {
       if (this.generation !== gen)
@@ -1636,7 +1637,7 @@ class ProcessRunner {
   }
   startReadyTimeout(gen) {
     const timeout = this.config.readyTimeout;
-    if (!(timeout && this.config.readyPattern) || this.config.persistent === false)
+    if (!(timeout && this.config.readyPattern))
       return;
     this.readyTimer = setTimeout(() => {
       this.readyTimer = null;
@@ -1894,8 +1895,6 @@ class ProcessManager {
     if (this.stopping)
       return;
     const proc = this.config.processes[name];
-    if (proc.persistent === false)
-      return;
     if (exitCode === 0)
       return;
     if (exitCode === null)
@@ -1906,8 +1905,8 @@ class ProcessManager {
       this.restartAttempts.set(name, 0);
     }
     const attempt = this.restartAttempts.get(name) ?? 0;
-    const maxRestarts = proc.maxRestarts;
-    if (maxRestarts !== undefined && attempt >= maxRestarts) {
+    const maxRestarts = proc.maxRestarts ?? 0;
+    if (attempt >= maxRestarts) {
       log(`[${name}] Reached maxRestarts limit (${maxRestarts}), not restarting`);
       if (maxRestarts > 0) {
         const encoder2 = new TextEncoder;
@@ -1922,7 +1921,7 @@ class ProcessManager {
     this.restartAttempts.set(name, attempt + 1);
     const encoder = new TextEncoder;
     const msg = `\r
-\x1B[33m[numux] restarting in ${(delay / 1000).toFixed(0)}s (attempt ${attempt + 1}${maxRestarts !== undefined ? `/${maxRestarts}` : ""})...\x1B[0m\r
+\x1B[33m[numux] restarting in ${(delay / 1000).toFixed(0)}s (attempt ${attempt + 1}${Number.isFinite(maxRestarts) ? `/${maxRestarts}` : ""})...\x1B[0m\r
 `;
     this.emit({ type: "output", name, data: encoder.encode(msg) });
     const timer = setTimeout(() => {
@@ -1953,7 +1952,7 @@ class ProcessManager {
         const state = this.states.get(name);
         if (!state)
           return;
-        if (state.status === "pending" || state.status === "stopped" || state.status === "finished" || state.status === "stopping" || state.status === "skipped")
+        if (state.status === "pending" || state.status === "stopped" || state.status === "stopping" || state.status === "skipped")
           return;
         log(`[${name}] File changed: ${changedFile}, restarting`);
         const msg = `\r
@@ -2196,10 +2195,14 @@ function openLink(link) {
 }
 
 // src/ui/pane.ts
+var MAX_SCROLLBACK_LINES = 50000;
+var MAX_BUFFER_BYTES = 10 * 1024 * 1024;
+
 class Pane {
   scrollBox;
   terminal;
   decoder = new TextDecoder;
+  bytesFed = 0;
   _onScroll = null;
   _onCopy = null;
   _onLinkClick = null;
@@ -2247,6 +2250,11 @@ class Pane {
     this.scrollBox.add(this.terminal);
   }
   feed(data) {
+    this.bytesFed += data.length;
+    if (this.terminal.lineCount > MAX_SCROLLBACK_LINES || this.bytesFed > MAX_BUFFER_BYTES) {
+      this.terminal.reset();
+      this.bytesFed = 0;
+    }
     const text = this.decoder.decode(data, { stream: true });
     this.terminal.feed(text);
   }
@@ -2324,6 +2332,7 @@ class Pane {
   }
   clear() {
     this.terminal.reset();
+    this.bytesFed = 0;
   }
   destroy() {
     this.terminal.destroy();
@@ -3674,7 +3683,7 @@ async function main() {
           flags.push(`depends on: ${proc.dependsOn.join(", ")}`);
         if (proc.readyPattern)
           flags.push(`ready: /${proc.readyPattern}/`);
-        if (proc.persistent === false)
+        if (!proc.readyPattern)
           flags.push("one-shot");
         if (proc.delay)
           flags.push(`delay: ${proc.delay}ms`);
@@ -3739,7 +3748,7 @@ async function main() {
       }
       for (let i = 0;i < otherCommands.length; i++) {
         const cmd = otherCommands[i];
-        let name = cmd.split(/\s+/)[0].split("/").pop();
+        let name = deriveProcessName(cmd);
         if (processes[name])
           name = `${name}-${i}`;
         processes[name] = cmd;
@@ -3751,7 +3760,6 @@ async function main() {
       config = validateConfig(expanded, warnings);
     } else {
       config = buildConfigFromArgs(parsed.commands, parsed.named, {
-        noRestart: parsed.noRestart,
         colors: parsed.colors
       });
     }
@@ -3765,8 +3773,6 @@ async function main() {
             suffix++;
           finalName = `${finalName}-${suffix}`;
         }
-        if (parsed.noRestart)
-          proc.maxRestarts = 0;
         config.processes[finalName] = proc;
       }
     }
@@ -3774,11 +3780,6 @@ async function main() {
     const raw = expandScriptPatterns(await loadConfig(parsed.configPath));
     config = validateConfig(raw, warnings);
     config = filterByPlatform(config);
-    if (parsed.noRestart) {
-      for (const proc of Object.values(config.processes)) {
-        proc.maxRestarts = 0;
-      }
-    }
   }
   if (parsed.sort) {
     config.sort = parsed.sort;
@@ -3788,6 +3789,11 @@ async function main() {
       proc.envFile = parsed.envFile;
     }
   }
+  if (parsed.maxRestarts !== undefined) {
+    for (const proc of Object.values(config.processes)) {
+      proc.maxRestarts = parsed.maxRestarts;
+    }
+  }
   if (parsed.noWatch || config.noWatch) {
     for (const proc of Object.values(config.processes)) {
       delete proc.watch;
@@ -3809,11 +3815,6 @@ async function main() {
   printWarnings(warnings);
   const usePrefix = parsed.prefix || config.prefix;
   if (usePrefix) {
-    if (!parsed.noRestart) {
-      for (const proc of Object.values(config.processes)) {
-        proc.maxRestarts ??= 0;
-      }
-    }
     const display = new PrefixDisplay(manager, config, {
       logWriter,
       killOthers: parsed.killOthers || config.killOthers,

package/dist/types.d.ts

@@ -17,13 +17,8 @@ export interface NumuxProcessConfig<K extends string = string> {
     /** Regex matched against stdout to signal readiness. Use `RegExp` to capture groups for `$dep.group` expansion */
     readyPattern?: string | RegExp;
     /**
-     * Set to `false` for one-shot processes
-     * @default true
-     */
-    persistent?: boolean;
-    /**
-     * Limit auto-restart attempts
-     * @default Infinity
+     * Limit auto-restart attempts (only restarts on non-zero exit)
+     * @default 0
      */
     maxRestarts?: number;
     /** Milliseconds to wait for readyPattern before failing */
@@ -74,18 +69,12 @@ export interface NumuxConfig<K extends string = string> {
      */
     showCommand?: boolean;
     /**
-     * Global restart limit, inherited by all processes
-     * @default Infinity
+     * Global restart limit, inherited by all processes (only restarts on non-zero exit)
+     * @default 0
      */
     maxRestarts?: number;
     /** Global ready timeout (ms), inherited by all processes */
     readyTimeout?: number;
-    /**
-     * Set to `false` to make all processes non-persistent (one-shot) by default.
-     * Individual processes can still override with their own `persistent` value.
-     * @default true
-     */
-    persistent?: boolean;
     /**
      * Global stop signal, inherited by all processes
      * @default 'SIGTERM'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numux",
-  "version": "1.26.0",
+  "version": "2.0.1",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",
@@ -36,7 +36,8 @@
     "test": "bun test",
     "typecheck": "bunx tsc --noEmit",
     "lint": "biome check .",
-    "fix": "biome check . --fix --unsafe"
+    "fix": "biome check . --fix --unsafe",
+    "prepare": "git config core.hooksPath .githooks"
   },
   "files": [
     "dist/"
@@ -47,6 +48,8 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.4",
+    "@commitlint/cli": "^20.4.2",
+    "@commitlint/config-conventional": "^20.4.2",
     "@types/bun": "^1.3.9"
   }
 }