src: add --run-from flag

doc/api/cli.md

@@ -2294,6 +2294,25 @@ The following environment variables are set when running a script with `--run`:
 * `NODE_RUN_PACKAGE_JSON_PATH`: The path to the `package.json` that is being
   processed.
 
+### `--run-from=<path>`
+
+<!--
+added: REPLACEME
+-->
+
+> Stability 1.0 - Early development
+
+Run a `package.json` script from a specified path to a containing folder of a
+`package.json` file.
+
+The script is run from the directory of the `package.json` file.
+
+```bash
+node --run-from=/app/package.json --run test
+# Or
+node --run-from=/app/ --run test
+```
+
 ### `--secure-heap-min=n`
 
 <!-- YAML

doc/node.1

@@ -431,6 +431,10 @@ Enables
 to be generated on un-caught exceptions. Useful when inspecting JavaScript
 stack in conjunction with native stack and other runtime environment data.
 .
+.It Fl -run-from Ar string
+Run a package.json script from a specified path to a folder containing a package.json file.
+.Ar string
+.
 .It Fl -secure-heap Ns = Ns Ar n
 Specify the size of the OpenSSL secure heap. Any value less than 2 disables
 the secure heap. The default is 0. The value must be a power of two.

src/node_options.cc

@@ -1216,6 +1216,9 @@ PerProcessOptionsParser::PerProcessOptionsParser(
   AddOption("--run",
             "Run a script specified in package.json",
             &PerProcessOptions::run);
+  AddOption("--run-from",
+            "Run a package.json script from a specific path",
+            &PerProcessOptions::run_from);
   AddOption(
       "--disable-wasm-trap-handler",
       "Disable trap-handler-based WebAssembly bound checks. V8 will insert "

src/node_options.h

@@ -327,6 +327,7 @@ class PerProcessOptions : public Options {
   bool print_version = false;
   std::string experimental_sea_config;
   std::string run;
+  std::string run_from;
 
 #ifdef NODE_HAVE_I18N_SUPPORT
   std::string icu_data_dir;

src/node_task_runner.cc

@@ -1,6 +1,7 @@
 #include "node_task_runner.h"
 #include "util-inl.h"
 
+#include <filesystem>
 #include <regex>  // NOLINT(build/c++11)
 
 namespace node::task_runner {
@@ -252,7 +253,22 @@ FindPackageJson(const std::filesystem::path& cwd) {
 void RunTask(const std::shared_ptr<InitializationResultImpl>& result,
              std::string_view command_id,
              const std::vector<std::string_view>& positional_args) {
-  auto cwd = std::filesystem::current_path();
+  auto run_from = per_process::cli_options->run_from;
+  std::filesystem::path cwd;
+
+  if (run_from.empty()) {
+    cwd = std::filesystem::current_path();
+  } else {
+    cwd = std::filesystem::absolute(std::filesystem::path(run_from));
+
+    if (!is_directory(cwd)) {
+      // Given a directory that should have a package.json
+      fprintf(stderr, "Error: %s is not a directory\n", cwd.c_str());
+      result->exit_code_ = ExitCode::kGenericUserError;
+      return;
+    }
+  }
+
   auto package_json = FindPackageJson(cwd);
 
   if (!package_json.has_value()) {

test/parallel/test-node-run.js

@@ -222,4 +222,33 @@ describe('node --run [command]', () => {
     assert.strictEqual(child.stdout, '');
     assert.strictEqual(child.code, 1);
   });
+
+  it('runs script in a custom working directory using --run-from', async () => {
+    const workingDir = fixtures.path('run-script');
+
+    const child = await common.spawnPromisified(
+      process.execPath,
+      [ '--run-from', workingDir, '--run', `pwd${envSuffix}` ],
+
+      { env: fixtures.path('run-script/sub-directory') }
+    );
+
+    assert.strictEqual(child.stdout.trim(), workingDir);
+    assert.strictEqual(child.stderr, '');
+    assert.strictEqual(child.code, 0);
+  });
+
+  it('--run-from should be no-op when used without --run', async () => {
+    const packageJson = fixtures.path('run-script/package.json');
+
+    const child = await common.spawnPromisified(
+      process.execPath,
+      [ '--run-from', packageJson, '--print', 'process.cwd()' ],
+      { cwd: process.cwd() }
+    );
+
+    assert.strictEqual(child.stdout.trim(), process.cwd());
+    assert.strictEqual(child.stderr, '');
+    assert.strictEqual(child.code, 0);
+  });
 });