numux 2.0.5 → 2.2.0

package/README.md

@@ -128,15 +128,18 @@ numux -n api="bun dev:api" -n web="bun dev:web"
 
 ### Script patterns
 
-Run multiple package.json scripts matching a glob pattern:
+Run package.json scripts by name — any colon-containing name is automatically recognized as a script reference:
 
 ```sh
-numux 'dev:*'             # all scripts matching dev:*
-numux 'npm:*:dev'         # explicit npm: prefix (same behavior)
+numux 'lint:eslint --fix'  # runs: yarn run lint:eslint --fix
+numux 'dev:*'              # all scripts matching dev:*
+numux 'npm:*:dev'          # explicit npm: prefix (same behavior)
 ```
 
 `*` does not match across `:` separators (like `/` in file paths), so `format:*` matches `format:store` but not `format:check:store`. Use `format:*:*` to match two levels deep.
 
+Append `^` to skip scripts that act as group runners — scripts that have sub-scripts beneath them. For example, if `format:check` runs `numux 'format:check:*'` internally, then `format:*^` excludes it (because `format:check:store` and `format:check:odoo` exist as sub-scripts), avoiding duplicate runs.
+
 Extra arguments after the pattern are forwarded to each matched command:
 
 ```sh

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: "2.0.5",
+    version: "2.2.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -666,6 +666,17 @@ function detectPackageManager(pkgJson, cwd) {
 function isGlobPattern(name) {
   return /[*?[]/.test(name);
 }
+function isScriptReference(name, value) {
+  if (name.startsWith("npm:") || isGlobPattern(name))
+    return true;
+  if (!name.includes(":"))
+    return false;
+  if (typeof value === "string")
+    return false;
+  if (value && typeof value === "object" && "command" in value)
+    return false;
+  return true;
+}
 function deriveShortName(pattern, scriptName) {
   let prefixEnd = 0;
   while (prefixEnd < pattern.length && !"*?[".includes(pattern[prefixEnd])) {
@@ -692,8 +703,8 @@ function splitPatternArgs(raw) {
 }
 function expandScriptPatterns(config, cwd) {
   const entries = Object.entries(config.processes);
-  const hasWildcard = entries.some(([name]) => name.startsWith("npm:") || isGlobPattern(name));
-  if (!hasWildcard)
+  const hasScriptRef = entries.some(([name, value]) => isScriptReference(name, value));
+  if (!hasScriptRef)
     return config;
   const dir = config.cwd ?? cwd ?? process.cwd();
   const pkgPath = resolve(dir, "package.json");
@@ -709,7 +720,7 @@ function expandScriptPatterns(config, cwd) {
   const pm = detectPackageManager(pkgJson, dir);
   const expanded = {};
   for (const [name, value] of entries) {
-    if (!(name.startsWith("npm:") || isGlobPattern(name))) {
+    if (!isScriptReference(name, value)) {
       expanded[name] = value;
       continue;
     }
@@ -719,17 +730,19 @@ function expandScriptPatterns(config, cwd) {
     if (template.command) {
       throw new Error(`"${name}": wildcard processes cannot have a "command" field (commands come from package.json scripts)`);
     }
-    const glob = new Bun.Glob(globPattern);
-    const colonDepth = (globPattern.match(/:/g) || []).length;
-    const matches = scriptNames.filter((s) => glob.match(s) && (s.match(/:/g) || []).length === colonDepth);
+    const leafOnly = globPattern.endsWith("^");
+    const effectivePattern = leafOnly ? globPattern.slice(0, -1) : globPattern;
+    const glob = new Bun.Glob(effectivePattern);
+    const colonDepth = (effectivePattern.match(/:/g) || []).length;
+    const matches = scriptNames.filter((s) => glob.match(s) && (s.match(/:/g) || []).length === colonDepth && !(leafOnly && scriptNames.some((other) => other.startsWith(`${s}:`))));
     if (matches.length === 0) {
-      throw new Error(`"${name}": no scripts matched pattern "${globPattern}". Available scripts: ${scriptNames.join(", ")}`);
+      throw new Error(`"${name}": no scripts matched pattern "${effectivePattern}". Available scripts: ${scriptNames.join(", ")}`);
     }
     const colors = Array.isArray(template.color) ? template.color : undefined;
     const singleColor = typeof template.color === "string" ? template.color : undefined;
     for (let i = 0;i < matches.length; i++) {
       const scriptName = matches[i];
-      const displayName = deriveShortName(globPattern, scriptName);
+      const displayName = deriveShortName(effectivePattern, scriptName);
       if (expanded[displayName]) {
         throw new Error(`"${name}": expanded script "${scriptName}" collides with an existing process name`);
       }
@@ -3753,7 +3766,7 @@ async function main() {
   let config;
   const warnings = [];
   if (parsed.commands.length > 0 || parsed.named.length > 0 || parsed.workspace) {
-    const isScriptPattern = (c) => c.startsWith("npm:") || /[*?[]/.test(c);
+    const isScriptPattern = (c) => c.startsWith("npm:") || /[*?[]/.test(c) || c.split(/\s+/)[0].includes(":");
     const hasNpmPatterns = parsed.commands.some(isScriptPattern);
     if (hasNpmPatterns) {
       const npmPatterns = parsed.commands.filter(isScriptPattern);

package/package.json

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