numux 1.14.1 → 1.15.1

package/README.md

@@ -216,7 +216,7 @@ Each process accepts:
 | `env` | `Record<string, string>` | — | Extra environment variables |
 | `envFile` | `string \| string[]` | — | `.env` file path(s) to load (relative to `cwd`) |
 | `dependsOn` | `string[]` | — | Processes that must be ready first |
-| `readyPattern` | `string` | — | Regex matched against stdout to signal readiness |
+| `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 |
@@ -309,6 +309,29 @@ A process becomes **ready** when:
 
 Persistent processes that crash are auto-restarted with exponential backoff (1s–30s). Backoff resets after 10s of uptime.
 
+### Dependency output capture
+
+When `readyPattern` is a `RegExp` (not a string), capture groups are extracted on match and expanded into dependent process commands using `$process.group` syntax:
+
+```ts
+export default defineConfig({
+  processes: {
+    db: {
+      command: 'docker compose up postgres',
+      readyPattern: /ready to accept connections on port (?<port>\d+)/,
+    },
+    api: {
+      command: 'node server.js --db-port $db.port',
+      dependsOn: ['db'],
+    },
+  },
+})
+```
+
+Both named (`$db.port`) and positional (`$db.1`) references work. Named groups also populate positional slots, so `$db.port` and `$db.1` both resolve to the same value above.
+
+Unmatched references are left as-is (the shell will expand `$db` as empty + `.port` literal, making the issue visible). String `readyPattern` values work as before — readiness detection only, no capture extraction.
+
 ## Keybindings
 
 Keybindings are shown in the status bar at the bottom of the app. Panes are readonly by default — keyboard input is not forwarded to processes. Set `interactive: true` on processes that need stdin (REPLs, shells, etc.).
@@ -330,7 +353,7 @@ Keybindings are shown in the status bar at the bottom of the app. Panes are read
 
 ### ghostty-opentui
 
-Despite the name, [`ghostty-opentui`](https://github.com/user/ghostty-opentui) is **not** a compatibility layer for the [Ghostty](https://ghostty.org) terminal. It uses Ghostty's Zig-based VT parser as the ANSI terminal emulation engine for OpenTUI's terminal renderable. It works in any terminal emulator (iTerm, Kitty, Alacritty, WezTerm, etc.) and adds ~8MB to install size due to native binaries.
+Despite the name, [`ghostty-opentui`](https://github.com/remorses/ghostty-opentui) is **not** a compatibility layer for the [Ghostty](https://ghostty.org) terminal. It uses Ghostty's Zig-based VT parser as the ANSI terminal emulation engine for OpenTUI's terminal renderable. It works in any terminal emulator (iTerm, Kitty, Alacritty, WezTerm, etc.) and adds ~8MB to install size due to native binaries.
 
 ## License
 

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.14.1",
+    version: "1.15.1",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -755,6 +755,9 @@ function interpolateValue(value) {
   if (Array.isArray(value)) {
     return value.map(interpolateValue);
   }
+  if (value instanceof RegExp) {
+    return value;
+  }
   if (value && typeof value === "object") {
     const result = {};
     for (const [k, v] of Object.entries(value)) {
@@ -1046,7 +1049,16 @@ function validateConfig(raw, warnings) {
       }
     }
     const persistent = typeof p.persistent === "boolean" ? p.persistent : true;
-    const readyPattern = typeof p.readyPattern === "string" ? p.readyPattern : undefined;
+    const readyPattern = p.readyPattern instanceof RegExp ? p.readyPattern : typeof p.readyPattern === "string" ? p.readyPattern : undefined;
+    if (typeof readyPattern === "string") {
+      try {
+        new RegExp(readyPattern);
+      } catch (err) {
+        throw new Error(`Process "${name}".readyPattern is not a valid regex: "${readyPattern}"`, {
+          cause: err
+        });
+      }
+    }
     if (readyPattern && !persistent) {
       warnings?.push({
         process: name,
@@ -1327,10 +1339,31 @@ function createErrorChecker(config) {
 
 // src/process/ready.ts
 var BUFFER_CAP2 = 65536;
+function extractCaptures(match) {
+  const result = {};
+  let hasCaptures = false;
+  if (match.groups) {
+    for (const [key, value] of Object.entries(match.groups)) {
+      if (value !== undefined) {
+        result[key] = value;
+        hasCaptures = true;
+      }
+    }
+  }
+  for (let i = 1;i < match.length; i++) {
+    if (match[i] !== undefined) {
+      result[String(i)] = match[i];
+      hasCaptures = true;
+    }
+  }
+  return hasCaptures ? result : null;
+}
 function createReadinessChecker(config) {
-  const pattern = config.readyPattern ? new RegExp(config.readyPattern) : null;
+  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))
@@ -1339,7 +1372,18 @@ function createReadinessChecker(config) {
       if (outputBuffer.length > BUFFER_CAP2) {
         outputBuffer = outputBuffer.slice(-BUFFER_CAP2);
       }
-      return pattern.test(outputBuffer);
+      const clean = stripAnsi(outputBuffer);
+      if (!shouldCapture)
+        return pattern.test(clean);
+      const match = pattern.exec(clean);
+      if (match) {
+        _captures = extractCaptures(match);
+        return true;
+      }
+      return false;
+    },
+    get captures() {
+      return _captures;
     },
     get isImmediatelyReady() {
       return persistent && !pattern;
@@ -1366,6 +1410,7 @@ class ProcessRunner {
   readyTimer = null;
   restarting = false;
   readyTimedOut = false;
+  commandOverride;
   constructor(name, config, handler) {
     this.name = name;
     this.config = config;
@@ -1379,10 +1424,13 @@ class ProcessRunner {
   get signal() {
     return this.config.stopSignal ?? "SIGTERM";
   }
-  start(cols, rows) {
+  start(cols, rows, commandOverride) {
+    if (commandOverride !== undefined)
+      this.commandOverride = commandOverride;
+    const command = this.commandOverride ?? this.config.command;
     const gen = ++this.generation;
     this.stopping = false;
-    log(`[${this.name}] Starting (gen ${gen}): ${this.config.command}`);
+    log(`[${this.name}] Starting (gen ${gen}): ${command}`);
     this.handler.onStatus("starting");
     const cwd = this.config.cwd ? resolve6(this.config.cwd) : process.cwd();
     try {
@@ -1395,7 +1443,7 @@ class ProcessRunner {
         ...envFromFile,
         ...this.config.env
       };
-      this.proc = Bun.spawn(["sh", "-c", this.config.command], {
+      this.proc = Bun.spawn(["sh", "-c", command], {
         cwd,
         env,
         terminal: {
@@ -1423,7 +1471,7 @@ class ProcessRunner {
     }
     if (this.config.showCommand !== false) {
       const encoder = new TextEncoder;
-      const msg = `\x1B[2m$ ${this.config.command}\x1B[0m\r
+      const msg = `\x1B[2m$ ${command}\x1B[0m\r
 \r
 `;
       this.handler.onOutput(encoder.encode(msg));
@@ -1509,9 +1557,9 @@ class ProcessRunner {
     this.clearReadyTimeout();
     log(`[${this.name}] Ready`);
     this.handler.onStatus("ready");
-    this.handler.onReady();
+    this.handler.onReady(this.readiness.captures);
   }
-  async restart(cols, rows) {
+  async restart(cols, rows, commandOverride) {
     if (this.restarting)
       return;
     this.restarting = true;
@@ -1536,7 +1584,7 @@ class ProcessRunner {
     this.readyTimedOut = false;
     this.readiness = createReadinessChecker(this.config);
     this.errorChecker = createErrorChecker(this.config);
-    this.start(cols, rows);
+    this.start(cols, rows, commandOverride);
   }
   async stop(timeoutMs = 5000) {
     if (!this.proc)
@@ -1598,6 +1646,7 @@ class ProcessManager {
   restartTimers = new Map;
   startTimes = new Map;
   pendingReadyResolvers = new Map;
+  readyCaptures = new Map;
   fileWatcher;
   constructor(config) {
     this.config = config;
@@ -1669,6 +1718,7 @@ class ProcessManager {
     this.setupWatchers();
   }
   startProcess(name, cols, rows) {
+    const commandOverride = this.expandDependencyCaptures(name);
     const delay = this.config.processes[name].delay;
     if (delay) {
       log(`[${name}] Delaying start by ${delay}ms`);
@@ -1677,12 +1727,12 @@ class ProcessManager {
         if (this.stopping)
           return;
         this.startTimes.set(name, Date.now());
-        this.runners.get(name).start(cols, rows);
+        this.runners.get(name).start(cols, rows, commandOverride);
       }, delay);
       this.restartTimers.set(name, timer);
     } else {
       this.startTimes.set(name, Date.now());
-      this.runners.get(name).start(cols, rows);
+      this.runners.get(name).start(cols, rows, commandOverride);
     }
   }
   createRunner(name, onInitialReady) {
@@ -1700,7 +1750,10 @@ class ProcessManager {
         }
         this.scheduleAutoRestart(name, code);
       },
-      onReady: () => {
+      onReady: (captures) => {
+        if (captures) {
+          this.readyCaptures.set(name, captures);
+        }
         if (!readyResolved) {
           readyResolved = true;
           onInitialReady();
@@ -1784,6 +1837,32 @@ class ProcessManager {
       });
     }
   }
+  expandDependencyCaptures(name) {
+    const proc = this.config.processes[name];
+    const deps = proc.dependsOn;
+    if (!deps?.length)
+      return;
+    const allCaptures = new Map;
+    for (const dep of deps) {
+      const captures = this.readyCaptures.get(dep);
+      if (captures)
+        allCaptures.set(dep, captures);
+    }
+    if (allCaptures.size === 0)
+      return;
+    const depNames = [...allCaptures.keys()].map((n) => escapeRegExp(n)).join("|");
+    const refPattern = new RegExp(`\\$(${depNames})\\.(\\w+)`, "g");
+    let hadReplacement = false;
+    const expanded = proc.command.replace(refPattern, (match, dep, key) => {
+      const captures = allCaptures.get(dep);
+      if (captures && key in captures) {
+        hadReplacement = true;
+        return captures[key];
+      }
+      return match;
+    });
+    return hadReplacement ? expanded : undefined;
+  }
   updateStatus(name, status) {
     const state = this.states.get(name);
     state.status = status;
@@ -1810,7 +1889,7 @@ class ProcessManager {
     state.exitCode = null;
     state.restartCount++;
     this.startTimes.set(name, Date.now());
-    runner.restart(cols, rows);
+    runner.restart(cols, rows, this.expandDependencyCaptures(name));
   }
   async stop(name) {
     const state = this.states.get(name);
@@ -1848,7 +1927,7 @@ class ProcessManager {
     state.exitCode = null;
     state.restartCount++;
     this.startTimes.set(name, Date.now());
-    this.runners.get(name)?.restart(cols, rows);
+    this.runners.get(name)?.restart(cols, rows, this.expandDependencyCaptures(name));
   }
   restartAll(cols, rows) {
     log("Restarting all processes");
@@ -1887,6 +1966,9 @@ class ProcessManager {
     }
   }
 }
+function escapeRegExp(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 var FALSY_VALUES = new Set(["", "0", "false", "no", "off"]);
 function evaluateCondition(condition) {
   const negated = condition.startsWith("!");

package/dist/types.d.ts

@@ -4,7 +4,7 @@ export interface NumuxProcessConfig {
     env?: Record<string, string>;
     envFile?: string | string[] | false;
     dependsOn?: string[];
-    readyPattern?: string;
+    readyPattern?: string | RegExp;
     persistent?: boolean;
     maxRestarts?: number;
     readyTimeout?: number;

package/package.json

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