Y-Nexus Decision Engine - Documentation

Blended Portfolio Decision-Support

Dynamic rebalancing based solely on target weight drift can lead to mechanical errors—such as buying more of a distressed business simply because its price dropped, or cutting your best-performing holdings too early.

The Y-Nexus Blended Decision Engine acts as an execution gatekeeper. It overlays your mathematical target drift with a single, consolidated recommendation blending four core pillars:

Y-VQS (Vertex Quality Score): Evaluates credit safety, capital discipline, growth compounded durability, and corporate integrity (35% weight).
Y-Vertex Value: Audits trailing sector-adjusted relative pricing multiples and absolute bubble limits (30% weight).
Y-Optics Vector (Technicals): Measures technical momentum, trend alignment strength, and volume confirmation indicators (20% weight).
Y-Radar Sentiment: Analyzes corporate insider trading, political trade disclosures, and institutional options flow (15% weight).

How Y-Nexus Works

When you review your portfolio’s target weight alignment in the Y-Nexus tab, the decision engine evaluates every asset using a two-tier mathematical structure:

1. The Continuous Confluence Index (0-100)

The engine computes a weighted composite score across all four pillars:

$$ \text{Y-Nexus Score} = (0.35 \times \text{VQS}) + (0.30 \times \text{Valuation}) + (0.20 \times \text{Technicals}) + (0.15 \times \text{Sentiment}) $$

2. Asymmetric Risk Gates (Circuit Breakers)

Before the blended score dictates execution speed, the asset passes through four hard risk circuit breakers:

Solvency Gate ($\text{VQS} < 30$): Fundamental distress overrides cheap valuation to prevent value traps.
Bubble Gate ($\text{Valuation} < 20$): Extreme multiple expansion overrides positive momentum to prevent buying manias.
Falling Knife Gate ($\text{Technicals} < 20$): Severe technical breakdown halts buying until trend stabilization.
Institutional Distribution Gate ($\text{Sentiment} < 30$): Heavy bearish flow or insider selling halts buying.

Y-Nexus Recommendation Badges

1. Accumulate (Emerald)

Trigger: The target drift indicates a Buy and $\text{Y-Nexus Score} \ge 75$ with all risk gates clear.
Action: Highly favorable buy setup. Exceptional multi-factor confluence confirms aggressive accumulation.

2. Postpone Buy (Amber)

Trigger: The target drift indicates a Buy, but either an Asymmetric Risk Gate was breached or $\text{Y-Nexus Score} < 50$.
Action: Pause buying. Do not add capital to insolvency traps, bubble valuations, falling knives, or heavy distribution.

3. Let Run (Teal)

Trigger: The target drift indicates a Sell (overweight), but $\text{Y-Nexus Score} \ge 75$ with all risk gates clear.
Action: Let winners run. Strong trend momentum and high-quality fundamentals override standard target selling.

4. Trim / Sell (Rose)

Trigger: The target drift indicates a Sell and $\text{Y-Nexus Score} < 40$, or an Asymmetric Risk Gate was breached.
Action: Fully supported trim/sell to reduce risk exposure.

5. Hold / Align (Gray)

Trigger: Position is fully aligned with target allocation without severe risk warnings.

Inspecting the Scorecard

Hovering over any Y-Nexus Confluence badge opens a premium hover scorecard tooltip displaying the exact continuous breakdown:

The Y-Nexus Score (e.g. [Y-Nexus Score: 78.4]).
The custom Nexus Explanation audit log.
Y-VQS Score & Rating (e.g., Healthy (68.0)).
Y-Vertex Value Score & Rating (e.g., Undervalued (82.0)).
Y-Optics Vector Score & Rating (e.g., Buy (+65.6)).
Y-Radar Sentiment Score (e.g., 72).
Theoretical Action derived from weight drift.

Integration with Y-Nexus Capital Flow

The Y-Nexus Decision Engine is directly integrated into the Y-Nexus Capital Flow planner. When deploying new cash to rebalance your holdings without selling:

Assets are prioritized into Accumulate (Group 1), Buy (Group 2), and Postpone Buy (Group 3).
The cash is water-filled starting from Group 1 down to Group 3 to ensure your safest, highest-quality assets are funded first.
Surplus cash is routed exclusively to healthy targets (Group 1 & Group 2), systematically bypassing risk-heavy or expensive holdings.