o
    b‰Új5  ã                   @   sª   d Z i dd“dd“dd“dd“dd	“d
d“dd“dd“dd“dd“dd“dd“dd“dd“dd“dd“dd“dddd d!œ¥Zd"d#„ Zd$d%„ Zd&d'„ Zd(d)„ Zd.d,d-„Zd+S )/a  
momentum_entry.py -- [2026-10-22] The user's design: a minute-by-minute BUY-NOW-or-WAIT decision that works TOGETHER with
the situations, using only the last 5 finished bars (no 15-bar window needed -> it can act from 9:35).

  1. SIGNAL (last 5 finished bars b1..b5, oldest -> newest)
       volume rising      mean volume of b4-b5 > mean of b1-b3
       buy share rising   buy share of b4-b5 > b1-b3, and >= min_bs (50%)
       price rising       close b5 > close b3 > close b1
  2. BLOCKERS (from the situations, avoid rules and do-not-trade list), in 3 classes:
       HARD       never overridden -- the signal itself may be fake or the trade cannot be executed well:
                  S1 flip noise, S2 weak spike, S3 block print, thin (< min_spm shares/min over 5 bars),
                  wide spread, after last_buy (14:30)
       EXTENDED   never overridden -- buying the top: S6 > 3% over the open, > 2% over VWAP
       SOFT       context that usually means "wait", but a clear positive momentum can overrule it:
                  calm stock (ATR < 8%), choppy (>= 3 Vs), S8 under resistance, S9 under the previous close,
                  low RVOL, heavy volume / recent climax, lower low by 10:30, flat bars at the low, gap > 10%
  3. MOMENTUM (all must hold to overrule SOFT blockers) -- from the 5 big-loser study (10/22): winners were an early
     push from the middle of the range, close to VWAP, on volume; losers were bought late, high in the range:
       M1 fresh push     close up >= push_pct (0.5%) over the last 5 bars
       M2 room in range  price in the lower range_max (65%) of today's range so far
       M3 not stretched  <= vwap_max (1%) over VWAP
       M4 volume         last 5 minutes' volume >= vol_x (1.5x) the stock's normal for those minutes
  DECISION each minute:  no signal -> WAIT | HARD or EXTENDED -> WAIT | SOFT only + momentum -> BUY (override) |
                         SOFT only, no momentum -> WAIT (re-checked next bar) | nothing -> BUY
