feat(config): auto-resolve command from package.json scripts (#88)

* feat(config): auto-resolve command from package.json scripts

When a process has no command and its name matches a package.json
script, the command is automatically set to `<pm> run <name>`.
This eliminates the redundancy of `'lint': { command: 'npm:lint' }` —
now just `'lint': {}` works.

Co-Authored-By: Claude Opus 4.6 <[email protected]>

* docs: document auto-resolve of commands from package.json scripts

Co-Authored-By: Claude Opus 4.6 <[email protected]>

* feat(config): allow `true` as process shorthand for script auto-resolve

`lint: true` is now equivalent to `lint: {}` — both auto-resolve to
`<pm> run lint` when the name matches a package.json script.

Co-Authored-By: Claude Opus 4.6 <[email protected]>

---------

Co-authored-by: Claude Opus 4.6 <[email protected]>

Author: hyldmo

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 |

src/config/expand-scripts.test.ts

@@ -353,11 +353,38 @@ describe('expandScriptPatterns', () => {
 		)
 	})
 
-	test('non-glob names without command are not expanded', () => {
-		// Names like "web" that don't contain glob chars should NOT be treated as patterns
-		const config: NumuxConfig = { processes: { web: { env: { FOO: 'bar' } } } }
-		// This should passthrough, not try to expand
-		expect(expandScriptPatterns(config)).toBe(config)
+	test('commandless entry auto-resolves when name matches a script', () => {
+		const dir = setupDir('auto-resolve', {
+			'package.json': pkgJson({ lint: 'eslint .', dev: 'next dev' })
+		})
+		const result = expandScriptPatterns({ processes: { lint: {}, dev: { env: { PORT: '3000' } } } }, dir)
+		expect(proc(result, 'lint').command).toBe('npm run lint')
+		expect(proc(result, 'dev').command).toBe('npm run dev')
+		expect(proc(result, 'dev').env).toEqual({ PORT: '3000' })
+	})
+
+	test('true value auto-resolves when name matches a script', () => {
+		const dir = setupDir('auto-resolve-true', {
+			'package.json': pkgJson({ lint: 'eslint .', dev: 'next dev' })
+		})
+		const result = expandScriptPatterns({ processes: { lint: true as any, dev: true as any } }, dir)
+		expect(result.processes.lint).toBe('npm run lint')
+		expect(result.processes.dev).toBe('npm run dev')
+	})
+
+	test('commandless entry not matching a script passes through unchanged', () => {
+		const dir = setupDir('auto-resolve-miss', {
+			'package.json': pkgJson({ dev: 'next dev' })
+		})
+		const result = expandScriptPatterns({ processes: { web: { env: { FOO: 'bar' } } } }, dir)
+		// Not a script match — passes through as-is (validator will catch missing command)
+		expect(proc(result, 'web').command).toBeUndefined()
+	})
+
+	test('no package.json — commandless entries pass through', () => {
+		const dir = setupDir('auto-resolve-no-pkg', {})
+		const result = expandScriptPatterns({ processes: { web: {} } }, dir)
+		expect(proc(result, 'web').command).toBeUndefined()
 	})
 
 	test('extra args are forwarded to expanded commands', () => {

src/config/expand-scripts.ts

@@ -87,7 +87,12 @@ export function expandScriptPatterns(config: NumuxConfig, cwd?: string): NumuxCo
 		const c = cmd(v)
 		return typeof c === 'string' && c.startsWith('npm:')
 	})
-	if (!(hasScriptRef || hasNpmCommand)) return config
+	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')
@@ -103,11 +108,19 @@ export function expandScriptPatterns(config: NumuxConfig, cwd?: string): NumuxCo
 
 	for (const [name, value] of entries) {
 		if (!isScriptReference(name, value)) {
+			// true/null shorthand: resolve from scripts or pass through for validator to catch
+			if (value === true || value == null) {
+				expanded[name] = scriptNames.includes(name) ? expandScriptCommand(name, pm) : (value as any)
+				continue
+			}
 			let proc = value as NumuxProcessConfig | string
 			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)) {
+				// Auto-resolve: process name matches a package.json script
+				proc = { ...(proc as NumuxProcessConfig), command: expandScriptCommand(name, pm) }
 			}
 			expanded[name] = proc
 			continue

src/config/workspaces.ts

@@ -80,8 +80,8 @@ export function expandWorkspaces(config: NumuxConfig): NumuxConfig {
 	let discoveredWorkspaces: WorkspaceInfo[] | null = null
 
 	for (const [name, entry] of Object.entries(config.processes)) {
-		// Pass through string shorthand and non-workspace entries
-		if (typeof entry === 'string' || !entry.workspaces) {
+		// Pass through string shorthand, true shorthand, and non-workspace entries
+		if (typeof entry === 'string' || entry === true || !entry.workspaces) {
 			newProcesses[name] = entry
 			continue
 		}

src/types.ts

@@ -120,7 +120,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'