🐦 HERON v1.0.0 — ETH Trend Follower (SM-confirmed)

Onboarding tier. ETH only. Long OR short. When ETH is in a 4h trend AND Senpi's Smart-Money leaderboard agrees with that direction, Heron opens a single conviction position and lets the DSL ratchet manage it.

Why this strategy exists

Heron is the default first-trade strategy for new Senpi users:

• One asset — ETH. No multi-asset whitelist to tune, no XYZ universe to filter, no funding regime to interpret.
• One question — "Is ETH trending?" Heron answers by looking at the 4h candle structure (higher-lows = bullish, lower-highs = bearish).
• One direction gate — "Does Smart Money agree?" Heron pulls Senpi's leaderboard concentration and requires top-trader positioning to align with the trend before firing.
• One exit mechanism — DSL. Phase 1 max_loss 20% floor + Phase 2 wide ratchet ladder. Time-cuts all disabled — winning trends ride.

If both gates pass and the score clears the floor, Heron emits ONE signal per qualifying setup. Max 2 entries per day. 4h cooldown per asset.

CRITICAL RULES

RULE 1: Producer enters. DSL exits. Producer NEVER closes.

The producer has no close_position call site. All exits flow through the DSL Phase 1 max_loss / Phase 2 ratchet retrace. This is the same structural guarantee as Bison v3.0.1 and Wolverine v6.0.0.