numux 2.6.0 → 2.7.0

package/README.md

@@ -59,7 +59,7 @@ export default defineConfig({
 
 The `defineConfig()` helper is optional — it provides type checking for your config.
 
-Processes can be a string (shorthand for `{ command: "..." }`) or a full config object.
+Processes can be a string (shorthand for `{ command: "..." }`), `true` or `{}` (auto-resolves to a matching `package.json` script), or a full config object.
 
 Then run:
 
@@ -159,6 +159,18 @@ export default defineConfig({
 
 Template properties (color, env, dependsOn, etc.) are inherited by all matched processes. Colors given as an array are distributed round-robin.
 
+When a process has no command and its name matches a `package.json` script, the command is auto-resolved:
+
+```ts
+export default defineConfig({
+  processes: {
+    lint: true,                       // → bun run lint
+    typecheck: { dependsOn: ['db'] }, // → bun run typecheck (with dependency)
+    db: 'docker compose up postgres', // explicit command, not resolved
+  },
+})
+```
+
 ### Options
 
 | Flag | Description |

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.6.0",
+    version: "2.7.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -713,29 +713,60 @@ function splitPatternArgs(raw) {
     return { glob: raw, extraArgs: "" };
   return { glob: raw.slice(0, i), extraArgs: raw.slice(i) };
 }
+function expandScriptCommand(raw, pm) {
+  const { glob: script, extraArgs } = splitPatternArgs(raw);
+  if (extraArgs) {
+    return `${pm} run ${script} --${extraArgs}`;
+  }
+  return `${pm} run ${script}`;
+}
 function expandScriptPatterns(config, cwd) {
   const entries = Object.entries(config.processes);
+  const cmd = (v) => typeof v === "string" ? v : v?.command;
   const hasScriptRef = entries.some(([name, value]) => isScriptReference(name, value));
-  if (!hasScriptRef)
+  const hasNpmCommand = entries.some(([, v]) => {
+    const c = cmd(v);
+    return typeof c === "string" && c.startsWith("npm:");
+  });
+  const hasCommandlessEntry = entries.some(([, v]) => {
+    if (v == null || v === true)
+      return true;
+    if (typeof v === "object" && !("command" in v))
+      return true;
+    return false;
+  });
+  if (!(hasScriptRef || hasNpmCommand || hasCommandlessEntry))
     return config;
   const dir = config.cwd ?? cwd ?? process.cwd();
   const pkgPath = resolve(dir, "package.json");
-  if (!existsSync(pkgPath)) {
+  if (!existsSync(pkgPath) && hasScriptRef) {
     throw new Error(`Wildcard patterns require a package.json (looked in ${dir})`);
   }
-  const pkgJson = JSON.parse(readFileSync(pkgPath, "utf-8"));
+  const pkgJson = existsSync(pkgPath) ? JSON.parse(readFileSync(pkgPath, "utf-8")) : {};
   const scripts = pkgJson.scripts;
-  if (!scripts || typeof scripts !== "object") {
-    throw new Error('package.json has no "scripts" field');
-  }
-  const scriptNames = Object.keys(scripts);
+  const scriptNames = scripts && typeof scripts === "object" ? Object.keys(scripts) : [];
   const pm = detectPackageManager(pkgJson, dir);
   const expanded = {};
   for (const [name, value] of entries) {
     if (!isScriptReference(name, value)) {
-      expanded[name] = value;
+      if (value === true || value == null) {
+        expanded[name] = scriptNames.includes(name) ? expandScriptCommand(name, pm) : value;
+        continue;
+      }
+      let proc = value;
+      const c = cmd(proc);
+      if (typeof c === "string" && c.startsWith("npm:")) {
+        const expandedCmd = expandScriptCommand(c.slice(4), pm);
+        proc = typeof proc === "string" ? expandedCmd : { ...proc, command: expandedCmd };
+      } else if (!c && scriptNames.includes(name)) {
+        proc = { ...proc, command: expandScriptCommand(name, pm) };
+      }
+      expanded[name] = proc;
       continue;
     }
+    if (!scripts || typeof scripts !== "object") {
+      throw new Error('package.json has no "scripts" field');
+    }
     const rawPattern = name.startsWith("npm:") ? name.slice(4) : name;
     const { glob: globPattern, extraArgs } = splitPatternArgs(rawPattern);
     const template = value ?? {};
@@ -762,7 +793,7 @@ function expandScriptPatterns(config, cwd) {
       const { color: _color, ...rest } = template;
       expanded[displayName] = {
         ...rest,
-        command: `${pm} run ${scriptName}${extraArgs}`,
+        command: expandScriptCommand(`${scriptName}${extraArgs}`, pm),
         ...color ? { color } : {}
       };
     }
@@ -1329,7 +1360,7 @@ function expandWorkspaces(config) {
   const newProcesses = {};
   let discoveredWorkspaces = null;
   for (const [name, entry] of Object.entries(config.processes)) {
-    if (typeof entry === "string" || !entry.workspaces) {
+    if (typeof entry === "string" || entry === true || !entry.workspaces) {
       newProcesses[name] = entry;
       continue;
     }

package/dist/types.d.ts

@@ -119,7 +119,7 @@ export interface NumuxConfig<K extends string = string> {
     noWatch?: boolean;
     /** Directory to write per-process log files */
     logDir?: string;
-    processes: Record<K, NumuxProcessConfig<K> | NumuxScriptPattern<K> | string>;
+    processes: Record<K, NumuxProcessConfig<K> | NumuxScriptPattern<K> | string | true>;
 }
 export type SortOrder = 'config' | 'alphabetical' | 'topological';
 /** Process config after validation — dependsOn is always normalized to an array */

package/package.json

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