Pure functions; no orders. Record-only use first (2-year test before anything live).
Úmin_bsç      à?Úmin_barsé   Úfirst_mÚ
last_buy_mi,  Úmin_spmiÐ  Úmax_spread_pctg      ð?Úmax_open_pctç      @Úmax_vwap_pctg       @Úmin_atr_pctg       @Úmax_vsé   Úmin_room_pctg      @Úprev_close_zone)r   r
   Úmin_rvolg      ø?Úheavy_vol_xÚclimax_xg      $@Úmax_gap_pctÚpush_pctgÍÌÌÌÌÌä?T)Ú	range_maxÚvwap_maxÚvol_xÚoverridec                 C   s<   t dd„ | D ƒƒ}t dd„ | D ƒƒ}|| r|||  S d S )Nc                 s   ó   � | ]	}|r|d  V  qdS )é    N© ©Ú.0Úxr   r   ú../../momentum_entry.pyÚ	<genexpr>%   ó   € z_bs.<locals>.<genexpr>c                 s   r   )é   Nr   r   r   r   r    r!   %   r"   )Úsum)ÚflÚbÚsr   r   r    Ú_bs$   s   $r(   c           	      C   sú   t | ƒ|d k rdi fS | dd… }tdd„ |dd… D ƒƒd tdd„ |dd… D ƒƒd }}t|dd… ƒt|dd… ƒ}}||koo|duoo|duoo||koo||d	 koo|d
 d |d d   kom|d d kn  }||t|dƒ ||dœfS )zSdone: finished bars; flow5: [(buy, sell)] of the same last 5 bars (None if unknown)r   FéûÿÿÿNc                 s   ó   � | ]}|d  V  qdS ©ÚvNr   r   r   r   r    r!   .   ó   € zsignal.<locals>.<genexpr>r   é   r   é   Úcr   r#   )Úvol_x5Úbs_newÚbs_old)Úlenr$   r(   Úmax)	ÚdoneÚflow5r0   r&   Úv_oldÚv_newr3   r2   Úokr   r   r    Úsignal)   s   >",.ÿr;   c              	   C   s¦  | d d }t dd„ | D ƒƒ}tdd„ | D ƒƒ}tdd„ | D ƒƒ}tdd„ | D ƒƒ}|r6|||  d d	 nd
}	|p;i  d¡p@g }
|
rRt|
td|d ƒ|d … ƒnd}tdd„ | dd … D ƒƒ}t| ƒdkrs|| d d  d d	 n|| d d  d d	 }||kr‹|| ||  nd}||d k||d k|	|d k}}}|r«|| |d knd}|o´|o´|o´|t|dƒt|dƒt|	dƒ|rÉt|| dƒnd ||||gdœfS )Néÿÿÿÿr0   c                 s   r*   ©ÚlNr   r   r   r   r    r!   7   r-   zmomentum.<locals>.<genexpr>c                 s   r*   )ÚhNr   r   r   r   r    r!   7   r-   c                 s   ó4   � | ]}|d  |d  |d  d |d  V  qdS ©r?   r>   r0   r   r,   Nr   r   r   r   r    r!   8   ó   €2 c                 s   r*   r+   r   r   r   r   r    r!   8   r-   r#   éd   g        Úvol_per_minr   r/   c                 s   r*   r+   r   r   r   r   r    r!   <   r-   r)   é   iúÿÿÿÚor   r   r   r   r   Fr.   )ÚpushÚ	range_posÚvwap_pctÚvol5_xÚM)Úminr5   r$   Úgetr4   Úround)r6   ÚrefÚmr0   ÚPÚloÚhiÚpvÚcvrI   ÚvpmÚnorm5Úv5rG   ÚrposÚm1Úm2Úm3Úm4r   r   r    Úmomentum5   s   $$&<(&ÿr^   c                    sz  g g g }}}	ˆd d }
ˆd d }|D ]}|dv r|n|dkr$|n|	  |¡ q|d ˆ d kr7|  d	¡ td
d„ ˆdd… D ƒƒd ˆ d k rO|  d¡ |dur^|ˆ d kr^|  d¡ |
| d d ˆ d krsd|vrs|  d¡ tdd„ ˆD ƒƒ}tdd„ ˆD ƒƒ}|rš|
||  d d ˆ d krš|  d¡ |p�i }| d¡r²| d¡r²|d |d  d nd}|durÃ|ˆ d k rÃ|	  d¡ | d¡}|dur×|ˆ d k r×|	  d ¡ | d!¡pÝg ‰ˆrôt‡ ‡‡fd"d„tˆƒD ƒƒrô|	  d#¡ | d¡�r||d  d d ˆ d$ k�r|	  d%¡ tˆƒd&k�r5td'd„ ˆd(d&… D ƒƒtd'd„ ˆdd(… D ƒƒk �r5|	  d)¡ d*d+„ ˆD ƒ}d,d+„ ˆD ƒ}d}td-tˆƒd. ƒD ]9}|| t||d. |d/ … ƒk�r†||d  || k�r†t|td|d( ƒ|… ƒ||  d d0k�r†|d7 }�qN|ˆ d1 k�r”|	  d2¡ t|d3d… ƒ}td4d„ ˆdd… D ƒƒd5k�r¸|
|d6 k�r¸|	  d7¡ |||	fS )8zh-> (hard, extended, soft) lists. sit_held: situation names that would hold now (S1 / S2 / S3 / S8 / S9).r<   r0   r   rF   )ÚS1ÚS2ÚS3ÚS6r#   r   zlate (after 14:30)c                 s   r*   r+   r   r   r   r   r    r!   M   r-   zblockers.<locals>.<genexpr>r)   Nr   r   Úthinr   zwide spreadrC   r	   z>3% over openc                 s   r@   rA   r   r   r   r   r    r!   S   rB   c                 s   r*   r+   r   r   r   r   r    r!   S   r-   r   z>2% over VWAPÚatr14Ú
prev_closer   ÚcalmÚ
rvol_sofarr   zlow RVOLrD   c              	   3   sP   � | ]#\}}|t ˆƒd  kr|d ˆ d tˆt|t ˆƒd ƒ dƒ kV  qdS )é   r,   r   r#   N)r4   r5   rL   )r   Úir   ©r0   r6   rV   r   r    r!   ^   s   €N zrecent climaxr   z	gap > 10%é<   c                 s   r*   r=   r   r   r   r   r    r!   b   r-   rh   zlower low by 10:30c                 S   ó   g | ]}|d  ‘qS )r>   r   r   r   r   r    Ú
<listcomp>d   ó    zblockers.<locals>.<listcomp>c                 S   rl   )r?   r   r   r   r   r    rm   d   rn   é   r   r/   g{®Gáz„?r   Úchoppyiâÿÿÿc                 s   s0   � | ]}|d  |d kr|d dkrdV  qdS )r?   r>   r,   r   r#   Nr   r   r   r   r    r!   k   s   €. r.   g)\�Âõ(ð?zflat bars at low)	Úappendr$   rM   ÚanyÚ	enumerater4   rL   Úranger5   )r6   rO   rP   ÚmetricsÚsit_heldÚ
spread_pctr0   ÚhardÚextÚsoftrQ   ÚOr'   rT   rU   ÚatrpÚrvolÚLÚHÚnvÚjÚlo30r   rj   r    ÚblockersE   sP   $
&

 
$ 
,


"
*
D
 d€
.

rƒ   r   Nc                 C   sò   i t ¥|pi ¥}|d |d k rddi fS t| ||ƒ\}	}
|	s$dd|
fS t| |||p+i t|ƒ||ƒ\}}}t| |||ƒ\}}|
j||||d� |sK|rWddd || ¡ |
fS |ri|d	 r_|sidd
d |¡ |
fS d|rudd |¡ |
fS d|
fS )z_-> (action 'BUY' / 'WAIT', why, info). m = index of the last finished bar (minutes since 9:30).r#   r   ÚWAITzfirst 5 barsz	no signal)rx   ry   rz   z	blocked: z, r   zwait for momentum: ÚBUYzmomentum overrides: z	all clear)ÚDEFAULTSr;   rƒ   Úlistr^   ÚupdateÚjoin)r6   r7   rO   rP   ru   rv   rw   Úcfgr0   r:   Úinforx   ry   rz   ÚmomÚminfor   r   r    Údecidep   s   

" rŽ   )r   NN)Ú__doc__r†   r(   r;   r^   rƒ   rŽ   r   r   r   r    Ú<module>   sX    ÿÿÿÿÿÿþþþþþýýýýýüû	+