sparkforensics 0.2.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agustin Recoba
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# sparkforensics
+
+Installs the `sparkforensics-analyze` command, which analyzes Apache Spark
+event logs for performance bottlenecks. This package holds no analysis code:
+it depends on [sparkforensics-cli](https://www.npmjs.com/package/sparkforensics-cli)
+and runs its `sparkforensics-analyze` bin with the same arguments, output and
+exit code.
+
+```bash
+npm install -g sparkforensics
+sparkforensics-analyze path/to/eventlog --max-runtime 3600000 --max-skew 3
+```
+
+Or without installing: `npx sparkforensics path/to/eventlog`.
+
+See the [main README](https://github.com/shuffle-works/sparkforensics#readme)
+for the full flag reference and exit codes.

package/bin/sparkforensics-analyze.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+// Alias bin: runs sparkforensics-cli's sparkforensics-analyze with the same
+// arguments and stdio, and exits with its exit code (or re-raises its signal).
+// packages/analyze and packages/sparkforensics ship this same file.
+import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+
+const require = createRequire(import.meta.url);
+const cliManifestPath = require.resolve('sparkforensics-cli/package.json');
+const cliManifest = JSON.parse(readFileSync(cliManifestPath, 'utf8'));
+const cliBin = join(dirname(cliManifestPath), cliManifest.bin['sparkforensics-analyze']);
+
+const child = spawn(process.execPath, [cliBin, ...process.argv.slice(2)], { stdio: 'inherit' });
+
+// Ctrl-C already reaches the child through the terminal's process group; a
+// signal sent to this process alone is passed on. Either way this process
+// stays alive until the child exits, so it can report the child's status.
+const forward = (signal) => child.kill(signal);
+for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) process.on(signal, forward);
+
+child.on('error', (err) => {
+  process.stderr.write(`sparkforensics-analyze: could not start sparkforensics-cli: ${err.message}\n`);
+  process.exitCode = 1;
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.removeListener(signal, forward);
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exitCode = code;
+});

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "sparkforensics",
+  "version": "0.2.4",
+  "type": "module",
+  "license": "MIT",
+  "description": "Installs the sparkforensics-analyze command from sparkforensics-cli: analyze Apache Spark event logs for skew, spill, GC pressure, stragglers, and more.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shuffle-works/sparkforensics.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shuffle-works/sparkforensics/issues"
+  },
+  "homepage": "https://github.com/shuffle-works/sparkforensics#readme",
+  "keywords": [
+    "apache-spark",
+    "spark",
+    "spark-history-server",
+    "cli",
+    "performance",
+    "diagnostics",
+    "event-log"
+  ],
+  "bin": {
+    "sparkforensics-analyze": "bin/sparkforensics-analyze.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/"
+  ],
+  "dependencies": {
+    "sparkforensics-cli": "^0.2.4"
+  }
+}