doc: clarify --watch and --watch-path usage with --run

[juanibe]

This PR adds a note under the --watch and --watch-path CLI options in cli.md to clarify that these flags require a file path and cannot be used with --run.

Fixes confusion where users might assume --watch-path or --watch work with --run, which currently results in a runtime error.

Helps address issue discussion here

[juanarbol]

Hi! Thanks for taking care of this.

The PR may need some extra edits. The implies of watch in watch-path is not being shown, and also, just keep in mind that the --run flag has priority; It can not be mixed with watch and its derivatives. Could you please reflect that into your PR?

Refs:
https://github.com/nodejs/node/blob/main/src/node.cc#L1067

[juanibe]

Hi @juanarbol!, thanks for the observation
I added the missing detail that --watch-path implicitly enables --watch and simplified the wording to reduce redundancy (since the reader can now refer to --watch). Let me know if any further clarification or modification is needed

[juanarbol]

Just some more minor clarifications, I'm sorry I just forgot a couple details, but after this; I'm more than happy with this PR. Thanks again!

[juanarbol]

RLGTM

[juanarbol]

Worth reading doc.

https://github.com/nodejs/node/blob/70863fb9dd4b70f1ba6141db4403e69eb7a9eeff/CONTRIBUTING.md :)

[juanarbol]

lgtm

[juanarbol]

Test failure is already reported.

Refs: #58127

[juanibe]

Updated the first commit message accordingly by amending it

[juanarbol]

Updated the first commit message accordingly by amending it

Thanks. You don't have to do it now, but if you intend to land a single commit, squash everything into a single commit.

[juanibe]

Updated the first commit message accordingly by amending it

Thanks. You don't have to do it now, but if you intend to land a single commit, squash everything into a single commit.

Thanks! I've squashed the commits and the PR should be ready now. Let me know if there's anything else needed from my side.

[juanarbol]

Thanks! I've squashed the commits and the PR should be ready now. Let me know if there's anything else needed from my side.

I'm sorry, CI still not happy due to commit guidelines. Fix it, will approve and wait for more reviews :-)

Humble ping to @nodejs/documentation

Refs:
https://github.com/nodejs/node/actions/runs/14824640752/job/41770212057#step:6:15

[juanibe]

Yeah, missed that part 🙏.
Already amended it
Thanks!