ó
    o j8&  ã                  ó†   • S r SSKJr  SSKJr  SSKJr  SSKrSSKr	\ " S S5      5       r
S rS	 r    SS
 jr  SS jrg)a	  
Suite19 exact expanding-fold reuse.

A previous fold may be reused ONLY if every previous historical row maps
exactly to the current expanding fold and all chronology-sensitive inputs
are identical.

A mismatch disables reuse and falls back to normal computation.
é    )Úannotations)Ú	dataclass)ÚAnyNc                  ó€   • \ rS rSr% S\S'   S\S'   S\S'   S\S'   S	\S
'   S\S'   S\S'   S\S'   S\S'   S\S'   S rSrg)ÚIncrementalFoldContexté   ÚintÚprevious_foldÚcurrent_foldr   Úprevious_histz
np.ndarrayÚprevious_to_currentztuple[float, ...]Úshared_blocksÚboolÚexactÚstrÚreasonÚ
key_schemeÚmapped_rowsÚmapping_sha1c           
     óH  • [        U R                  5      [        U R                  5      [        U R                  5      [        U R                  5      [        U R                  5      [        U R                  5      [        U R                  5      [        U R                  5      S.$ )N)r
   r   r   r   r   r   r   r   )r	   r
   r   r   r   r   r   r   r   Úlistr   r   )Úselfs    Úsuite19_incremental.pyÚsummaryÚIncrementalFoldContext.summary)   sv   € ä  ×!3Ñ!3Ó4Ü × 1Ñ 1Ó2Ü˜$Ÿ*™*Ó%Ü˜$Ÿ+™+Ó&Ü˜dŸo™oÓ.Ü˜t×/Ñ/Ó0Ü! $×"4Ñ"4Ó5Ü × 1Ñ 1Ó2ñ	
ð 		
ó    © N)Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__annotations__r   Ú__static_attributes__r   r   r   r   r      sB   ‡ àÓØÓàÓð $Ó#à$Ó$àƒKØƒKàƒOàÓØÓõ

r   r   c           	     ó¦  • [        U R                  5      n[        R                  " U R                  [
        5      n[        U SS5      nUbu  [        U5      U:X  af  [        R                  " U5      n[        U5       Vs/ s H  nS[        X%   5      [        XE   5      4PM      nn[        [        U5      5      U:X  a  US4$ [        R                  " U R                  [        5      n[        R                  " U R                  [        5      n[        R                  " U R                  [        5      n	0 n
/ n[        U5       He  n[        X%   5      [        Xu   5      [        X…   5      [        X•   5      4nU
R                  US5      nUS-   X«'   UR                  S/UQUP75        Mg     [        [        U5      5      U:w  a  [!        S5      eUS4$ s  snf )	z¥
Construct stable row identities.

Prefer faculty + row_index when row_index is unique.
Otherwise use:
    faculty + student + course + target_semester + occurrence
Ú	row_indexNzfaculty+row_indexr   é   Úidentityz5Could not construct unique historical row identities.z*faculty+student+course+semester+occurrence)ÚlenÚyÚnpÚasarrayÚfaculty_idxr	   ÚgetattrÚranger   ÚsetÚ
student_idÚobjectÚ	course_idÚtarget_semesterÚgetÚappendÚRuntimeError)ÚbundleÚnÚfacr%   ÚriÚiÚkeysÚsidÚcidÚsemesterÚcountsÚbaseÚ
occurrences                r   Ú_stable_keysrC   6   së  € ô 	ˆF�H‰H‹€Aä
�*Š*Ø×ÑÜó€Cô
 ØØØó€Ið 	ÑÜ�	‹N˜aÓä�ZŠZ˜	Ó"ˆô ˜1”Xó
ò �ð	 Ü�C‘F“Ü�B‘E“
óñ
 ð 	ð 
ô Œs�4‹y‹>˜QÓàØ#ðð ô
 �*Š*Ø×ÑÜó€Cô
 �*Š*Ø×ÑÜó€Cô
 �zŠzØ×ÑÜó€Hð
 €FØ€Dä�1ŽXˆä�‘‹KÜ�‘‹KÜ�‘‹KÜ�‘Óð	
ˆð —Z‘ZØØó
ˆ
ð ˜‰Nð 	‰ð 	�‰àðàðð ñö	
ñ# ô2 Œ3ˆt‹9ƒ~˜ÓÜð)ó
ð 	
ð 	ð"ðð ùòA
s   Á=%Gc           
     ó.  • [         R                  " U 5      n [         R                  " U5      nU R                  UR                  :w  a  g[         R                  " U R                  [         R
                  5      (       aU  [         R                  " UR                  [         R
                  5      (       a!  [        [         R                  " U USSSS95      $ [        [         R                  " U R                  [        5      UR                  [        5      5      5      $ )NFg        T)ÚrtolÚatolÚ	equal_nan)r*   r+   ÚshapeÚ
issubdtypeÚdtypeÚnumberr   ÚallcloseÚarray_equalÚastyper   )ÚaÚbs     r   Ú_equal_arrayrQ   š   sÌ   € Ü
�
Š
�1‹€AÜ
�
Š
�1‹€Aà‡w�w�!—'‘'ÓØô 	�ŠØ�G‰GÜ�I‰I÷	
ñ 	
ô �MŠMØ�G‰GÜ�I‰I÷
ñ 
ô
 Ü�KŠKØØØØØñó
ð 	
ô Ü
�ŠØ�H‰H”S‹MØ�H‰H”S‹Mó	
óð r   c                óÎ  •  [        U 5      u  pE[        U5      u  pg[        U5       V	V
s0 s H  u  pšX©_M	     nn	n
[        R                  " U V
s/ s H  n
UR                  U
S5      PM     sn
[        S9n[        R                  " US:  5      (       a\  [        [        R                  " US:  5      5      n[        UUU USSU S3U SU 3[        [        R                  " US:¬  5      5      S	S
9
$ SU R                  UR                  U   4SU R                  UR                  U   4SU R                   UR                   U   4SU R"                  UR"                  U   4SU R$                  UR$                  U   4SU R&                  UR&                  U   4SU R(                  UR(                  U   4SU R*                  UR*                  U   4SU R,                  UR,                  U   4/	nU H=  u  nnn[/        UU5      (       a  M  [        UUU USSSU 3U SU 3[        U5      S	S
9
s  $    [1        S [3        S [        R4                  " [        R                  " U R                  [6        5      5       5       5       5       5      n[8        R:                  " UR=                  [        R>                  5      RA                  5       5      RC                  5       n[        UUU UUSSU SU 3[        U5      US
9
$ ! [         a`  n[        UUU [        R                  " [        U R                  5      S[        S9SSS[        U5      R                   SU 3SSS	S
9
s SnA$ SnAff = fs  sn
n	f s  sn
f )zj
Prove that previous_hist is an exact historical subset
of current_hist.

No target labels are inspected.
éÿÿÿÿ©rJ   r   Fzrow_identity_error: z: Úunavailabler   Ú ©
r
   r   r   r   r   r   r   r   r   r   Nz: previous historical rows are absent from the current foldz->r)   Úblocksr,   ÚflatÚteacherÚmechanism_targetsr0   r2   r3   zhistorical field mismatch: c              3  ó8   #   • U  H  n[        U5      v •  M     g 7f©N©Úfloat©Ú.0Úxs     r   Ú	<genexpr>Ú,build_incremental_context.<locals>.<genexpr>n  s!   é € ð ò	
ˆAô 	ˆa�ˆò	
ùó   ‚c              3  ó`   #   • U  H$  n[         R                  " U5      (       d  M   Uv •  M&     g 7fr]   ©r*   Úisfinite©ra   Úvs     r   rc   rd   p  ó*   é € ð 	
ò�ô �{Š{˜1�~÷ ‰Aòùó   ‚.¥	.Tz exact historical subset verified)"rC   Ú	Exceptionr   r*   Úfullr(   r)   r	   Útyper   Ú	enumerater+   r4   ÚanyÚsumrX   r,   rY   rZ   r[   r0   r2   r3   rQ   ÚtupleÚsortedÚuniquer_   ÚhashlibÚsha1rN   Úint64ÚtobytesÚ	hexdigest)r   Úcurrent_histr
   r   Ú	prev_keysÚprev_schemeÚcur_keysÚ
cur_schemeÚexcr;   ÚkeyÚcurrent_lookupÚmappingÚmissingÚchecksÚnameÚoldÚnewr   Údigests                       r   Úbuild_incremental_contextrŠ   ½   s.  € ð 
äØóñ 	ˆ	ô Øóñ 	ˆô< �XÔôò ñ ˆAð 	Šáð ñ ô �jŠjñ !ó	
ò
 !�ð	 ×ÑØØöñ !ñ	
ô ñ	€Gô 
‡v‚vˆg˜‰k×ÑÜÜ�FŠF�7˜Q‘;Óó
ˆô &Ø'Ø%Ø'Ø 'ØØà�)ð ð ð
 �-Ø�Z�Lð"ô Ü—’�w !‘|Ó$óð ñ'
ð 	
ð0 Ø�O‰OØ�N‰N˜7Ñ#ð	
ð Ø× Ñ Ø×Ñ Ñ(ð	
ð Ø×%Ñ%Ø×$Ñ$Øñð	
ð Ø×ÑØ×Ñ˜gÑ&ð	
ð Ø×!Ñ!Ø× Ñ  Ñ)ð	
ð  Ø×+Ñ+Ø×*Ñ*Øñð	
ð Ø×$Ñ$Ø×#Ñ#Øñð	
ð Ø×#Ñ#Ø×"Ñ"Øñð	
ð Ø×)Ñ)Ø×(Ñ(Øñð	
ðc8€Fót !‰ˆˆc�3ÜØØ÷
ó 
ô *à!à à!àØ Øð!Ø!% ð(ð #�mØ˜˜ð&ô   ›LØñ)ò ñ !ô8 ñ äñ 	
ä—Y’YÜ—
’
Ø!×(Ñ(Üóôó	
ô 	
óó €Mô �\Š\Ø�‰Ü�H‰Hó	
ç
‰'‹)ó÷ �iƒkð	 ô "Ø#Ø!Ø#Ø#Ø#Øðð ˆmØ��ðô ˜“LØñ!ð øôW ó 
Ü%Ø'Ø%Ø'Ü "§¢Ü�M—O‘OÓ$ØÜñ!ð
 Øà&Ü˜“9×%Ñ%Ð& b¨¨ð/ð %ØØñ#
õ 	
ûð
üó*ùò	
s)   ‚K/ ªMÁM"Ë/
MË9AMÍMÍMc                óà  • [         R                  " [        U R                  5      [        S9n[        S [        S [         R                  " [         R                  " U R                  [        5      5       5       5       5       5      n[        R                  " UR                  [         R                  5      R                  5       5      R!                  5       n[#        UUU UUSSS[        U5      US9
$ )z|
Same-fold identity mapping.

Used when production seed 42 reuses its already-computed
historical selection representation.
rT   c              3  ó8   #   • U  H  n[        U5      v •  M     g 7fr]   r^   r`   s     r   rc   Ú#identity_context.<locals>.<genexpr>¥  s!   é € ð ò	
ˆAô 	ˆa�ˆò	
ùre   c              3  ó`   #   • U  H$  n[         R                  " U5      (       d  M   Uv •  M&     g 7fr]   rg   ri   s     r   rc   r�   §  rk   rl   Tzsame-fold exact identityr'   rW   )r*   Úaranger(   r)   r	   rs   rt   ru   r+   rX   r_   rv   rw   rN   rx   ry   rz   r   )ÚhistÚfoldrƒ   rX   r‰   s        r   Úidentity_contextr’   –  sÑ   € ô �iŠiÜˆD�F‰F‹Üñ€Gô
 ñ äñ 	
ä—Y’YÜ—
’
Ø—K‘KÜóôó	
ô 	
óó €Fô �\Š\Ø�‰Ü�H‰Hó	
ç
‰'‹)ó÷ �iƒkð	 ô "ØØØØ#ØØà&àÜ˜“LØñð r   )r
   r	   r   r	   )r‘   r	   )Ú__doc__Ú
__future__r   Údataclassesr   Útypingr   rv   Únumpyr*   r   rC   rQ   rŠ   r’   r   r   r   Ú<module>r˜      sl   ðñõ #å !Ý Û ã ð ÷
ð 
ó ð
ò@aòH ðFVð ðVð ô	Vðr0à
õ0r   