@tradejs/strategy-trend-follow 3.0.0 → 3.0.1

package/README.md

@@ -2,6 +2,17 @@
 
 TradeJS strategy plugin providing `TrendFollow`.
 
+## Strategy overview
+
+`TrendFollow` maintains an ATR-offset trailing trend state from replayable
+pivot structure. It trades directional flips with optional structure-breakout,
+trend, benchmark, volume, persistence, RSI, and volatility filters, and can
+exit on the trailing stop or an opposite signal.
+
+## Logic at a glance
+
+![TrendFollow strategy logic](https://raw.githubusercontent.com/TradeJS-Dev/TradeJS-Strategy-TrendFollow/main/docs/strategy-logic.svg)
+
 ## Install
 
 ```bash
@@ -30,5 +41,10 @@ yarn install --immutable
 yarn checks
 ```
 
-Publishing is triggered by a GitHub release and delegated to the pinned
-`TradeJS-Workflows@v1` reusable workflow.
+Publishing is beta-first and delegated to the pinned
+`TradeJS-Workflows@v1` reusable workflow. A relevant push publishes a unique
+prerelease and moves the npm `beta` tag only after the production-like Project
+image passes. The current verified beta is promoted to one stable `latest`
+release by the weekly automation; production never consumes prereleases.
+
+Keywords: ai, claude, codex.

package/dist/index.cjs

@@ -1251,7 +1251,7 @@ Interpretation rules for TrendFollow:
 var trendFollowAiAdapter = (0, import_ai_gate.withStrategyLocalAiGate)(
   trendFollowBaseAiAdapter,
   {
-    id: "trend_follow_short_breadth_2026_08_12",
+    id: "trend_follow_short_breadth_loss_guard_2026_08_18",
     approves: ({ signal, payload }) => {
       const advancers = (0, import_ai_gate.getAiPayloadNumber)(
         payload,
@@ -1261,7 +1261,20 @@ var trendFollowAiAdapter = (0, import_ai_gate.withStrategyLocalAiGate)(
         payload,
         "additionalIndicators.baseContext.relative.marketBreadths.top5.unchanged"
       );
-      return signal.direction === "SHORT" && advancers != null && advancers >= 2 && top5Unchanged != null && top5Unchanged <= 0;
+      const ethM15LevelsCrossed = (0, import_ai_gate.getAiPayloadNumber)(
+        payload,
+        "additionalIndicators.baseContext.relative.referencePsychologicalLevels.ETHUSDT.windows.m15.levelsCrossed"
+      );
+      const distanceToStopPct = (0, import_ai_gate.getAiPayloadNumber)(
+        payload,
+        "additionalIndicators.trendFollowContext.distanceToStopPct"
+      );
+      const top5EqualWeightedReturn = (0, import_ai_gate.getAiPayloadNumber)(
+        payload,
+        "additionalIndicators.baseContext.relative.marketBreadths.top5.equalWeightedReturn"
+      );
+      const avoidsDiscoveredLossPocket = ethM15LevelsCrossed != null && ethM15LevelsCrossed > 1 || distanceToStopPct != null && distanceToStopPct < 5.6151907 || top5EqualWeightedReturn != null && top5EqualWeightedReturn > -0.0023580731;
+      return signal.direction === "SHORT" && advancers != null && advancers >= 2 && top5Unchanged != null && top5Unchanged <= 0 && avoidsDiscoveredLossPocket;
     }
   }
 );

package/dist/index.js

@@ -1227,7 +1227,7 @@ Interpretation rules for TrendFollow:
 var trendFollowAiAdapter = withStrategyLocalAiGate(
   trendFollowBaseAiAdapter,
   {
-    id: "trend_follow_short_breadth_2026_08_12",
+    id: "trend_follow_short_breadth_loss_guard_2026_08_18",
     approves: ({ signal, payload }) => {
       const advancers = getAiPayloadNumber(
         payload,
@@ -1237,7 +1237,20 @@ var trendFollowAiAdapter = withStrategyLocalAiGate(
         payload,
         "additionalIndicators.baseContext.relative.marketBreadths.top5.unchanged"
       );
-      return signal.direction === "SHORT" && advancers != null && advancers >= 2 && top5Unchanged != null && top5Unchanged <= 0;
+      const ethM15LevelsCrossed = getAiPayloadNumber(
+        payload,
+        "additionalIndicators.baseContext.relative.referencePsychologicalLevels.ETHUSDT.windows.m15.levelsCrossed"
+      );
+      const distanceToStopPct = getAiPayloadNumber(
+        payload,
+        "additionalIndicators.trendFollowContext.distanceToStopPct"
+      );
+      const top5EqualWeightedReturn = getAiPayloadNumber(
+        payload,
+        "additionalIndicators.baseContext.relative.marketBreadths.top5.equalWeightedReturn"
+      );
+      const avoidsDiscoveredLossPocket = ethM15LevelsCrossed != null && ethM15LevelsCrossed > 1 || distanceToStopPct != null && distanceToStopPct < 5.6151907 || top5EqualWeightedReturn != null && top5EqualWeightedReturn > -0.0023580731;
+      return signal.direction === "SHORT" && advancers != null && advancers >= 2 && top5Unchanged != null && top5Unchanged <= 0 && avoidsDiscoveredLossPocket;
     }
   }
 );

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tradejs/strategy-trend-follow",
-  "version": "3.0.0",
-  "description": "TrendFollow strategy plugin for TradeJS.",
+  "version": "3.0.1",
+  "description": "ATR trailing-trend strategy using pivot structure, optional breakout and benchmark filters, and trail or opposite-signal exits for TradeJS.",
   "type": "module",
   "packageManager": "yarn@4.13.0",
   "engines": {
@@ -12,7 +12,10 @@
     "trading",
     "strategy",
     "plugin",
-    "backtesting"
+    "backtesting",
+    "ai",
+    "claude",
+    "codex"
   ],
   "homepage": "https://tradejs.dev",
   "repository": {