Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

docs(neural-trader): record 2.7.2 fix, keep --ignore-scripts as defense (#1974) (#1979)

rUv4051aeecadd7
diff --git a/plugins/ruflo-neural-trader/README.md b/plugins/ruflo-neural-trader/README.md
index c867a814aa..81d1a12969 100644
--- a/plugins/ruflo-neural-trader/README.md
+++ b/plugins/ruflo-neural-trader/README.md
@@ -10,34 +10,25 @@ Heavy jobs β€” multi-year walk-forward backtests, large Monte-Carlo runs, parame
## Prerequisites
-> ⚠️ **Critical install advisory β€” #1974**
->
-> `[email protected]` (and every earlier published version we audited) has a
-> dangerous `install` lifecycle script that **recursively invokes `npm install`
-> from inside the install hook**. On any non-`linux-x64` host (macOS Apple
-> Silicon, Windows, linux-arm64) the recursion is unbounded β€” one report saw
-> 3,049 stuck processes consuming ~120 GB of RAM in ~80 minutes before manual
-> intervention. The platform-binary subpackages it advertises in
-> `optionalDependencies` (`neural-trader-darwin-arm64`, etc.) are **not
-> published to npm**, which is what triggers the fallback path.
->
-> Until upstream ships a fix, always install neural-trader with
-> `--ignore-scripts` to skip the malicious install hook. The `linux-x64`
-> binary is hardcoded inline in the tarball, so on `linux-x64` the package
-> still works after `--ignore-scripts`. On other platforms `--ignore-scripts`
-> at least won't fork-bomb your machine; whether the runtime works depends on
-> upstream publishing the platform binary.
+> βœ… **Fixed in `[email protected]`** ([upstream PR #109](https://github.com/ruvnet/neural-trader/pull/109), shipped 2026-05-14).
+> The fork-bomb regression originally reported in #1974 (3,049 stuck processes, ~120 GB RAM in ~80 min on macOS Apple Silicon) is resolved. The install hook no longer spawns a recursive `npm install`. Use 2.7.2+ on all platforms.
```bash
-# SAFE β€” skips the upstream install script that fork-bombs on non-linux-x64
-npm install --ignore-scripts neural-trader
-
-# DO NOT run `npm install neural-trader` (no flags) on macOS / Windows /
-# linux-arm64 until #1974 is resolved upstream.
+# Recommended β€” keeps --ignore-scripts as defense in depth. The install
+# hook is safe in 2.7.2+, but --ignore-scripts protects against any
+# future install-script regression on this or transitive packages.
+npm install --ignore-scripts [email protected]
```
-Set the env var `npm_config_ignore_scripts=1` in your shell rc to make this
-the default for all subsequent `npx neural-trader` calls.
+> 🚨 **If you must use an older version** (`[email protected]` or below β€” same fork-bomb risk on every non-linux-x64 host) always pass `--ignore-scripts` to skip the malicious install hook. The `linux-x64` binary is hardcoded inline in the tarball, so on `linux-x64` the package still works after `--ignore-scripts`. On other platforms `--ignore-scripts` at least won't fork-bomb your machine.
+>
+> ```bash
+> # Only needed for neural-trader <= 2.7.1 β€” DO NOT run plain `npm install
+> # neural-trader@<=2.7.1` on macOS / Windows / linux-arm64.
+> npm install --ignore-scripts neural-trader@<=2.7.1
+> ```
+
+The `audit-neural-trader-safety.mjs` CI guard in this repo still enforces `--ignore-scripts` on every documented invocation β€” defense in depth in case anyone pins to an older version in a lockfile.
## Installation