π 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
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
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.mdindex 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