[aryanjasala]

What this PR does

Stops wp-tooling from cutting its output short when it is piped. bin/wp-tooling.js called process.exit() as soon as a command resolved, which drops whatever stdout has not written yet. Writes to a pipe are asynchronous on macOS, so wp-tooling list --json | jq, or iapi-check --output json | jq (#91), received exactly 65,536 bytes of invalid JSON whenever the reader was not ready in time.

Closes

N/A

Changes

• bin/wp-tooling.js sets process.exitCode, writes an empty chunk and exits from its callback, once everything queued before it has gone out. A closed pipe (EPIPE, for example | head) still exits straight away. Exit codes are unchanged.
• tests/cli/bin.test.js pipes list --json (about 70 KiB) into a reader that starts a second late and checks it receives every byte, and checks a usage error still exits 2.
• CHANGELOG entry under ### Fixed.

How I verified

$ node bin/wp-tooling.js list --json | (sleep 1; wc -c)    # main, three runs
65536
65536
65536
$ node bin/wp-tooling.js list --json | (sleep 1; wc -c)    # this branch, three runs
70949
70949
70949
$ npx jest --ci --coverage                                  # node-packages/wp-tooling
Test Suites: 83 passed, 83 total
Tests:       1380 passed, 1380 total
$ npm run lint -w @rtcamp/wp-tooling

The new test fails on main (Expected: 70949, Received: 65536) and passes here.

Reviewer notes

• Linux writes to pipes synchronously, so GitHub's runners never showed this and the test passes there either way; it guards the macOS case.
• Found while reviewing feat(iapi-check): flag Interactivity API usages that WordPress 7.2 removes #91; it affects every command that writes a long report, so it lands on its own and should go in before 2.1.0.

[Copilot]

🟡 Changes recommended

The regression-test comment needs correction because asynchronous stdout writes can also truncate piped output on Linux, not just macOS.

1 open issue

• Correct the comment about asynchronous pipe writes on Linux · New

What changed in this PR

This PR prevents truncated piped output from the wp-tooling CLI, supporting commands that produce large JSON reports.

Changes:

• Waits for queued stdout writes before exiting, preserving command exit codes and handling closed pipes.
• Adds regression tests for delayed pipe readers and usage-error exit codes.
• Documents the fix in the changelog.

File	Description
node-packages/​wp-tooling/​tests/​cli/​bin.test.js	Tests complete piped output and usage-error exit status.
node-packages/​wp-tooling/​CHANGELOG.md	Records the stdout truncation fix.
node-packages/​wp-tooling/​bin/​wp-tooling.js	Defers exit until stdout finishes writing or reports an error.

_{Review effort: Balanced}