How To Read Planner

The FYOS Planner is a bounded recommendation layer, not a final execution engine.

What Planner Does

The Planner takes:

• Your available capital
• Current opportunity set
• Constraint configuration
• Risk parameters

And produces:

• Suggested allocation across opportunities
• Strategy mix (funding vs basis)
• Stress scenarios under adverse assumptions
• Warnings about constraints and limitations

What Planner Does Not Do

The Planner does not:

• Execute trades for you
• Guarantee the suggested returns
• Account for market movements after planning
• Override structural capacity limits
• Validate execution quality

Bounded Recommendation

The core philosophy:

Planner output is a bounded recommendation based on current data and constraints.

"Bounded" means:

• Constrained by structural capacity (edge_capacity_24h)
• Limited by configured risk parameters
• Subject to data freshness assumptions
• Not a promise of future outcomes

Planner Gating

The Planner enforces a critical rule: score alone is not enough.

A high-scoring opportunity may be rejected by Planner if:

• edge_capacity_24h is missing or insufficient
• capacity_state indicates no deployment authority
• The row violates configured concentration limits
• Trust quality is below threshold

This is intentional. Planner separates attractiveness from deployability.

Allocation Output

Planner allocation includes:

The expected return is scenario output, not validated forecast.

Strategy Mix

When both funding and basis are enabled, Planner can allocate across strategies:

• Funding: Perpetual funding arbitrage opportunities
• Basis: Cash-and-carry delivery futures opportunities

Each strategy has its own constraints:

• Basis share limits
• Expiry bucket concentration
• Inverse contract limits
• Exchange concentration

Stress Scenarios

Planner includes stress analysis:

• Baseline: Expected behavior under current assumptions
• Stress: Behavior under adverse assumptions (rate reversal, decay, etc.)
• Worst-case: Pessimistic outcome bounds

Use stress scenarios to understand downside exposure, not to predict exact outcomes.

Constraints

Typical Planner constraints include:

• Max position per opportunity: Single-position concentration limit
• Max exchange exposure: Per-exchange allocation limit
• Max basis share: Overall basis strategy limit
• Min APR threshold: Minimum return to consider
• Trust threshold: Minimum trust quality to include

Constraints protect against over-concentration and low-quality allocations.

Correct Interpretation

Right way:

• "Planner suggests this allocation given current data and my constraints"
• "This is a starting point for my decision"
• "I should verify execution feasibility independently"

Wrong way:

• "Planner guarantees this return"
• "I should execute exactly what Planner says"
• "Planner has validated execution quality"

Planner vs Simulator

Use Planner for portfolio-level decisions. Use Simulator for deep-dive scenario analysis.

When Planner Rejects Opportunities

Planner may reject high-scoring rows because:

1. Missing capacity: No edge_capacity_24h authority
2. Constraint violation: Exceeds concentration limits
3. Trust exclusion: Below trust threshold
4. Insufficient return: Below minimum APR threshold

Rejection is not a bug — it's the safety design working correctly.

Summary

• Planner produces bounded recommendations
• Recommendations depend on current data and constraints
• Score alone does not guarantee inclusion
• Capacity gating is enforced
• Output is not a trading instruction
• Use Planner as a decision support tool, not a trading bot