Editing Alpha Research5 (section)

=== Layer 2: Market State Analysis ===

'''Purpose:''' Classify current market conditions into actionable states

'''File:''' <code>src/components/market_state_analysis.py</code>

'''Market States:'''
<pre>
+-------------------+--------------------------------+------------------+
| Market State      | Characteristics                | Trading Action   |
+-------------------+--------------------------------+------------------+
| range_bound       | Price oscillating, no clear    | Trade reversals  |
|                   | trend, MA21 relatively flat    | at range edges   |
+-------------------+--------------------------------+------------------+
| creeper_move      | Slow, grinding trend with      | Trade WITH trend |
|                   | small candles, steady MA21     | on pullbacks     |
+-------------------+--------------------------------+------------------+
| narrow_low_volume | Tight range, reduced volume,   | CAUTION - await  |
|                   | consolidation pattern          | breakout         |
+-------------------+--------------------------------+------------------+
| trending          | Strong directional move,       | Trade WITH trend |
|                   | clear MA separation            | aggressively     |
+-------------------+--------------------------------+------------------+
</pre>

'''Detection Algorithm:'''
<pre>
1. Calculate recent volatility (ATR or range)
2. Calculate MA21 slope
3. Calculate volume relative to average
4. Apply classification rules:

IF slope < threshold AND range tight THEN narrow_low_volume
ELIF slope small AND trend present THEN creeper_move
ELIF volatility high AND no trend THEN range_bound
ELIF strong directional move THEN trending
</pre>

'''Output:''' <code>MarketStateResult</code>
* <code>market_state</code>: Enum value
* <code>volatility_metrics</code>: ATR, range data
* <code>trend_phase</code>: early/middle/late/exhaustion

----