ó
    =±Ûj8¬  ã                  óà  • S r SSKJ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KJr  SSKrSSKJr  SSKrSSKrSSKrS	rS
r\\-   r1 SkrSrSr\R6                  " SSS9r1 SkrS rS rS r S r!S r"S r#S r$S r%S r&S7S jr'S r(S r)S r*S8S jr+S  r,S! r-S" r.\" S#S$9 " S% S&5      5       r/S' r0S( r1S) r2S* r3S+ r4S, r5S7S- jr6 " S. S/5      r7S0 r8S1 r9 " S2 S3\:5      r; " S4 S5\5      r<S6 r=g)9a  Read the native AQ canonical caches without requiring intermediate exports.

The input joblib artifacts are trusted local files. They are read, never written.
Preparation scans one cache at a time, retains identities/grades rather than raw
matrices, and produces a re-iterable collection of metadata-only cohort handles.
A handle loads its own train/test matrices on the first corresponding access.

AQ caches expose semester codes, not certified grade-release dates. Timestamps
below are INTERNAL ORDINAL CARRIERS, not actual dates: a semester's origin is
1900-01-01 UTC plus its global ordinal in days, and its release is twelve hours
later. This represents the inherited assumption that earlier-semester observed
grades are available by the next semester; it cannot establish publication time.
é    )Úannotations©Údefaultdict)ÚSequence)Ú	dataclassN)ÚPath©Úquote)ÚSoTinChiÚSoTietMHÚ
SoTietTuanÚSiSoMaxÚSiSoMinÚ
KhgTinhDTBÚIsMHTNÚIsMonKTÚIsMHKNÚ
IsMHDacThuÚIsGDTiengAnhÚIsMonNgoaiNgu)Ú
hist_countÚ	hist_meanÚhist_stdÚhist_fail_rateÚhist_pass_rate>   ÚIDMHÚIDSVÚIDKQDKÚIDToHocÚ	sample_idÚbase_row_idÚtarget_NHHKÚdataset_splitÚtarget_grade4Útarget_statusÚtarget_grade10Úis_summer_targetÚtarget_IDCongDiemÚstudent_faculty_keyÚcourse_cluster_labelÚstudent_faculty_nameÚtarget_semester_ordinalzŽObserved previous-semester numeric grades are assumed available by the next semester; AQ canonical caches provide no grade-release timestamps.z‚INTERNAL ORDINAL CARRIERS, not actual dates: 1900-01-01 UTC + semester ordinal days; labels/events available at origin + 12 hours.z
1900-01-01ÚUTC)Útz>	   Ú ÚinfÚnanÚnatÚnoneÚnullú+infú-infú<na>c                óF  • U b8  U [         R                  L d%  [        U [        [        R
                  45      (       a  [        U SU < 35      e[        U [        [        R                  45      (       a  [        [        U 5      5      $ [        U [        [        R                  45      (       ar  [        R                  " U 5      (       d  [        U SU < 35      e[        U 5      R                  5       (       a  [        [        U 5      5      $ [        [        U 5      5      $ [        U 5      R                  5       nUR                  5       [         ;   a  [        U SU < 35      e["        R$                  " SU5      (       a&  [        [        UR'                  S5      S   5      5      $ U$ )Nz): meaningful nonmissing ID required, got z%: finite nonmissing ID required, got z[+-]?(?:0|[1-9][0-9]*)\.0+Ú.r   )ÚpdÚNAÚ
isinstanceÚboolÚnpÚbool_Ú
ValueErrorÚintÚintegerÚstrÚfloatÚfloatingÚisfiniteÚ
is_integerÚstripÚcasefoldÚ_MISSING_TEXTÚreÚ	fullmatchÚsplit)ÚvalueÚnameÚtexts      ÚC/root/disk_3tb/earlywarning/30072026/suite35_pace/pace/aq_native.pyÚ_canonical_idrR   6   s6  € Ø�}˜¤§¡š¬*°U¼TÄ2Ç8Á8Ð<L×*MÑ*MÜ˜D˜6Ð!JÈ5É)ÐTÓUÐUÜ�%œ#œrŸz™zÐ*×+Ñ+Ü”3�u“:‹ÐÜ�%œ%¤§¡Ð-×.Ñ.Ü�{Š{˜5×!Ñ!Ü ˜vÐ%JÈ5É)ÐTÓUÐUÜ"'¨£,×"9Ñ"9×";Ñ";Œs”3�u“:‹ÐRÄÄUÈ5Ã\ÓARÐRÜˆu‹:×ÑÓ€DØ‡}�}ƒœ-Ó'Ü˜D˜6Ð!JÈ5É)ÐTÓUÐUä	‡|‚|Ð1°4×8Ñ8Ü”3�t—z‘z #“ qÑ)Ó*Ó+Ð+Ø€Kó    c                ó  • U b  U [         R                  L a  g[        U [        [        R
                  45      (       a  [        [        R                  " U 5      5      $ [        U 5      R                  5       R                  5       S;   $ )NT>   r/   r1   r2   r3   r4   r7   )r:   r;   r<   rD   r>   rE   r=   ÚisnanrC   rH   rI   )rN   s    rQ   Ú_missingrV   H   s_   € Ø�}˜¤§¡šØÜ�%œ%¤§¡Ð-×.Ñ.Ü”B—H’H˜U“OÓ$Ð$Üˆu‹:×ÑÓ×&Ñ&Ó(Ð,VÑVÐVrS   c                óX  •  [         R                  " U [        S9nUR
                  S:w  dU  [         R                  " U5      R                  5       (       a,  U[         R                  " U5      :g  R                  5       (       a  [	        U S35      eU[         R                  " [         R                  5      R                  :  US:¬  -  R                  5       (       a  [	        U S35      eUR                  [         R                  5      $ ! [        [        4 a  n[	        U S35      UeS nAff = f)N©Údtypez!: numeric integer values requiredé   z0: finite one-dimensional integer values requiredg      àCz!: integer outside supported range)r>   ÚasarrayrD   Ú	TypeErrorr@   ÚndimrF   ÚallÚfloorÚanyÚiinfoÚint64ÚminÚastype)rN   rO   ÚresultÚexcs       rQ   Ú	_integersrg   P   sò   € ðNÜ—’˜E¬Ñ/ˆð ‡{�{�aÓœrŸ{š{¨6Ó2×6Ñ6×8Ñ8¸VÄrÇxÂxÐPVÓGWÑ=W×<\Ñ<\×<^Ñ<^Ü˜D˜6Ð!QÐRÓSÐSØ	”"—(’(œ2Ÿ8™8Ó$×(Ñ(Ñ	(¨V°vÑ-=Ñ>×CÑC×EÑEÜ˜D˜6Ð!BÐCÓDÐDØ�=‰=œŸ™Ó"Ð"øô ”zÐ"ó NÜ˜D˜6Ð!BÐCÓDÈ#ÐMûðNús   ‚D ÄD)ÄD$Ä$D)c                óž   • [        [        U /S5      S   5      n[        US5      u  p#US::  d  US;  a  [        SU < S35      eUS-  U-   S-
  $ )	zCAQ year*10+term code -> globally comparable ordinal, term in 1,2,3.ztarget_NHHK semesterr   é
   )rZ   é   é   z!Unparseable target_NHHK semester z$; expected year*10+term (term 1,2,3)rk   rZ   )rA   rg   Údivmodr@   )ÚcodeÚnumberÚyearÚterms       rQ   Úsemester_ordinalrq   \   s`   € ä”˜D˜6Ð#9Ó:¸1Ñ=Ó>€FÜ˜ Ó#�J€DØˆqƒy�D 	Ó)ÜÐ<¸T¹HÐDhÐiÓjÐjØ�!‰8�d‰?˜QÑÐrS   c           
     óÔ  • SU ;  a  [        U S35      e[        U S   U S35      n[        R                  " U5       Vs0 s H  n[	        U5      [        U5      _M     nn[        R                  " U Vs/ s H  n[        [	        U5      5      PM     sn[        S9[        R                  " U Vs/ s H  oT[	        U5         PM     sn[        R                  S94$ s  snf s  snf s  snf )Nr"   z%: missing required target_NHHK columnz.target_NHHKrX   )
r@   rg   r>   ÚuniquerA   rq   r[   rC   Úobjectrb   )ÚframeÚsourceÚcodesrm   rs   Úcs         rQ   Ú
_semestersry   e   sÊ   € Ø˜EÓ!Ü˜F˜8Ð#HÐIÓJÐJÜ�e˜MÑ*¨v¨h°lÐ,CÓD€EÜ<>¿IºIÀeÔ<LÓMÒ<L°DŒc�$‹iÔ)¨$Ó/Ò/Ñ<L€FÐMÜ�:Š:©EÓ2ªE q”sœ3˜q›6–{©EÑ2¼&ÑAÄ2Ç:Â:ÑglÓNmÒglÐbcÔVYÐZ[ÓV\Ì~ÑglÑNmÔuw×u}Ñu}ÑC~Ð~Ð~ùò NùÚ2ùÒNms   ¿CÁ4C Â/C%
c                ó:   • [         [        R                  " U SS9-   $ )NÚD)Úunit)Ú_EPOCHr:   Úto_timedelta)Úorders    rQ   Ú_originr€   m   s   € Ü”B—O’O E°Ñ4Ñ4Ð4rS   c                ó¦  •  [         R                  " U [        S9nUR
                  U4:w  dS  [         R                  " U5      R                  5       (       a*  [         R                  " US5      R                  5       (       d  [	        U S35      eUR                  [         R                  5      $ ! [        [        4 a  n[	        U S35      UeS nAff = f)NrX   z : binary ytr/yte labels required)ç        ç      ð?zA: binary labels must align to all canonical frame rows; failure=1)r>   r[   rD   r\   r@   ÚshaperF   r^   Úisinrd   Úint8)rN   Únrv   Úvaluesrf   s        rQ   Ú_labelsr‰   q   s­   € ðOÜ—’˜E¬Ñ/ˆð ‡|�|˜�tÓ¤2§;¢;¨vÓ#6×#:Ñ#:×#<Ñ#<ÄBÇGÂGÈFÐT\ÓD]×DaÑDa×DcÑDcÜ˜F˜8Ð#dÐeÓfÐfØ�=‰=œŸ™Ó!Ð!øô	 ”zÐ"ó OÜ˜F˜8Ð#CÐDÓEÈ3ÐNûðOús   ‚B, Â,CÂ<CÃCc                óÒ  • SU ;  a.  [         R                  " [        U 5      [         R                  5      $ U S   n[        R
                  " USS9R                  [        [         R                  S9n[         R                  " U Vs/ s H  n[        U5      PM     sn[        S9n[         R                  " U5      U) -  R                  5       (       a  [        U S35      e[         R                  " U5      R                  5       (       d  US:  US:„  -  R                  5       (       a  [        U S	35      e[         R                  " U5      nUb—  XtS
:  R!                  [         R"                  5      U:g  -  R                  5       (       a]  [         R$                  " XtS
:  R!                  [         R"                  5      U:g  -  5      S S R'                  5       n[        U SU S35      eU$ s  snf )Nr&   Úcoerce©Úerrors©rY   Úna_valuerX   zO: target_grade10 has nonnumeric nonmissing values; provide numeric 0..10 gradesr   ri   zH: target_grade10 grade outside 0..10; missing grades must remain missingé   é   z-: grade/failure consistency violated at rows z; failure means grade < 5)r>   ÚfullÚlenr1   r:   Ú
to_numericÚto_numpyrD   r[   rV   r=   rU   r`   r@   ÚisinfrF   rd   r†   ÚflatnonzeroÚtolist)	ru   Úlabelsrv   Úrawre   ÚvÚmissingÚknownÚrowss	            rQ   Ú_gradesrŸ   {   sŽ  € Ø˜uÓ$Ü�wŠw”s˜5“z¤2§6¡6Ó*Ð*Ø
Ð Ñ
!€CÜ�]Š]˜3 xÑ0×9Ñ9ÄÔPR×PVÑPVÐ9ÐW€FÜ�jŠj©sÓ3ªs¨!œ( 1ž+©sÑ3¼4Ñ@€GÜ
�Š�Ó˜G˜8Ñ#×(Ñ(×*Ñ*Ü˜F˜8Ð#rÐsÓtÐtÜ	‡x‚x�Ó×Ñ×Ñ 6¨A¡:°&¸2±+Ñ">×!CÑ!C×!EÑ!EÜ˜F˜8Ð#kÐlÓmÐmÜ�KŠK˜Ó€EØÑ˜u°!©×(;Ñ(;¼B¿G¹GÓ(DÈÑ(NÑO×TÑT×VÑVÜ�~Š~˜e°©
×':Ñ':¼2¿7¹7Ó'CÀvÑ'MÑNÓOÐPRÐQRÐS×ZÑZÓ\ˆÜ˜F˜8Ð#PÐQUÐPVÐVoÐpÓqÐqØ€Mùò 4s   ÂG$c                ó’  • SU ;  a  [        U S35      e[        U S   5      nU(       a8  [        S U 5       5      (       d!  [        [	        U5      5      [        U5      :w  a  [        U S35      e[	        U5      [
        -  nU(       a  [        U S[        U5       35      e[        S U 5       5      (       a  [        U S35      eU$ )NÚfeature_namesz': canonical cache missing feature_namesc              3  ó„   #   • U  H6  n[        U[        5      (       + =(       d    UR                  5       (       + v •  M8     g 7f©N)r<   rC   rH   ©Ú.0r‡   s     rQ   Ú	<genexpr>Ú!_feature_names.<locals>.<genexpr>�   s*   é € ÐOÊÀAœJ q¬#Ó.Ô.×?°a·g±g³i´-Ô?Êùs   ‚>A z/: feature_names must be nonempty unique stringsz3: identity/target metadata found in feature_names: c              3  óB   #   • U  H  oR                  S 5      v •  M     g7f)úcourse::N©Ú
startswithr¤   s     rQ   r¦   r§   •   s   é € Ð
3ªU¨�<‰<˜
×#Ð#ªUùó   ‚z;: raw feature names may not use reserved course:: namespace)r@   Úlistr`   r“   ÚsetÚCSV_EXCLUDEÚsorted)Úcacherv   ÚnamesÚ	forbiddens       rQ   Ú_feature_namesr´   Œ   sÆ   € Ø˜eÓ#Ü˜F˜8Ð#JÐKÓLÐLÜ��Ñ'Ó(€EÞ”CÑOÉÓO×OÑOÔSVÔWZÐ[`ÓWaÓSbÔfiÐjoÓfpÓSpÜ˜F˜8Ð#RÐSÓTÐTÜ�E“
œ[Ñ(€IÞÜ˜F˜8Ð#VÔW]Ð^gÓWhÐViÐjÓkÐkÜ
Ñ
3©UÓ
3×3Ñ3Ü˜F˜8Ð#^Ð_Ó`Ð`Ø€LrS   c                ó¤  • X;  a  [        U SU 35      e[        R                  " X   5      nUR                  S:w  d  UR                  U[        U5      4:w  a,  [        U SU SU S[        U5       SUR                   3	5      eUc  g [        U5       VVs0 s H  u  pxX‡_M	     n	nn [        R                  " US S 2U Vs/ s H  o‰U   PM	     sn4   [        S9n
[        R                  " U
5      R                  5       (       a  [        U SU S	35      eU
$ s  snnf s  snf ! [        [         [        4 a  n[        U SU S35      UeS nAff = f)
Nú: missing canonical rj   r9   z: full-frame-aligned shape (z, z) required; got rX   z1: common raw features must be numeric and presentz9: infinite raw features; use finite numeric values or NaN)r@   r>   r[   r]   r„   r“   Ú	enumeraterD   r\   ÚKeyErrorr–   r`   )r±   Úkeyr‡   r²   rv   ÚcommonÚmatrixÚirO   Úlookupre   rf   s               rQ   Ú_matrixr¾   š   sR  € Ø
ÓÜ˜F˜8Ð#7¸°uÐ=Ó>Ð>Ü�ZŠZ˜™
Ó#€FØ‡{�{�aÓ˜6Ÿ<™<¨A¬s°5«z¨?Ó:Ü˜F˜8 1 S EÐ)EÀaÀSÈÌ3ÈuË:È,ÐVfÐgm×gsÑgsÐftÐuÓvÐvØ�~àÜ%.¨uÔ%5Ô6Ò%5™'˜!ˆdŠgÑ%5€FÑ6ðfÜ—’˜F¢1ÁÓ&GÂ¸¨d¤|ÁÑ&GÐ#GÑHÔPUÑVˆô 
‡x‚x�Ó×Ñ×ÑÜ˜F˜8 1 S EÐ)bÐcÓdÐdØ€Mùó 7ùâ&GøÜ”z¤8Ð,ó fÜ˜F˜8 1 S EÐ)ZÐ[Ó\ÐbeÐeûðfús0   ÂDÂ)D# ÃDÃD# ÄD# Ä#EÄ8E
Å
Ec           	     ó°  • X   n[         R                  " USS9R                  [        [        R
                  S9n[        R                  " U5      [        R                  " U Vs/ s H  n[        U5      PM     sn5      ) -  nUR                  5       (       d)  [        R                  " U5      R                  5       (       a  [        U SU S35      eU$ s  snf )Nr‹   rŒ   rŽ   r9   z+: numeric values or missing values required)r:   r”   r•   rD   r>   r1   rU   r[   rV   r`   r–   r@   )ru   rO   rv   rš   re   r›   Ú	malformeds          rQ   Ú_numeric_columnrÁ   ­   s¨   € Ø
‰+€CÜ�]Š]˜3 xÑ0×9Ñ9ÄÔPR×PVÑPVÐ9ÐW€FÜ—’˜Ó ¤B§J¢JÁSÓ/IÂSÀ´¸¶ÁSÑ/IÓ$JÐ#JÑJ€IØ‡}�}‡�œ"Ÿ(š( 6Ó*×.Ñ.×0Ñ0Ü˜F˜8 1 T FÐ*UÐVÓWÐWØ€Mùò 0Js   Á#C
c                óZ  • [         R                  " [        U5      [        [        5      4[         R                  5      n[        [        5       H°  u  pgXq;   a  [        XU5      US S 2U4'   M  Xs;   d  M&   [         R                  " X   5      S S 2UR                  U5      4   R                  [        5      US S 2U4'   [         R                  " US S 2U4   5      R                  5       (       d  M¡  [        U SU S35      e   U$ ! [        [        4 a  n[        U SU S35      UeS nAff = f)Nr9   z$: raw static feature must be numericz : infinite static course feature)r>   r’   r“   ÚCOURSE_STATICr1   r·   rÁ   r[   Úindexrd   rD   r\   r@   r–   r`   )	r±   ru   r¹   r²   rv   re   ÚjrO   rf   s	            rQ   Ú_static_featuresrÆ   ¶   s  € Ü�WŠW”c˜%“j¤#¤mÓ"4Ð5´r·v±vÓ>€Fäœ]Ö+‰ˆØ‹=Ü*¨5¸Ó?ˆF’1�a�4‹LØ�]ðbÜ!Ÿzšz¨%©*Ó5²a¸¿¹ÀTÓ9JÐ6JÑK×RÑRÔSXÓY�’q˜!�t‘ô �xŠx˜šq !˜t™Ó%×)Ñ)×+Ó+Ü  F 8¨1¨T¨FÐ2RÐ!SÓTÐTñ ,ð €Møô	 œzÐ*ó bÜ  F 8¨1¨T¨FÐ2VÐ!WÓXÐ^aÐaûðbús   Á4ADÄD*ÄD%Ä%D*c           
     ó  • S H  nX ;  d  M
  [        U SU S35      e   [        R                  " U S    Vs/ s H  n[        X1 S35      PM     sn[        S9n[        R                  " U S    Vs/ s H  n[        X1 S35      PM     sn[        S9n[        X5      u  pgS	U ;   aK  [        R                  " U S	    Vs/ s H#  n[        U5      (       d  [        X1 S
35      OSPM%     sn[        S9O"[        R                  " [        U 5      S[        S9n[        [        5      n	/ [        [        5      pº[        [        XEXh5      5       HÛ  u  nu  pÞnnXÞUU4nU	U   nU	U==   S-  ss'   S Hw  nX ;   d  M
  [        X   R                  U   5      (       a  M+  [        X   R                  U   U SU 35      nU
R                  US-   [        USS9-   5        X²==   S-  ss'     Mœ     U
R                  SSR!                  S U 5       5      -   SU 3-   5        US==   S-  ss'   MÝ     [        [#        U
5      5      [        U
5      :w  a  [        U S35      eSU ;   aK  [        R                  " U S    Vs/ s H#  n[        U5      (       a  S O[        X1 S35      PM%     sn[        S9O"[        R                  " [        U 5      S [        S9n[%        [        R                  " U
[        S9XEXgUUS9[%        U5      4$ s  snf s  snf s  snf s  snf )N)r   r   z: missing required z6; course_target is 17 numeric metadata, not course IDsr   z.IDSVrX   r   z.IDMHr   z.IDToHocr/   rZ   )r   r    r9   Ú|©Úsafezevent|c              3  ó6   #   • U  H  n[        US S9v •  M     g7f)r/   rÉ   Nr	   )r¥   r›   s     rQ   r¦   Ú_identities.<locals>.<genexpr>Þ   s   é € Ð*JÂcÀ¬5°¸Ö+<Âcùs   ‚Ú*student_course_semester_section_occurrencez9: duplicate stable row identity within canonical snapshotr(   z.target_IDCongDiem)Úrow_idÚ
student_idÚ	course_idÚsemesterr   ÚsectionÚgrade_record_id)r@   r>   r[   rR   rt   ry   rV   r’   r“   r   rA   r·   ÚzipÚilocÚappendr
   Újoinr®   Údict)ru   rv   Úcolumnr›   ÚstudentsÚcoursesÚ	semestersÚordersÚsectionsÚoccurrencesÚidsÚ
strategiesr¼   ÚstudentÚcourserÑ   rÒ   r¹   Ú
occurrencerN   Ú	grade_idss                        rQ   Ú_identitiesræ   Æ   s  € Û"ˆØÕÜ ˜xÐ':¸6¸(ÐBxÐyÓzÐzñ #ô �zŠzÀuÈVÂ}ÓUÂ}À!œ=¨¨h°eÐ,<Ö=Á}ÑUÔ]cÑd€HÜ�jŠjÀeÈFÂmÓTÂmÀœ-¨¨X°UÐ+;Ö<ÁmÑTÔ\bÑc€GÜ" 5Ó1Ñ€Ið " UÓ*ô �zŠzà�yÒ!óâ!ˆAô 6>¸a·[±[Œ�a˜8 8Ð,Ô-ÀbÒHÙ!ñô òô 13·²¼¸E»
ÀBÌfÑ0Uð ô œcÓ"€KØœ+¤cÓ*ˆÜ3<¼SÀÐT]Ó=hÖ3iÑ/ˆÑ/ˆG˜X wØ ¨'Ð2ˆØ  Ñ%ˆ
Ø�CÓ˜AÑÓÛ-ˆFØ�¤x°±×0BÑ0BÀ1Ñ0E×'FÓ'FÜ% e¡m×&8Ñ&8¸Ñ&;À¸xÀqÈÈÐ=QÓR�Ø—
‘
˜6 C™<¬%°¸BÑ*?Ñ?Ô@ØÓ" aÑ'Ó"Úñ .ð �J‰J�x #§(¡(Ñ*JÁcÓ*JÓ"JÑJÈqÐQ[ÐP\ÐM]Ñ]Ô^ØÐCÓDÈÑIÕDñ 4jô Œ3ˆs‹8ƒ}œ˜C›Ó Ü˜F˜8Ð#\Ð]Ó^Ð^ð ,¨uÓ4ô —
’
àÐ*Ò+óâ+ˆAô ˜—‘‰¤¨q°HÐ<NÐ2OÓ!PÒPÙ+ñô òô ;=¿'º'Ä#ÀeÃ*ÈdÔZ`Ñ:að ô ”r—z’z #¬VÑ4ÀØ"¸(ÐT]ñ_Ü`dÐeoÓ`pðqð qùò9 VùÚTùòùò*s   ·K8Á0K=Â<*LÉ2*Lc                óª  • SU ;   SU ;   4n[        U5      (       d.  U(       a  [        U S35      e[        R                  " U[        S9$ [        U5      (       d  [        U S35      e[        R                  " U S   5      nUR                  U4:w  d*  [        R                  " US5      R                  5       (       d  [        U S35      e [        R                  " U S   [        S9nUR                  S	:X  a	  US S 2S 4   nUR                  S
:w  d&  UR                  S   U:w  d  UR                  S	   S	:  a  [        U S35      e[        R                  " U5      nXh   S:  Xh   S	:„  -  R                  5       (       a  [        U S35      eUR                  [        5      UR                  S	S9-  $ ! [        [        4 a  n[        U S35      UeS nAff = f)NÚcf_covered_maskÚcf_probabilitieszG: sidecar/covered history requires cf_covered_mask and cf_probabilitiesrX   zR: provide both cf_covered_mask and cf_probabilities to validate finite CF coverage)FTz5: cf_covered_mask must match all canonical train rowsz": cf_probabilities must be numericrZ   rj   r   zJ: cf_probabilities must have canonical rows and at least one member columnz': finite CF probabilities outside [0,1]©Úaxis)r`   r@   r>   Úzerosr=   r^   r[   r„   r…   rD   r\   r]   rF   rd   )	r±   r‡   rv   ÚrequiredÚpresentÚmaskÚprobabilitiesrf   Úfinites	            rQ   Ú	_coveragerò   ê   sÄ  € Ø  EÑ)Ð+=ÀÑ+FÐG€GÜˆw�<‰<ÞÜ ˜xÐ'nÐoÓpÐpÜ�xŠx˜¤Ñ&Ð&Üˆw�<‰<Ü˜F˜8Ð#uÐvÓwÐwÜ�:Š:�eÐ-Ñ.Ó/€DØ‡z�z�a�TÓ¤§¢¨¨}Ó!=×!AÑ!A×!CÑ!CÜ˜F˜8Ð#XÐYÓZÐZðQÜŸ
š
 5Ð);Ñ#<ÄEÑJˆð ×Ñ˜QÓØ%¢a¨ gÑ.ˆØ×Ñ˜QÓ -×"5Ñ"5°aÑ"8¸AÓ"=À×ATÑATÐUVÑAWÐZ[ÓA[Ü˜F˜8Ð#mÐnÓoÐoÜ�[Š[˜Ó'€FØ	Ñ	 Ñ	" }Ñ'<¸qÑ'@ÑA×FÑF×HÑHÜ˜F˜8Ð#JÐKÓLÐLØ�;‰;”tÓ˜vŸz™z¨q˜zÐ1Ñ1Ð1øô ”zÐ"ó QÜ˜F˜8Ð#EÐFÓGÈSÐPûðQús   Ã
F. Æ.GÆ>GÇGc                ó¾  • [         R                  " U 5      nUR                  R                  S:X  a6  UR                  U4:w  a  [        U S35      e[         R                  " U5      nO[        X25      nUS:  XA:¬  -  R                  5       (       a  [        U SU S35      e[        [        UR                  5       5      5      [        U5      :w  a  [        U S35      eU$ )NÚbz): boolean index must match canonical rowsr   z: index outside [0,Ú)z!: duplicate canonical row indices)r>   r[   rY   Úkindr„   r@   r—   rg   r`   r“   r®   r˜   )rN   r‡   rO   rš   Úindicess        rQ   Ú_indicesrø     sÁ   € Ü
�*Š*�UÓ
€CØ
‡y�y‡~�~˜ÓØ�9‰9˜˜ÓÜ ˜vÐ%NÐOÓPÐPÜ—.’. Ó%‰ä˜CÓ&ˆØ	�1‰˜™Ñ&×+Ñ+×-Ñ-Ü˜D˜6Ð!4°Q°C°qÐ9Ó:Ð:Ü
Œ3ˆw�~‰~ÓÓ Ó!¤S¨£\Ó1Ü˜D˜6Ð!BÐCÓDÐDØ€NrS   c                óp  •  [         R                  " U [        S9nUR
                  U[        [        5      4:w  a  [	        U SU SUR
                   S35      e[         R                  " U5      R                  5       (       a  [	        U S35      eU$ ! [        [        4 a  n[	        U S35      UeS nAff = f)NrX   z.: 17 numeric course metadata features requiredz	: shape (z,17) required, got z"; course_target is not a course IDz!: infinite course metadata values)
r>   r[   rD   r\   r@   r„   r“   ÚCOURSE_FEATURESr–   r`   )rN   r‡   rO   re   rf   s        rQ   Ú_course_arrayrû     s³   € ð[Ü—’˜E¬Ñ/ˆð ‡|�|˜œ3œÓ/Ð0Ó0Ü˜D˜6 ¨1¨#Ð-@ÀÇÁÀÐNpÐqÓrÐrÜ	‡x‚x�Ó×Ñ×ÑÜ˜D˜6Ð!BÐCÓDÐDØ€Møô ”zÐ"ó [Ü˜D˜6Ð!OÐPÓQÐWZÐZûð[ús   ‚B ÂB5Â!B0Â0B5c                óŠ  • U c  g [         R                  " U 5      n [        US   [        U5      US-   5      n[        R
                  " U5      n[        R                  " [        R                  " U5      U5      (       d  [        U S35      e[        US   S   [        U5      US-   5      n[        US   S   X#S-   5      n[        UR                  S	[        R                  " U5      5      X#S
-   5      n	[        U	5      U:w  a  [        U S35      e XWX˜4$ ! [         a#  n
[        U SU
R                  S    35      U
eS n
A
ff = f)NÚtrain_row_indexz.train_row_indexzs: train_row_index must equal finite CF-covered canonical rows (cf_covered_mask AND all finite member probabilities)ÚtrainÚcourse_targetz.train.course_targetÚtargetz.target.course_targetÚtarget_row_indexz.target_row_indexz<.target_row_index: a full one-to-one permutation is requiredz': missing proven Suite12 sidecar field r   )ÚjoblibÚloadrø   r“   r>   r—   Úarray_equalÚsortr@   rû   ÚgetÚaranger¸   Úargs)ÚpathÚcoveredÚn_targetrv   Ú
structuredÚ	train_idxÚexpectedrþ   r   Ú
target_idxrf   s              rQ   Ú_sidecarr    sR  € Ø�|ØÜ—’˜TÓ"€JðcÜ˜ZÐ(9Ñ:¼CÀ»LÈ&ÐSeÑJeÓfˆ	Ü—>’> 'Ó*ˆÜ�~Š~œbŸgšg iÓ0°(×;Ñ;Ü ˜xð  ([ð  \ó  ]ð  ]Ü˜j¨Ñ1°/ÑBÄCÈ	ÃNÐTZÐ]sÑTsÓtˆÜ˜z¨(Ñ3°OÑDÀhÐYpÑPpÓqˆÜ˜jŸn™nÐ-?ÄÇÂÈ8ÓATÓUÐW_Ðj}Ña}Ó~ˆ
Üˆz‹?˜hÓ&Ü ˜xÐ'cÐdÓeÐeð 'ð ˜ZÐ/Ð/øô ó cÜ˜F˜8Ð#JÈ3Ï8É8ÐTUÉ;È-ÐXÓYÐ_bÐbûðcús   œC4D Ä
EÄD=Ä=ET)Úfrozenc                  ó~   • \ rS rSr% S\S'   S\S'   S\S'   SrS\S	'   SrS\S
'   SrS\S'   \S 5       r	\S 5       r
Srg)Ú_Sourcei1  rC   ÚfacultyrA   ÚfoldzPath | Noner±   NÚ	train_csvÚtest_csvr  c                ó8   • U R                    SU R                   3$ )Nz fold )r  r  ©Úselfs    rQ   rO   Ú_Source.name:  s   € à—,‘,�˜v d§i¡i [Ð1Ð1rS   c                ó~   • [        S U R                  U R                  U R                  U R                  4 5       5      $ )Nc              3  ó.   #   • U  H  oc  M  Uv •  M     g 7fr£   © ©r¥   Úps     rQ   r¦   Ú _Source.files.<locals>.<genexpr>@  s   é € ÐnÒ \˜1—Q‘QÒ \ùs   ‚Œ	)Útupler±   r  r  r  r  s    rQ   ÚfilesÚ_Source.files>  s,   € äÑn §¡¨T¯^©^¸T¿]¹]ÈDÏOÉOÑ \ÓnÓnÐnrS   r  )Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__annotations__r  r  r  ÚpropertyrO   r#  Ú__static_attributes__r  rS   rQ   r  r  1  sX   ‡ àƒLØ
ƒIØÓØ!€Iˆ{Ó!Ø €HˆkÓ Ø"€J�Ó"àñ2ó ð2ð ñoó óorS   r  c                óÄ  • U R                   bQ  [        R                  " U R                   5      n[        U[        5      (       d  [        U R                    S35      eUS4$ / Sp2U R                  U R                  4 H§  n[        R                  " U[        SS9nSU;  a  [        U S35      e[        US [        U5      5      n[        R                  " U5      nU[        U) R                  5       5      -  nUR                   U   R#                  SS9nUR%                  U5        M©     Uu  p‰UR&                   V
s/ s H!  oª[(        ;  d  M  X©R&                  ;   d  M  U
PM#     nn
U(       d  [        U R*                   S	35      e/ / pÜU Hk  n[        R,                  " XŽ   S
S9nUR/                  5       XŽ   R1                  [2        5      ) -  nUR5                  5       (       a  UOUR%                  U5        Mm     / nU H†  nX\   R7                  [        R,                  S
S9R9                  [:        S9n[        R<                  " U5      R5                  5       (       a  [        U R*                   S35      eUR%                  U5        Mˆ     / nU(       aÏ  SSKJ n  U" SS[:        S9nX�   RC                  S5      RE                  S5      nX�   RC                  S5      RE                  S5      n[        RF                  " US   URI                  U5      /5      US'   [        RF                  " US   URK                  U5      /5      US'   URM                  U5      RO                  5       n[	        UU-   US   US   X‰[        US U R*                  5      S:  RC                  [        RP                  5      [        U	S U R*                  5      S:  RC                  [        RP                  5      S9U4$ s  sn
f )Nz#: canonical cache must be a mappingr   F)rY   Ú
low_memoryr&   zK: split CSV requires target_grade10; cannot infer grades from binary labelsT©ÚdropzD: no numeric predictors remain after established train_v3 exclusionsr‹   rŒ   rX   z": infinite numeric split predictor)ÚOneHotEncoderÚignore)Úhandle_unknownÚsparse_outputrY   ÚstringÚ__MISSING__rZ   r�   )r¡   ÚXtrÚXteÚtrain_frameÚ
test_frameÚytrÚyte))r±   r  r  r<   rØ   r@   r  r  r:   Úread_csvrC   rŸ   r>   rF   rA   ÚsumÚlocÚreset_indexrÖ   Úcolumnsr¯   rO   r”   ÚisnaÚmaprV   r`   Úapplyr•   rD   r–   Úsklearn.preprocessingr0  rd   ÚfillnaÚcolumn_stackÚfit_transformÚ	transformÚget_feature_names_outr˜   r†   )rv   r±   ÚframesÚdroppedr	  ru   ÚgradeÚvalidrþ   r   rx   r²   ÚnumericÚcategoricalrO   ÚparsedrÀ   ÚmatricesÚblockÚencoded_namesr0  ÚencoderÚ	cat_trainÚ
cat_targets                           rQ   Ú_read_sourcerW  C  sQ  € Ø‡|�|ÑÜ—’˜FŸL™LÓ)ˆÜ˜%¤×&Ñ&Ü §¡˜~Ð-PÐQÓRÐRØ�aˆxˆØ˜!ˆGØ×!Ñ! 6§?¡?Ó3ˆÜ—’˜D¬¸Ñ>ˆØ 5Ó(Ü ˜vÐ%pÐqÓrÐrÜ˜˜t¤S¨£YÓ/ˆÜ—’˜EÓ"ˆØ”3˜˜—|‘|“~Ó&Ñ&ˆà—	‘	˜%Ñ ×,Ñ,°$Ð,Ð7ˆØ�‰�eÖñ 4ð �M€EØŸšÓVš�1´+Ñ)=‹QÀ!Ç~Á~ÑBU�Q™€EÐVÞÜ˜FŸK™K˜=Ð(lÐmÓnÐnð ˜rˆ[ÛˆÜ—’˜u™{°(Ñ;ˆØ—K‘K“M U¡[§_¡_´XÓ%>Ð$>Ñ>ˆ	Ø!Ÿ™Ÿ™‰¨W×<Ñ<¸TÖBñ ð €HÛˆØ‰n×"Ñ"¤2§=¡=¸Ð"ÐA×JÑJÔQVÐJÐWˆÜ�8Š8�E‹?×Ñ× Ñ ¤z°V·[±[°MÐAcÐ2dÓ'eÐ!eØ�‰˜Öñ ð €MÞÝ7Ù¨XÀEÔPUÑVˆØÑ$×+Ñ+¨HÓ5×<Ñ<¸]ÓKˆ	ØÑ&×-Ñ-¨hÓ7×>Ñ>¸}ÓMˆ
Ü—O’O X¨a¡[°×1FÑ1FÀyÓ1QÐ$RÓSˆ�‰Ü—O’O X¨a¡[°×1BÑ1BÀ:Ó1NÐ$OÓPˆ�‰Ø×3Ñ3°KÓ@×GÑGÓIˆÜ˜g mÑ3¸À!¹È(ÐSTÉ+Ø!Ü˜U D¨&¯+©+Ó6¸Ñ:×BÑBÄ2Ç7Á7ÓKÜ˜V T¨6¯;©;Ó7¸!Ñ;×CÑCÄBÇGÁGÓLñNð PWðWð Wùò3 Ws   Ä7OÅOÅOc                ó–  • [        XR                  5      n/ nS GH[  u  pEpgXP;  d!  [        X   [        R                  5      (       d  [        UR                   SU 35      eX   R                  SS9n[        U5      (       d  [        UR                   SU S35      eX`;  a  [        UR                   SU 35      e[        X   [        U5      UR                  S-   U-   5      n	[        X‰UR                  S-   U-   5      n
[        X�R                  S-   U-   5      u  p¼[        X[        U5      X!R                  5        [        XXrUR                  S-   U-   5      nUR                  [        X‰X«XÍUS95        GM^     Uu  pï[        R                   " US	   S
   5      n[        U5      S:w  a  [        UR                   S35      eUS	   S   R#                  5       US	   S   R%                  5       :¼  a  [        UR                   S35      e['        US	   S   5      ['        US	   S   5      -  (       a  [        UR                   S35      eX.U4$ )N))rþ   r8  r:  r6  )r   r9  r;  r7  z: missing canonical DataFrame Tr.  r9   z-: nonempty canonical enrollment rows requiredr¶   )ru   ÚyrL  rà   rá   ÚstaticÚxkeyrà   rÑ   rZ   zA: target/test frame must contain exactly one target_NHHK semesterr   zQ: train contains current/future semester rows; require strictly earlier semestersrÎ   z#: train/target row identity overlap)r´   rO   r<   r:   Ú	DataFramer@   r?  r“   r‰   rŸ   ræ   r¾   rÆ   rÖ   rØ   r>   rs   Úmaxrc   r®   )r±   rv   r²   ÚoutputÚmodeÚframekeyÚykeyr[  ru   rY  rL  rà   rá   rZ  rþ   r   Útarget_termss                    rQ   Ú_partsrc  t  s   € Ü˜5§+¡+Ó.€EØ€FÜ&vÑ"ˆ˜ØÓ ¬
°5±?ÄBÇLÁL×(QÑ(QÜ §¡˜}Ð,JÈ8È*ÐUÓVÐVØ‘×+Ñ+°Ð+Ð6ˆÜ�5�z‰zÜ §¡˜}¨A¨d¨VÐ3`ÐaÓbÐbØÓÜ §¡˜}Ð,@ÀÀÐGÓHÐHÜ�E‘K¤ U£¨V¯[©[¸3Ñ->ÀÑ-EÓFˆÜ˜ &§+¡+°Ñ"3°dÑ":Ó;ˆÜ% e¯[©[¸3Ñ->ÀÑ-EÓF‰ˆÜ�œS ›Z¨·±Ô<Ü! %°¸V¿[¹[È3Ñ=NÐQUÑ=UÓVˆØ�‰”d °5ÈjÐnrÑs×tñ 'wð �M€EÜ—9’9˜V E™]¨:Ñ6Ó7€LÜ
ˆ<Ó˜AÓÜ˜FŸK™K˜=Ð(iÐjÓkÐkØˆU�|�GÑ× Ñ Ó" f¨U¡m°GÑ&<×&@Ñ&@Ó&BÓBÜ˜FŸK™K˜=Ð(yÐzÓ{Ð{Ü
ˆ5�‰<˜Ñ!Ó"¤S¨°©°xÑ)@Ó%A×AÜ˜FŸK™K˜=Ð(KÐLÓMÐMØ˜ÐÐrS   c                ó  ^• [         R                  " 5       nU R                  S5       m[        U4S jS5       H  nUR	                  U5        M     S S S 5        UR                  5       $ ! , (       d  f       UR                  5       $ = f)NÚrbc                 ó&   >• T R                  S5      $ )Ni   )Úread)Úhandles   €rQ   Ú<lambda>Ú_sha256.<locals>.<lambda>“  s   ø€  &§+¡+¨gÔ"6rS   rS   )ÚhashlibÚsha256ÚopenÚiterÚupdateÚ	hexdigest)r	  ÚdigestrR  rh  s      @rQ   Ú_sha256rr  �  si   ø€ Ü�^Š^Ó€FØ	�‰�4Œ˜FÜÔ6¸Ö<ˆEØ�M‰M˜%Ö ñ =÷ 
ð ×ÑÓÐ÷ 
Œð ×ÑÓÐús   ¨)A)Á)
Bc                ó„   • [         R                  " U R                  SSSS9R                  5       5      R	                  5       $ )NrM   Úisoé   )ÚorientÚdate_formatÚdouble_precision)rk  rl  Úto_jsonÚencoderp  )ru   s    rQ   Ú_frame_hashr{  ˜  s3   € ä�>Š>˜%Ÿ-™-¨wÀEÐ\^˜-Ð_×fÑfÓhÓi×sÑsÓuÐurS   c                ó¢   • [        U 5      R                  5       nUR                  5       (       a  UR                  5       $ X-  R                  5       $ r£   )r   Ú
expanduserÚis_absoluteÚresolve)rN   Úbaser	  s      rQ   Ú_resolver�  �  sA   € Ü�‹;×!Ñ!Ó#€DØ×$Ñ$×&Ñ&ˆD×@Ñ@ÓBÐB¨D©K×@Ñ@ÓBÐBrS   c           
     ó�  • [        U R                  SS5      U5      nU R                  S5      (       a  [        U S   U5      OUS-  nU R                  S5      (       a  [        U S   U5      OUS-  nU R                  S[        [        SS	5      5      5      n[	        U[
        5      (       aE  UR                  S
5       Vs/ s H)  ofR                  5       (       d  M  UR                  5       PM+     nn[        US5      R                  5       nU(       a8  [        S U 5       5      (       d!  [        [        U5      5      [        U5      :w  a  [        S5      e[        U5      n0 n[        UR                  S5      5       HY  n	[         R"                  " SU	R$                  5      n
U
(       d  M-  U	R'                  5       (       d  MD  X˜U
S   [)        U
S   5      4'   M[     U R                  S5      (       a  [        U S   U5      nOBUS-  UR*                  S-  UR*                  R*                  S-  /n[-        S U 5       US   5      n0 n[        UR                  S5      5       H²  n[         R"                  " SUR$                  5      n
U
(       a  UR/                  5       (       d  MB  [)        U
S   5      n[        UR                  S5      5       HD  n	U	R$                  S [        S5      *  nUU S3-  nUR'                  5       (       d  M;  U	U4UUU4'   MF     M´     [        [        U5      [        U5      -   VVs1 s H  u  nnUU;   d  M  UiM     snn5      nU R                  SS5      nUb7  [	        U[
        5      (       a%  UR                  5       R1                  5       S;   a  UnOw[	        U[
        5      (       aF  UR                  S
5       Vs/ s H)  ofR                  5       (       d  M  UR                  5       PM+     nnOU Vs/ s H  n[3        US5      PM     nnU(       a!  [        [        U5      5      [        U5      :w  a  [        SU SU 35      e[        U5      n/ n[        [        U5      [        U5      -  S S9 HŠ  u  nnUU;  a  M  UR                  UU45      n	UU S U S!3-  nU	b3  UR5                  [7        UXùUR'                  5       (       a  UOS S"95        Mb  UUU4   u  nnUR5                  [7        UUS UU5      5        MŒ     U Vs1 s H  nUR8                  UR:                  4iM     nnU VVs/ s H  nU  H  nUU4U;  d  M  UU4PM     M     nnnU(       a  [=        S#U S$U S%U S&35      eU Vs/ s H  nUR:                  U;   d  M  UPM     nnUUUXsXK4$ s  snf s  snnf s  snf s  snf s  snf s  snnf s  snf )'NÚaq_rootz$/root/disk_3tb/earlywarning/30072026Úaq_cache_dirz(results/cross_faculty_residual_moe/cacheÚaq_structured_dirz results/suite12_structured_cacheÚaq_foldsrZ   r‘   Ú,c              3  ó*   #   • U  H	  oS :  v •  M     g7f)rZ   Nr  )r¥   Úfs     rQ   r¦   Ú_discover.<locals>.<genexpr>ª  s   é € Ð-¢u !˜Až¢uùs   ‚z2aq_folds must be nonempty unique positive integersz*_fold_*.joblibz(.+)_fold_([1-9][0-9]*)\.joblibrj   Úaq_splits_dirzdata/splits/expandingc              3  óR   #   • U  H  oR                  5       (       d  M  Uv •  M     g 7fr£   )Úis_dirr  s     rQ   r¦   rŠ  ·  s   é € Ð>¢Z ·8±8·:Ÿ!™!¢Zùs   ‚'ž	'r   zfold_*zfold_([1-9][0-9]*)z*_train.csvz
_train.csvz	_test.csvÚaq_facultiesr^   )r/   r^   Úautoz*No unique AQ faculties selected; searched z and c                ó   • U S   U S   4$ )NrZ   r   r  ©Úxs    rQ   ri  Ú_discover.<locals>.<lambda>Ñ  s   € È1ÈQÉ4ÐQRÐSTÑQUÉ,rS   ©r¹   Ú_fold_z.joblib)r  z Missing native AQ faculty/folds z; expected canonical z /FACULTY_fold_N.joblib or split z./fold_N/FACULTY_train.csv and FACULTY_test.csv)r�  r  r­   Úranger<   rC   rM   rH   rg   r˜   r`   r“   r®   r@   r°   ÚglobrK   rL   rO   Úis_filerA   ÚparentÚnextr�  ÚlowerrR   rÖ   r  r  r  ÚFileNotFoundError)Úcfgr€  ÚrootÚ	cache_dirÚstructured_dirÚ	folds_rawr›   ÚfoldsÚ	canonicalr	  ÚmatchÚ	split_dirÚ
candidatesÚcsvsÚ	fold_pathr  r  r   r‰  ÚkÚ	availableÚwantedÚ	facultiesÚsourcesÚsidecarÚtrÚteÚsÚfoundrœ   Ú	requesteds                                  rQ   Ú	_discoverr´  ¢  s8  € Ü�C—G‘G˜IÐ'MÓNÐPTÓU€DØ7:·w±w¸~×7NÑ7N”˜˜^Ñ,¨dÔ3ÐTXð  \Fñ  UF€IØADÇÁÐI\×A]ÑA]”X˜cÐ"5Ñ6¸Ô=Ðcgð  kMñ  dM€NØ—‘˜
¤D¬¨q°!«Ó$5Ó6€IÜ�)œS×!Ñ!Ø(1¯©¸Ô(<ÓJÒ(< 1ÇÁÇ	“Y�Q—W‘W–YÑ(<ˆ	ÐJÜ�i Ó,×3Ñ3Ó5€EÞ”CÑ-¡uÓ-×-Ñ-´´S¸³Z³ÄCÈÃJÓ1NÜÐMÓNÐNÜ�5‹M€EØ€IÜ�y—~‘~Ð&7Ó8Ö9ˆÜ—’Ð?ÀÇÁÓKˆßˆ5�T—\‘\—^“^Ø37�u˜Q‘x¤ U¨1¡X£Ð/Ó0ñ :ð ‡w�wˆ×ÑÜ˜S Ñ1°4Ó8‰	àÐ4Ñ4°d·k±kÐD[Ñ6[Ø—k‘k×(Ñ(Ð+BÑBðDˆ
äÑ>¡ZÓ>À
È1ÁÓNˆ	Ø€DÜ˜IŸN™N¨8Ó4Ö5ˆ	Ü—’Ð2°I·N±NÓCˆÞ˜I×,Ñ,×.Ñ.ÙÜ�5˜‘8‹}ˆÜ˜9Ÿ>™>¨-Ó8Ö9ˆDØ—i‘iÐ 3¤# lÓ"3Ð!3Ð4ˆGØ G 9¨IÐ!6Ñ6ˆFØ�~‰~×ÓØ)-¨v¨��g˜t�_Ó%ó	 :ñ 6ô ¤c¨)£n´s¸4³yÒ&@ÔOÒ&@™d˜a ÀAÈÁJŸÑ&@ÒOÓP€IØ�W‰W�^ UÓ+€FØ�~œ F¬C×0Ñ0°V·\±\³^×5IÑ5IÓ5KÐObÓ5bØ‰	Ü	�FœC×	 Ñ	 Ø(.¯©°SÔ(9ÓGÒ(9 1¿W¹W¿Y“Y�Q—W‘W–YÑ(9ˆ	ÐGˆ	á?EÓFºv¸!”] 1 nÖ5¹vˆ	ÐFÞœœC 	›NÓ+¬s°9«~Ó=ÜÐEÀiÀ[ÐPUÐV_ÐU`ÐaÓbÐbÜ�yÓ!€IØ€Gô  ¤ I£´°T³Ñ :Ñ@VÔW‰ˆ�Ø˜)Ó#ÙØ�}‰}˜g t˜_Ó-ˆØ  g Y¨f°T°F¸'Ð#BÑBˆØÑØ�N‰Nœ7 7¨DÈgÏoÉo×N_ÑN_Á7ÐeiÑjÖkà˜7 D˜/Ñ*‰FˆB�Ø�N‰Nœ7 7¨D°$¸¸BÓ?Ö@ñ Xñ +2Ó2ª' Qˆa�i‰i˜Ÿ™Ó ©'€EÐ2Ù$ÔOšu˜!¬i¨¸A¸q¸6ÈÑ;N‹v��1‹v©i‰v™u€GÑOÞÜÐ"BÀ7À)ÐK`ÐajÐ`kð  lLð  MVð  LWð  WEð  !Fó  Gð  	GÙ#Ó7šG�q q§v¡v°¡—™G€IÐ7Ø�I˜y¨%¸NÐUÐUùòq Kùó6 Pùò
 HùâFùò" 3ùÛOùò 8sH   Â>V#ÃV#Ì1V(
ÍV(
ÏV.Ï#V.Ï>V3Ô"V8Ô7V=ÕV=Õ<WÖWc	           	     ó¦  • U R                  U5      n	U	c-  [        U[        U5      [        U5      [        U5      U1US9X'   gU	S   n
U
S S US S :w  d   U
S   (       a,  US   (       a"  U
S   US   :w  a  [	        U SU SU
 SU 35      eU	S   [        U5      :w  a  [	        U S	U 35      eU	S
   b  Ub  U	S
   U:w  a  [	        U SU 35      eU	S
   c  X‰S
'   [
        R                  " U	S   5      (       aS  [
        R                  " U5      (       a8  [
        R                  " U	S   USSS9(       d  [	        U SU SU	S    SU 35      e[
        R                  " U	S   5      (       aJ  [
        R                  " U5      (       a/  [
        R                  " U	S   USSS9(       d  [	        U SU 35      e[
        R                  " U	S   5      (       d)  [
        R                  " U5      (       a  [        U5      U	S'   [
        R                  " U	S   5      (       d)  [
        R                  " U5      (       a  [        U5      U	S'   U	S   R                  U5        g)N)ÚidentityrL  ÚlabelÚcreditr¬  rÓ   Fr¶  rk   z/: identity conflict across folds/faculties for ú: ú versus r·  z,: label conflict across folds/faculties for rÓ   z%: grade record identity conflict for rL  r   g•Ö&è.>)ÚrtolÚatolz,: grade conflict across folds/faculties for r¸  z-: credit conflict across folds/faculties for r¬  T)	r  rØ   rD   rA   r@   r>   rF   ÚiscloseÚadd)ÚregistryÚevent_idr¶  rL  r·  r¸  r  rv   rÓ   ÚrecordÚolds              rQ   Ú_merge_recordrÃ  ã  sP  € Ø�\‰\˜(Ó#€FØ�~Ü!¨8¼5À»<ÌsÐSXËzÜ).¨v«À7À)Ð]lñnˆÑàØ
�Ñ
€Cà
ˆ2ˆA€w�(˜2˜A�,Ó 3 q§6¨h°q¯k¸cÀ!¹fÈÐQRÉÓ>SÜ˜F˜8Ð#RÐS[ÐR\Ð\^Ð_bÐ^cÐckÐltÐkuÐvÓwÐwØˆg�œ#˜e›*Ó$Ü˜F˜8Ð#OÐPXÈzÐZÓ[Ð[ØÐÑ Ñ,°Ñ1LÐQWÐXiÑQjÐn}ÓQ}Ü˜F˜8Ð#HÈÈ
ÐSÓTÐTØÐÑ Ñ(Ø$3Ð Ñ!Ü	‡{‚{�6˜'‘?×#Ñ#¬¯ª°E×(:Ñ(:Ä2Ç:Â:ÈfÐU\ÉoÐ_dÐklÐsw×CxÜ˜F˜8Ð#OÐPXÈzÐY[Ð\bÐcjÑ\kÐ[lÐltÐuzÐt{Ð|Ó}Ð}Ü	‡{‚{�6˜(Ñ#×$Ñ$¬¯ª°V×)<Ñ)<ÄRÇZÂZÐPVÐW_ÑP`ÐbhÐopÐw{×E|Ü˜F˜8Ð#PÐQYÐPZÐ[Ó\Ð\Ü�;Š;�v˜g‘×'Ñ'¬B¯KªK¸×,>Ñ,>Ü ›,ˆˆw‰Ü�;Š;�v˜hÑ'×(Ñ(¬R¯[ª[¸×-@Ñ-@Ü  ›=ˆˆxÑØ
ˆ;Ñ×Ñ˜GÔ$ØrS   c                  ó$   • \ rS rSrSrS rS rSrg)Ú_CourseHistoryiÿ  zMCompact course/semester cumulative sufficient statistics; strict as-of reads.c                ó”  • [        S 5      nUR                  5        Hƒ  nUS   u  pEpdX%   [        U5         nUS   nUS==   S-  ss'   US==   US   -  ss'   [        R                  " U5      (       d  MZ  US==   S-  ss'   US==   U-  ss'   US	==   Xˆ-  -  ss'   M…     0 U l        UR                  5        H…  u  pY[        R                  " [        U	5      [        R                  S
9n
U
[        R                  " [        R                  " U
 Vs/ s H  o¹[        U5         PM     sn5      SS94U R
                  U'   M‡     g s  snf )Nc                 ó   • [        S 5      $ )Nc                 ó4   • [         R                  " S[        S9$ )Nr�   rX   )r>   rì   rD   r  rS   rQ   ri  Ú;_CourseHistory.__init__.<locals>.<lambda>.<locals>.<lambda>  s   € ¼"¿(º(À1ÌEÒ:RrS   r   r  rS   rQ   ri  Ú)_CourseHistory.__init__.<locals>.<lambda>  s
   € ¤kÑ2RÔ&SrS   r¶  rL  r   rZ   r·  rj   rk   é   rX   rê   )r   rˆ   rq   r>   rF   rÛ   Úitemsr[   r°   rb   ÚcumsumÚstackrA   )r  ÚrecordsÚgroupedrÁ  Ú_rã   rÑ   ÚstaterL  rÜ   rÝ   Úos               rQ   Ú__init__Ú_CourseHistory.__init__  s  € ÜÑSÓTˆØ—n‘nÖ&ˆFØ%+¨JÑ%7Ñ"ˆA�xØ‘OÔ$4°XÓ$>Ñ?ˆEØ˜7‘OˆEØ�!‹H˜‰M‹HØ�!‹H˜˜w™Ñ'‹HÜ�{Š{˜5×!Ó!Ø�a“˜A‘“˜u Q›x¨5Ñ0›x°%¸³(¸e¹mÑ2Kµ(ñ 'ð ˆŒØ!(§¡¦ÑˆFÜ—Z’Z¤ yÓ 1¼¿¹ÑBˆFØ$*¬B¯IªI´b·h²hÑ[aÓ?bÒ[aÐVWÌ#ÈaË&Ô@QÑ[aÑ?bÓ6cÐjkÑ,lÐ#mˆD�L‰L˜Ó ò "1ùâ?bs   ÄEc                óF  • [         R                  " [        U5      [        [        5      4[         R                  5      nSUS S 2S4'   0 n[        [        X5      5       GH?  u  nu  pgU[        U5      4nX„;  Ga  [         R                  " S[         R                  [         R                  [         R                  [         R                  /5      n	U R                  R                  U5      n
U
b¨  U
u  p¼[         R                  " X·SS9S-
  nUS:¼  a†  XÍ   u  pïnnn[         R                  " UU(       a  UU-  O[         R                  U(       a,  [         R                  " [        SUUU-  U-  -
  5      U-  5      O[         R                  Xþ-  SXþ-  -
  /5      n	X”U'   XH   X5'   GMB     U$ )Nr‚   r   Úleft)ÚsiderZ   rƒ   )r>   r’   r“   ÚCOURSE_HISTr1   r·   rÔ   rA   ÚarrayrÛ   r  ÚsearchsortedÚsqrtr]  )r  rÛ   rÝ   re   Úmemor¼   rã   r   r¹   rˆ   ÚitemrÜ   Ú
cumulativerÅ   r‡   ÚfailuresÚngÚtotalÚsquareds                      rQ   Úfor_rowsÚ_CourseHistory.for_rows  s[  € Ü—’œ#˜g›,¬¬KÓ(8Ð9¼2¿6¹6ÓBˆØˆŠq�!ˆt‰àˆÜ"+¬C°Ó,@×"AÑˆA‰�Øœ3˜u›:Ð&ˆCØŒÜŸš 2¤r§v¡v¬r¯v©v´r·v±v¼r¿v¹vÐ"FÓG�Ø—|‘|×'Ñ'¨Ó/�ØÑ#Ø,0Ñ)�IÜŸš¨	¸vÑFÈÑJ�AØ˜A“vØ:D¹-Ñ7˜ R¨°Ü!#§¢¨1¾B¨e°bªjÄBÇFÁFÞbd¬2¯7ª7´3°r¸7ÀUÈUÁ]ÐUWÑEWÑ;WÓ3XÐ[]Ñ3]Ô+^Ôjl×jpÑjpØ+3©<¸¸h¹lÑ9Jð+Ló "M˜ð #�S‘	Ø™	ˆFŒIñ #Bð ˆrS   )rÛ   N)r%  r&  r'  r(  Ú__doc__rÔ  rä  r+  r  rS   rQ   rÅ  rÅ  ÿ  s   † ÙWònõrS   rÅ  c                ó’  • U S   n[        US   5      n[        R                  " US   US   US   US   UR                  U S   XU[        R                  " SS	9-   US   S
.	5      nUR                  5        H	  u  pxX†U'   M     [        R                  " U[         V	s/ s H  n	SU	-   PM
     sn	S9n
[        R                  " Xj/SS9$ s  sn	f )Nrà   r   rÎ   rÏ   rÐ   rÑ   rY  é   ©Úhours)	rÎ   rÏ   rÐ   rÑ   r  r·  Ú	origin_atÚlabel_available_atÚ_orderr©   ©r@  rZ   rê   )r€   r:   r\  r  Ú	TimedeltarÌ  rú   Úconcat)Úpartrv   rš   Úmetarà   Úoriginru   rO   rˆ   r‡   rã   s              rQ   Ú
_normalizerô  '  sÄ   € Ø
ˆu‰+€CÜ�S˜‘\Ó"€FÜ�LŠL C¨¡MÀÀ\ÑARØ'*¨;Ñ'7ÀSÈÁ_Ø%+§^¡^¸dÀ3¹iØ'-ÌbÏlÊlÐacÑNdÑEdØ$'¨¡Lñ	2ó 3€Eð Ÿ	™	ž‰ˆØˆd‹ñ $ä�\Š\˜$ÅÓ(QÂ¸A¨°a¬ÁÑ(QÑR€FÜ�9Š9�e�_¨1Ñ-Ð-ùò )Rs   ÂC
c           	     ó<  • [        U 5      u  pE[        X@5      u  pgn[        U[        US   5      U R                  U R
                  S L=(       d    US:H  S9n	[        U R
                  U	[        US   5      U R                  5      n
/ nXx4 H³  nUS   n[        R                  " US   UR                  US   US   5      /5      nU
b  XÇL a  U
S S OU
SS  u  nnUXï'   [        XLS	   [        US   5      X`R                  U5      n[        [        UUR                  5      5      nUR                  [        XÀUU5      5        Mµ     US:X  aM  US
   R                   U	   R#                  SS9US
'   [        US
   5      (       d  [%        U R                   S35      eUS
   US   S.$ )NrY  r
  ©rí   rà   rZ  rÐ   r   rj   r[  r   Tr.  úX: aq_history_support=covered selects no finite CF-covered rows; use full history supportrZ   ©rþ   Útest)rW  rc  rò   r“   rO   r  r  r>   rF  rä  r¾   rØ   rÔ   ÚTrÖ   rô  r>  r?  r@   )rv   rº   ÚhistoryÚsupportr±   rÑ  r²   rþ   r   r
  r®  rJ  rñ  rà   rò  r÷   rˆ   rš   s                     rQ   Ú_load_cohortrý  6  s£  € Ü˜FÓ#�H€EÜ! %Ó0Ñ€E�&Ü˜œs 5¨¡:›°·±Ø!'×!2Ñ!2¸$Ð!>×!VÀ'ÈYÑBVñX€Gä�v×(Ñ(¨'´3°v¸c±{Ó3CÀVÇ[Á[ÓQ€GØ€FØ“ˆØ�5‰kˆÜ�Š  X¡°×0@Ñ0@ÀÀ[ÑAQÐSVÐW^ÑS_Ó0`ÐaÓbˆØÑØ-1ª]˜g b q™kÀÈÈÀ‰OˆG�VØ"ˆD‰MÜ˜ V¡¬c°$°s±)«n¸eÇ[Á[ÐRXÓYˆÜ”3�v˜vŸx™xÓ(Ó)ˆØ�‰”j ¨s°DÓ9Ö:ñ  ð �)ÓØ˜1‘I—M‘M 'Ñ*×6Ñ6¸DÐ6ÐAˆˆq‰	Ü�6˜!‘9�~‰~Ü §¡˜}ð  -Eð  Fó  Gð  GØ˜A‘Y¨¨q©	Ñ2Ð2rS   c                  ó<   ^ • \ rS rSrSrU 4S jrS rSS jrSrU =r	$ )Ú
LazyCohortiM  zJDictionary metadata is cheap; matrices belong to this handle after access.c                ó0   >• [         TU ]  U5        X l        g r£   )ÚsuperrÔ  Ú_loader)r  ÚmetadataÚloaderÚ	__class__s      €rQ   rÔ  ÚLazyCohort.__init__O  s   ø€ Ü‰Ñ˜Ô"Ø�rS   c                ó¸   • US;   a@  [         R                  X5      (       d&  U R                  U R                  5       5        S U l        [         R	                  X5      $ ©Nrø  )rØ   Ú__contains__ro  r  Ú__getitem__)r  r¹   s     rQ   r
  ÚLazyCohort.__getitem__S  sE   € ØÐ#Ó#¬D×,=Ñ,=¸d×,HÑ,HØ�K‰K˜Ÿ™›Ô'ØˆDŒLÜ×Ñ Ó*Ð*rS   c                óB   • US;   a  X   $ [         R                  XU5      $ r  )rØ   r  )r  r¹   Údefaults      rQ   r  ÚLazyCohort.getY  s$   € ØÐ#Ó#Ø‘9ÐÜ�x‰x˜ 7Ó+Ð+rS   )r  r£   )
r%  r&  r'  r(  ræ  rÔ  r
  r  r+  Ú__classcell__)r  s   @rQ   rÿ  rÿ  M  s   ø† ÙTõò+÷,ò ,rS   rÿ  c                  ó0   • \ rS rSrSrS rS rS rS rSr	g)	ÚNativeCohortsi_  zFEach iteration makes fresh lazy handles and retains no loaded cohorts.c                ó|   • [        U5      U l        [        U5      U l        [        U5      U l        X@l        XPl        g r£   )r"  Ú_sourcesÚ	_metadataÚ_commonÚ_historyÚ_support)r  r­  r  rº   rû  rü  s         rQ   rÔ  ÚNativeCohorts.__init__a  s-   € Ü˜g›ˆŒÜ˜x›ˆŒÜ˜V“}ˆŒØŒØ�rS   c                ó,   • [        U R                  5      $ r£   )r“   r  r  s    rQ   Ú__len__ÚNativeCohorts.__len__h  s   € Ü�4—=‘=Ó!Ð!rS   c                ó  ^ ^• [        U[        5      (       a4  [        UR                  [	        T 5      5      6  Vs/ s H  nT U   PM
     sn$ T R
                  U   m[        [        T R                  U   5      U U4S j5      $ s  snf )Nc                 ó\   >• [        TT R                  T R                  T R                  5      $ r£   )rý  r  r  r  )r  rv   s   €€rQ   ri  Ú+NativeCohorts.__getitem__.<locals>.<lambda>p  s   ø€ ¤,¨v°t·|±|ÀTÇ]Á]ÐTX×TaÑTaÔ"brS   )	r<   Úslicer–  r÷   r“   r  rÿ  rØ   r  )r  rÄ   r¼   rv   s   `  @rQ   r
  ÚNativeCohorts.__getitem__k  ss   ù€ Ü�eœU×#Ñ#Ü%*¨E¯M©M¼#¸d»)Ó,DÑ%EÓFÒ%E �D˜”GÑ%EÑFÐFØ—‘˜uÑ%ˆÜœ$˜tŸ~™~¨eÑ4Ó5Ýbódð 	dùò Gs   ºBc              #  óN   #   • [        [        U 5      5       H	  nX   v •  M     g 7fr£   )r–  r“   )r  r¼   s     rQ   Ú__iter__ÚNativeCohorts.__iter__r  s   é € Ü”s˜4“yÖ!ˆAØ‘'ŒMò "ùs   ‚#%)r  r  r  r  r  N)
r%  r&  r'  r(  ræ  rÔ  r  r
  r"  r+  r  rS   rQ   r  r  _  s   † ÙPò ò"òdõrS   r  c                ó²  • [        U5      R                  5       nU R                  SS5      nUS;  a  [        S5      e[	        X5      u  p4pVpxn	[        U R                  SS5      5      n
U
(       a7  [        S[        U5       S[        U5       S	[        U5       S
U SU SU	 3SS9  U Vs1 s H  o»R                  UR                  4iM     nnS0 pí0 0 nn0 0 nn0 / nn[        [        5      n[        [        5      n[        US5       GHp  u  nnUR                   H+  n[        U5      US[        UR                  5       5      -   '   M-     [!        U5      u  nnUS==   U-  ss'   [#        UU5      u  nnnUR                  UR                  4U;   nU(       a7  Uc  UR%                  5       O#U V s/ s H  n U ['        U5      ;   d  M  U PM     sn n[)        U[        US   5      UR*                  UR,                  SL=(       d    U=(       a    US:H  S9n![/        UR,                  U![        US   5      UR*                  5      n"[        US   S   S   5      n#UR1                  UR                  U#5      n$U$U#:w  a  [        SUR                   SU$ SU# 35      eUU4 GHu  n%[3        U%S   S   U%S   S   5       H  u  n&n'[        U'5      U[        U&5      '   M     U%S   R5                  5        H  u  n(n)UU(==   U)-  ss'   M     U%S   n*[        U*S   5       H÷  u  n+n,U*S   U+   U*S    U+   U*S   U+   U*S!   U+   4n-U%S"   U+   U%S   U+   U%S#   U+S4   n0n/n.[6        R8                  " U05      (       a  U0S:  a  [        UR*                   S$35      eU*S%   U+   n1US&==   [;        UU,U-U.U/U0UR                  UR*                  U15	      -  ss'   U%UL d  M¸  US'==   S-  ss'   US(==   [;        UU,U-U.U/U0UR                  UR*                  U15	      -  ss'   Mù     GMx     [        US   S   S   5      n2U(       aª  US:X  a-  U!R=                  5       (       d  [        UR*                   S)35      eUR                  UR                  U#U2[?        U25      US:X  a  [        US   5      O[        U!RA                  5       5      [        US   5      S*.UUR                  UR                  4'   URC                  [E        UR                  UR                  UURF                  b  S+OS,[        US   5      [        US   5      [        [6        R8                  " US"   5      RA                  5       5      [        [6        RH                  " US"   5      RA                  5       5      [        U!RA                  5       5      U"SLU"b  [        U!RA                  5       5      OSU"b  [        U!) RA                  5       5      O[        US   5      U"b  SO[        US   5      U#U"b  S-OS.S/95        U
(       af  [        S0U S1[        U5       S2UR*                   S3[        US   5       S4[        US   5       S5[        U!RA                  5       5       S6U"SL S7U# 3SS9  AAAA"GMs     U(       d  [        S85      e[K        U5       V3s/ s H  n3UUU3      PM     n4n3[=        S9 [3        U4U4SS 5       5       5      (       a  [        S:5      e0 n5UR5                  5        HU  u  n,n6U6S%   b  S;[M        U6S%   S<S=9-   OU,n7[K        U6S>   5       H%  n8[;        U5U7U6S?   U6S"   U6S@   U6SA   U8SBU6S%   5	        M'     MW     [        U5      [        U55      -
  USC'   [O        U55      n9/ n:U5R5                  5        HÎ  u  n,n6U6S?   u  n;n<n=n>[K        U6S>   5      n?U6SA   n0[6        R8                  " U05      (       + n@[6        R8                  " U05      (       d  SDn0USE==   S-  ss'   [?        UU=   5      nAU:RC                  [E        U,U6S%   U6S@   U;U<U=U6S"   U0W@SU?S   [P        RR                  " U?SSF9UA[T        RV                  " SGSH9-   SI95        MÐ     [T        RX                  " U:/ SIQSJ9nB[        UB5      (       d  [        SK5      eWBR[                  UBR\                  R_                  U5      SL9Ra                  / SMQSNSO9Rb                  nCUBRd                  UC   Rg                  SS /SSP9Ri                  5       Rk                  5       S-   UBRd                  UCSQ4'   UBSQ   Rm                  [6        Rn                  5      UBSQ'   [        [&        5      nDURq                  5        H   n6WDU6S?   S      Rs                  U6S>   5        M"     [K        WDR5                  5       5       VVEs0 s H  u  nnEU[K        UE5      _M     snEnWBRt                  SR'   [T        RX                  " [K        UR5                  5       SS ST9 V&V's/ s H9  u  n&n'[E        U&U'[?        U'5      [?        U'5      [T        RV                  " SGSH9-   SU9PM;     sn'n&5      nF[w        U5      [x         V s/ s H  n SVU -   PM
     sn -   nG/ nHU HB  nUUR                  UR                  4   nIWGR%                  5       UISW'   WHRC                  UI5        MD     [{        UWHUU9U5      nJ[}        WB5      USX'   [~        R€                  " [P        RR                  " UBRt                  SR   SSY9Rƒ                  5       5      R…                  5       USZ'   [}        WF5      US['   [~        R€                  " [P        RR                  " [E        XVUWG[†        [ˆ        S\9SSY9Rƒ                  5       5      R…                  5       US]'   [E        S„0 S^S__S`U_S>U_SaU_Sb[        UJ5      _Sc[        U5      _SdU_Se[        U5      _Sf[w        [x        5      _Sg[        UG5      _Sh[        UB5      _Si[        UBRŠ                  R�                  5       RA                  5       5      _Sj[        UBRŠ                  R�                  5       RA                  5       5      _Sk[        UBRŠ                  R�                  5       RA                  5       5      _Sl[A        Sm URq                  5        5       5      _SnS_SoSp_SqSr_Ss[E        U5      _StSu_SvSw_Sx[†        _Sy[ˆ        _SzS{_S|[A        S} U 5       5      _S~[        WD5      _S[        U5      _S€[        U5      _S�[        U	5      _S‚U_[E        U5      D6nKSƒ H  n7WKR1                  U7S5        M     WBWFWJUWK4$ s  snf s  sn f s  sn3f s  snEnf s  sn'n&f s  sn f )…aÄ  Return events, automatic calendar, lazy cohorts, fingerprints, source audit.

Canonical files use the established feature_names/Xtr/Xte/ytr/yte and
train_frame/test_frame schema. Missing canonical cohorts fall back to numeric
expanding fold CSVs. Missing Suite12 sidecars reconstruct the canonical 17
course features from own-row static inputs and strictly prior-semester global
deduplicated training events. No upstream source is created or modified.
Úaq_history_supportr’   )r’   r
  z*aq_history_support must be full or coveredÚ
aq_verboseFzAQ DISCOVERY faculties=z requested_cohorts=z source_cohorts=z cache=z structured=z splits=T)ÚflushNrZ   úsource:Úcsv_rows_missing_target_droppedrY  r
  rö  rà   rÑ   r   zAAll faculties must share the same global target semester in fold r¹  rº  r   rá   rÎ   rÏ   rÐ   rÒ   rL  rZ  z&: SoTinChi credits must be nonnegativerÓ   Úall_snapshot_duplicate_rowsÚhistory_snapshot_rowsÚhistory_duplicate_rows_removedr÷  )r  r  Útarget_semesterÚtarget_orderrë  Ú
train_rowsÚ	test_rowsr£  Úexpanding_csvzKvalidated sidecar order: canonical unless explicit target_row_index presentzcanonical row order)r  r  r³  Úsource_moder/  Útarget_rowsÚhistory_grade_known_rowsÚhistory_grade_missing_rowsÚfinite_cf_covered_rowsÚsidecar_presentÚpreserved_sidecar_train_rowsÚreconstructed_train_rowsÚreconstructed_target_rowsr-  Útarget_alignmentzAQ SCAN Ú/Ú z train=z target=z finite_CF=z	 sidecar=z target_semester=z<No common raw features across all requested AQ faculty/foldsc              3  ó.   #   • U  H  u  pX:¬  v •  M     g 7fr£   r  )r¥   Úarô   s      rQ   r¦   Ú%load_native_inputs.<locals>.<genexpr>Ë  s   é € Ð
@Ò?‘d�aˆ1Ž6Ò?ùs   ‚zCFold numbers must strictly increase in global target semester orderzgrade|r/   rÉ   r¬  r¶  r·  r¸  zhistorical grade registryÚ)history_grade_identity_duplicates_removedr‚   Ú"missing_credit_events_default_zero)Úensure_asciirè  ré  )rÀ  rÓ   Úfailure_labelrÏ   rÐ   rÑ   rL  ÚcreditsÚcredits_missingÚattemptr  Úfaculty_membershipsÚavailable_atrî  z"No native AQ training events found)Ú_ordinal)rÏ   rÐ   rJ  rÀ  Ústable)rö   )r  rG  Ústudent_faculty_membershipsc                ó   • U S   $ )NrZ   r  r‘  s    rQ   ri  Ú$load_native_inputs.<locals>.<lambda>ù  s   € ÐWXÐYZÒW[rS   r”  )rÑ   r   rë  Úlabels_available_atr©   ÚfeaturesÚevents)Ú	sort_keysÚeligible_student_membershipsÚcalendar)r¬  r¢  Úhistory_supportrP  Ú
assumptionÚtimestamp_semanticsÚnative_contractÚ
input_modeÚ	aq_nativerU  r¢  Úrequested_cohortsÚscanned_cohortsÚcommon_raw_featuresÚcommon_raw_feature_countÚcourse_featuresÚengineered_feature_countÚhistory_eventsÚhistory_grade_known_eventsÚhistory_grade_missing_eventsÚ missing_grades_excluded_from_sslÚcross_faculty_eventsc              3  óD   #   • U  H  n[        US    5      S:„  v •  M     g7f)r¬  rZ   N)r“   )r¥   Úrs     rQ   r¦   r@    s    é € Ð)cÒKbÀa¬#¨a°©nÓ*=ÀÖ*AÒKbùs   ‚ Ú(target_grades_excluded_from_event_corpusÚevent_sourcezZfull train_frame from every available fold for selected faculties; never test_frame gradesÚ	id_policyzoglobal normalized IDKQDK; sample_id fallback; deterministic student/course/semester/section/occurrence fallbackÚid_strategy_snapshot_rowsÚattempt_policyzh1-based chronological event number per student/course; registration identity breaks within-semester tiesÚcourse_statisticsz°strictly earlier semesters; deduplicated labeled-event count/failure rates; observed-grade mean and population std (ddof=0; singleton zero), matching preserved Suite17 sidecarsÚavailability_assumptionrW  Úavailability_modeÚsemester_orderÚsource_file_countc              3  óB   #   • U  H  oR                  S 5      v •  M     g7f)r(  Nrª   )r¥   r©  s     rQ   r¦   r@    s   é € ÐJyÒlxÐghÏ<É<ÐXa×KbÐKbÒlxùr¬   Útranscript_join_studentsrŸ  r   Ú
splits_dirÚcohorts)r)  r*  r+  r,  rB  r  )Hr   r  r  r@   r´  r=   Úprintr“   r  r  r   rA   r·   r#  rr  rC   rW  rc  Úcopyr®   rò   rO   r  r  Ú
setdefaultrÔ   rÌ  r>   rF   rÃ  r`   r€   r=  rÖ   rØ   r±   rU   r°   r
   rÅ  ÚjsonÚdumpsr:   rï  r\  ÚassignrÑ   rB  Úsort_valuesrÄ   r>  ÚgroupbyÚcumcountr•   rd   rb   rˆ   ro  Úattrsr­   rú   r  r{  rk  rl  rz  rp  ÚAVAILABILITY_ASSUMPTIONÚTIMESTAMP_SEMANTICSrL  ÚnotnarA  )Lr�  r€  rü  r­  r³  r¬  r¢  rŸ  r   r¥  Úverboser±  Úselectedrº   Úmeta_by_keyÚall_registryÚtrain_registryrÜ   Útarget_by_foldÚfingerprintsÚcohort_auditsÚcountsÚstrategy_countsÚpositionrv   r	  r±   rK  r²   rþ   r   Úis_requestedr‡   r
  r®  Útarget_termÚpreviousrñ  Úsemr   ÚstrategyÚcountrà   r¼   rÀ  r¶  rL  r·  r¸  Úgrade_idr.  r©  Úfold_ordersÚgrade_registryrÁ  r¹   r  rû  Úevent_recordsrâ   rã   rÑ   rÑ  ÚmembershipsrF  ró  rQ  Úattempt_orderÚstudent_membershipsÚfsrT  rP  r  rò  ÚentriesÚauditsL                                                                               rQ   Úload_native_inputsrž  w  sÈ  € ô �‹:×ÑÓ€DØ�g‰gÐ*¨FÓ3€GØÐ)Ó)ÜÐEÓFÐFÜQZÐ[^ÓQeÑN€G˜	¨)ÀYÜ�—‘˜ eÓ,Ó-€GÞŒuÐ.¬s°9«~Ð.>Ð>QÔRUÐV_ÓR`ÐQaÐaqÔruÐv}Ór~Ðqð  @Gð  HQð  GRð  R^ð  _mð  ^nð  nvð  w@ð  vAð  Bð  IMò  NÙ-6Ó7ªY¨—‘˜AŸF™FÓ#©Y€HÐ7Ø ˆKØ#% r�.€LØ " Bˆ~€IØ"$ b�-€LÜœÓ€FÜ!¤#Ó&€OÜ$ W¨Q×/‰ˆ�Ø—L”LˆDÜ<CÀD»MˆL˜¤S¨¯©«Ó%8Ñ8Ó9ñ !ä% fÓ-‰ˆˆwØÐ0Ó1°WÑ<Ó1Ü% e¨VÓ4Ñˆˆu�fØŸ™¨¯©Ð4¸Ñ@ˆÞØ%+¡^�U—Z‘Z”\ÁVÓ9_ÂVÀÈqÔTWÐX]ÓT^É¿!ÁVÑ9_ˆFÜ˜E¤3 u¨S¡z£?°F·K±KØ%+×%6Ñ%6¸dÐ%B×%mÀ|×GlÐX_ÐclÑXlñoˆä˜6×,Ñ,¨g´s¸6À#¹;Ó7GÈÏÉÓUˆÜ˜& ™-¨
Ñ3°AÑ6Ó7ˆØ!×,Ñ,¨V¯[©[¸+ÓFˆØ�{Ó"ÜÐ`Ðag×alÑalÐ`mÐmoÐpxÐoyð  zBð  CNð  BOð  Pó  Qð  QØ˜F”OˆDÜ! $ u¡+¨jÑ"9¸4À¹;ÀwÑ;OÖP‘
��UÜ&)¨%£j�	œ#˜c›(Ó#ñ Qà#'¨Ñ#5×#;Ñ#;Ö#=‘�˜%Ø Ó)¨UÑ2Õ)ñ $>à�u‘+ˆCÜ(¨¨X©Ö7‘��8Ø Ñ-¨aÑ0°#°kÑ2BÀ1Ñ2EÀsÈ:ÁÐWXÑGYÐ[^Ð_hÑ[iÐjkÑ[lÐm�Ø'+¨G¡}°QÑ'7¸¸c¹À1¹ÀtÈHÁ~ÐVWÐYZÐVZÑG[˜f�u�Ü—;’;˜v×&Ñ&¨6°A«:Ü$¨¯© }Ð4ZÐ%[Ó\Ð\ØÐ0Ñ1°!Ñ4�ØÐ4Ó5¼À|ÐU]Ð_gÐinÐpuÐw}ð  @F÷  @Nñ  @Nð  PV÷  P[ñ  P[ð  ]eó  :fñ  fÓ5Ø˜5”=ØÐ2Ó3°qÑ8Ó3ØÐ;Ó<ÄÈnÐ^fÐhpÐrwÐy~ð  AGð  IO÷  IWñ  IWð  Y_÷  Ydñ  Ydð  fnó  Aoñ  oÕ<ô  8ñ $ô  ˜6 %™=¨Ñ1°!Ñ4Ó5ˆÞØ˜)Ó#¨G¯K©K¯M©MÜ  F§K¡K =ð  1Ið  "Jó  Kð  Kà!Ÿ>™>°6·;±;Ø#.ÀÜ$ \Ó2Ø18¸FÓ1Bœc %¨¡*œoÌÈGÏKÉKËMÓHZÜ  ¨¡Ó-ñ:ˆK˜Ÿ™¨¯©Ð5Ñ6ð 	×ÑœT¨&¯.©.¸v¿{¹{ÐVbØ<B¿L¹LÑ<T©[ÐZiÜ,/°°c±
«OÌÈVÐTWÉ[ÓIYÜ:=¼b¿kºkÈ%ÐPWÉ.Ó>Y×>]Ñ>]Ó>_Ó:`Ü<?ÄÇÂÈÈwÉÓ@X×@\Ñ@\Ó@^Ó<_Ü8;¸G¿K¹K»MÓ8JØ18ÀÐ1DØT[ÑTg¼cÀ'Ç+Á+Ã-Ô>PÐmnØSZÑSf¼#À¸x¿n¹nÓ>NÔ:OÔloÐpuÐvyÑpzÓl{Ø@GÑ@S¹1ÔY\Ð]cÐdgÑ]hÓYiØ1<ð DKñ  DWÑ2ð  ]rñsô 	tö ”5˜8 H :¨Q¬s°7«|¨n¸A¸f¿k¹k¸]È'ÔRUÐV[Ð\_ÑV`ÓRaÐQbÐbjÔknÐouÐvyÑozÓk{Ðj|ð  }Hô  ILð  MT÷  MXñ  MXó  MZó  I[ð  H\ð  \eð  fmð  uyð  fyð  ezð  zKð  LWð  KXð  Yð  `dò  eà�5˜&£'ñs 0öt ÜÐWÓXÐXÜ9?ÀÔ9OÓPÒ9O°A�9˜^¨AÑ.Ô/Ñ9O€KÐPÜ
Ñ
@œc +¨{¸1¸2¨Ô?Ó
@×@Ñ@ÜÐ^Ó_Ð_ð
 €NØ*×0Ñ0Ö2Ñˆ�&ØHNÐO`ÑHaÑHmˆxœ% Ð'8Ñ 9ÀÑCÒCÐs{ˆÜ˜f [Ñ1Ö2ˆGÜ˜.¨#¨v°jÑ/AÀ6È'Á?ÐTZÐ[bÑTcØ  Ñ*¨GÐ5PÐRXÐYjÑRkömó 3ñ 3ô
 ;>¸nÓ:MÔPSÐTbÓPcÑ:c€FÐ6Ñ7Ü˜^Ó,€GØ€MØ*×0Ñ0Ö2Ñˆ�&Ø'-¨jÑ'9Ñ$ˆ�˜ 1Ü˜V KÑ0Ó1ˆØ˜Ñ!ˆÜ Ÿkšk¨&Ó1Ô1ˆÜ�{Š{˜6×"Ñ"ØˆFØÐ7Ó8¸AÑ=Ó8Ü˜ 8Ñ,Ó-ˆØ×ÑœT¨8ÀVÐL]ÑE^ÐntÐu|Ñn}ð  KRð  ^dØ+3¸6À'¹?ÐTZÐl{Ø*+°[À±^Ü6:·j²jÀÐ[`Ñ6aØ/5¼¿ºÈ2Ñ8NÑ/Nñ	Pö 	Qñ 3ô �\Š\˜-ò 2Lñ M€Fäˆv�;‰;ÜÐ=Ó>Ð>à—M‘M¨6¯?©?×+>Ñ+>¸yÓ+I�MÐJ×VÑVÚ;À(ð Wð LßLQÉEð à+1¯:©:°mÑ+D×+LÑ+LÈlÐ\gÐMhÐotÐ+LÐ+u×+~Ñ+~ó  ,A÷  ,Jñ  ,Jó  ,Lð  OPñ  ,P€F‡J�Jˆ}˜iÐ'Ñ(Ø˜yÑ)×0Ñ0´·±Ó:€Fˆ9ÑÜ%¤cÓ*ÐØ×%Ñ%Ö'ˆØ˜F :Ñ.¨qÑ1Ñ2×9Ñ9¸&ÀÑ:MÖNñ (ô MSÐSf×SlÑSlÓSnÔLoÔ2pÒLoÁDÀAÀb°1´V¸B³Z²<ÑLoÒ2p€F‡L�LÐ.Ñ/Ü�|Š|ä/5°i·o±oÓ6GÉ^Ò/\ô^â/\¡  eô "¨3°eÄwÈuÃ~Ü6=¸e³nÄrÇ|Â|ÐZ\ÑG]Ñ6]ô_á/\ò^ó _€Hô �F‹|µÓG²°!˜z¨Aœ~±ÑGÑG€HØ€HÛˆØ˜FŸN™N¨F¯K©KÐ8Ñ9ˆØ#Ÿ=™=›?ˆˆZÑØ�‰˜Öñ ô ˜I x°¸À'ÓJ€GÜ(¨Ó0€L�ÑÜ3:·>²>Ä$Ç*Â*ÈVÏ\É\ÐZwÑMxð  DHñ  CI÷  CPñ  CPó  CRó  4S÷  4]ñ  4]ó  4_€LÐ/Ñ0Ü*¨8Ó4€L�ÑÜ&-§n¢n´T·Z²ZÜ�y¸wÐQYÜ/ÔEXñ	Zàñ6÷ ™›ó'"÷ #,¡)£+ð Ð"Ñ#ô ò 8™Kð 8¹ð 8Ù$ð8Ù,1ð8ÜEHÈÄ\ð8ä!$ W¤ð8áCIð8ô +.¨f¬+ð8ô HLÌOÔG\ð8ô +.¨h¬-ð	8ô ILÈFÌð	8ô
 -0°·±×0BÑ0BÓ0D×0HÑ0HÓ0JÔ,Kð8ô /2°&·,±,×2CÑ2CÓ2E×2IÑ2IÓ2KÔ.Lð8ô 36°f·l±l×6GÑ6GÓ6I×6MÑ6MÓ6OÔ2Pð8ô '*Ñ)cÈ>×K`ÑK`ÔKbÓ)cÔ&cð8ñ ;?ð8ñ {ð8ñ Mð8ô ,0°Ô+@ð8ñ !Kð8ñ $Vð8õ *Að8õ Wjð8ñ  $4ð!8ô  HKÑJyÑlxÓJyÔGyð!8ô" +.Ð.AÔ*Bð#8ô$ ˜yœ>ð%8ô$ ;>¸nÔ:Mð%8ô$ [^Ð^gÔZhð%8ñ& '¬$¨v«,ñ'8€Eó*qˆà×Ñ˜˜aÖ ñqð �8˜W l°EÐ9Ð9ùòs 8ùò :`ùòh QùóX 3qùó^ùò Hs+   Â*!t9Æ,t>Çt>Úuæuç,A u
éur£   )F)>ræ  Ú
__future__r   Úcollectionsr   Úcollections.abcr   Údataclassesr   rk  ry  Úpathlibr   rK   Úurllib.parser
   r  Únumpyr>   Úpandasr:   rÃ   rÙ  rú   r¯   r€  r�  Ú	Timestampr}   rJ   rR   rV   rg   rq   ry   r€   r‰   rŸ   r´   r¾   rÁ   rÆ   ræ   rò   rø   rû   r  r  rW  rc  rr  r{  r�  r´  rÃ  rÅ  rô  rý  rØ   rÿ  r  rž  r  rS   rQ   Ú<module>r¨     sS  ðñõ #å #Ý $Ý !Û Û Ý Û 	Ý ã Û Û ð€ð Z€Ø +Ñ-€ò€ðIð ð
Bð ð 
�Š�l uÑ	-€ÚQ€òò$Wò	#òòò5ò"òò"ôò&òò !qôH2ò2ò	ò0ñ& �$Ñ÷oð oó ðoò".Wòb ò8òvò
Cò
>VôB÷8%ñ %òP.ò3ô.,�ô ,ô$�Hô ó0i:rS   