dsh CLI exits silently (code 0) on Node.js without import.meta.main (including all of v23)

[lzskyline]

Bug

npx @deepseek-ai/dsh web (and --help / --version) prints nothing and exits 0. The CLI never starts.

Affects Node.js v23.x (entire line), v22 < 22.18.0, and v24 < 24.2.0.

Environment

Field	Value
OS	macOS (darwin, ARM64)
Node.js	v23.10.0 (EOL 2025-06-01)
Bun	1.3.14 (works)
Package	@deepseek-ai/dsh@0.1.5-rc.1 / 0.1.5-rc.2

$ node -e "console.log('main' in import.meta, import.meta.main)" --input-type=module
false undefined

Published package.json has no engines field.

Repro

npx @deepseek-ai/dsh web        # no output, exit 0
npx @deepseek-ai/dsh --help     # no output, exit 0
npx @deepseek-ai/dsh --version  # no output, exit 0

Shebang is #!/usr/bin/env node. Direct Bun invocation works:

bun node_modules/@deepseek-ai/dsh/lib/bin.js -V
# 0.1.5-rc.2

Root cause

lib/bin.js ends with:

if (import.meta.main) await runCli();

On Node.js without import.meta.main this is undefined, so runCli() never runs.

Line	First version with import.meta.main	Date
Current	v24.2.0 (nodejs/node#57804)	2025-06-09
v22 LTS	v22.18.0 (backport)	2025-07-31
v23	never	EOL 2025-06-01, two days before v24.2.0

v23 sits between 22 and 24 by version number but never received the feature. engines: ">=22.18.0" would incorrectly match v23.x.

Suggested fix

A. Declare engines that exclude v23:

{ "engines": { "node": ">=22.18.0 <23.0.0 || >=24.2.0" } }

npm only hard-fails this with engine-strict.

B. Fallback entry guard (if older Node.js / v23 should still work):

import { pathToFileURL } from "node:url";

const isMain =
  import.meta.main ??
  (Boolean(process.argv[1]) &&
    import.meta.url === pathToFileURL(process.argv[1]).href);

if (isMain) await runCli();

C. If Bun is the only runtime, change the shebang to #!/usr/bin/env bun and document it. That contradicts the current npx + #!/usr/bin/env node path.

Silent exit 0 is the worst CLI failure mode.

Workaround

Upgrade Node.js to >=22.18.0 excluding v23, or >=24.2.0. Or run with Bun:

bun node_modules/@deepseek-ai/dsh/lib/bin.js web