src: add --run-from runtime flag

doc/api/cli.md

@@ -2294,6 +2294,26 @@ 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>`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1.0 - Early development
+
+Run a `package.json` script from a specified path to a `package.json` file
+or path to the containing folder of a `package.json` file.
+
+The script is run from the current working directory, not from the
+`package.json` containing folder.
+
+```bash
+node --run-from=/app/package.json --run test
+# Or
+node --run-from=/app/ --run test
+```
+
 ### `--secure-heap-min=n`
 
 <!-- YAML

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 in a specific working directory",
+            &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

@@ -206,7 +206,30 @@ void ProcessRunner::OnExit(int64_t exit_status, int term_signal) {
 
 void ProcessRunner::Run() {
   // keeps the string alive until destructor
-  cwd = package_json_path_.parent_path().string();
+  if (!node::per_process::cli_options->run_from.empty()) {
+    cwd = node::per_process::cli_options->run_from;
+    if (!std::filesystem::is_directory(cwd)) {
+      // If the given path is a file and the file name is package.json, the
+      // parent directory is used
+      std::filesystem::path p(cwd);
+      if (std::filesystem::is_regular_file(p) &&
+          p.filename() == "package.json") {
+        cwd = p.parent_path().string();
+      } else {
+        fprintf(stderr, "Error: %s is not a directory\n", cwd.c_str());
+        init_result->exit_code_ = ExitCode::kGenericUserError;
+        return;
+      }
+    }
+    // Adding node_modules/.bin under cwd to PATH environment variable
+    std::filesystem::path nmBin =
+        std::filesystem::path(cwd) / "node_modules" / ".bin";
+    if (std::filesystem::is_directory(nmBin)) {
+      path_env_var_ = nmBin.string() + env_var_separator + path_env_var_;
+    }
+  } else {
+    cwd = package_json_path_.parent_path().string();
+  }
   options_.cwd = cwd.c_str();
   if (int r = uv_spawn(loop_, &process_, &options_)) {
     fprintf(stderr, "Error: %s\n", uv_strerror(r));

test/parallel/test-node-run.js

@@ -222,4 +222,46 @@ 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 customDir = fixtures.path('run-script');
+    const child = await common.spawnPromisified(
+      process.execPath,
+      [ '--run-from', customDir, '--run', `pwd${envSuffix}` ],
+
+      { cwd: fixtures.path('run-script/sub-directory') }
+    );
+
+    assert.strictEqual(child.stdout.trim(), customDir);
+    assert.strictEqual(child.stderr, '');
+    assert.strictEqual(child.code, 0);
+  });
+
+  it('runs script in a custom working directory when --run-from is provided as a package.json file path', async () => {
+    const pkgFilePath = fixtures.path('run-script/package.json');
+    const expectedDir = fixtures.path('run-script');
+    const child = await common.spawnPromisified(
+      process.execPath,
+      [ '--run-from', pkgFilePath, '--run', 'pwd' ],
+      { cwd: fixtures.path('run-script/sub-directory') }
+    );
+
+    assert.strictEqual(child.stdout.trim(), expectedDir);
+    assert.strictEqual(child.stderr, '');
+    assert.strictEqual(child.code, 0);
+  });
+
+  it('--run-from should be no-op when used without --run', async () => {
+    const dirPath = fixtures.path('run-script/package.json');
+
+    const child = await common.spawnPromisified(
+      process.execPath,
+      [ '--run-from', dirPath, '--print', 'process.cwd()' ],
+      { cwd: process.cwd() }
+    );
+
+    assert.strictEqual(child.stderr, '');
+    assert.strictEqual(child.stdout, process.cwd() + '\n');
+    assert.strictEqual(child.code, 0);
+  });
 });