[Roshi's Codex PRIME]

Node.js-only runtime-boundary and engineering-evidence patch.

• Declares the Node.js-only boundary across package metadata, documentation, examples, and every documentation-site page.
• Adds a static runtime-contract gate for package imports, browser metadata, the 53-case inventory, packed documentation, and examples.
• Strengthens the clean-consumer package smoke test for exact contents, zero runtime dependencies, CommonJS, and native Node.js ESM.
• Preserves all five behavioral scenarios, 53/53 total tests, and 100% statements, branches, functions, and lines.
• Verifies the package across Node.js 22.12 and 24 on Linux, macOS, and Windows.

npm integrity: sha512-L1tIU3wJJsKKj5AaXZKR0mRMcaJ5ekoYEkNGh02wm7APf9E7Aiy3bHPsYUiMfyRIGeRcar3X0WJQ/Mlt13Msrw==

CI: https://github.com/RIAEvangelist/node-cmd/actions/runs/32687598753

node-cmd 6.0.0 modernizes command-line execution for Node.js while keeping zero runtime dependencies.

Highlights

• Shell commands through callbacks, Promises, and synchronous execution.
• Direct executable APIs for argument-safe invocation without a shell.
• Streaming child-process access for interactive and long-running programs.
• AbortSignal, timeout, encoding, environment, working-directory, and process-control options.
• CommonJS and ESM entry points with explicit package exports.
• A vanilla-test 2.0.0 suite with 17 cross-platform tests and published engineer-readable coverage.
• A six-page documentation site covering the API, testing, security, migration, and changelog.

Compatibility

• Requires Node.js 22.12.0 or newer.
• Tested on Node.js 22.12.0 and 24 across Linux, macOS, and Windows.
• Coverage: 100% statements, 95.23% branches, 100% functions, and 100% lines.

Documentation: https://riaevangelist.github.io/node-cmd/
Migration guide: https://riaevangelist.github.io/node-cmd/migration.html
Testing and coverage: https://riaevangelist.github.io/node-cmd/testing.html

You can now run commands synchronously with runSync if you want to block your code until execution is complete.

Made Err the first param for callbacks and handlers inorder to properly follow node patterns and also to support both callback and promise use, @stephen-last converted the response order to have err first.

Thanks to @freemany for adding access to the spawned process.

This gives access to information like the pid, as well as stdin/out/io/err etc.

This means you can now create and or use interactive shells. I added an example of opening a python shell and running some code in it from node and put it in the README.md

Thanks to @rduartes for his commit, err and std err update

sys removed and multiline examples now included

node js terminal or commandline npm module. initial release on GitHub