ó
    ’-ºj^  ã                  ó–   • S SK Jr  S SKrS SKrS SKJr  S SKJs  Jr  Sr	 " S S\R                  5      r " S S\R                  5      rg)é    )ÚannotationsN)Úsame_studentÚsame_courseÚ
structuralÚstatec                  ó2   ^ • \ rS rSrSU 4S jjrS rSrU =r$ )ÚResBlocké   c           	     óv  >• [         TU ]  5         [        X-  5      n[        R                  " U5      U l        [        R                  " [        R                  " X5      [        R                  " 5       [        R                  " U5      [        R                  " XA5      [        R                  " U5      5      U l
        g ©N)ÚsuperÚ__init__ÚintÚnnÚ	LayerNormÚnormÚ
SequentialÚLinearÚGELUÚDropoutÚnet)ÚselfÚdÚdropoutÚmultÚhÚ	__class__s        €Ú=/root/disk_3tb/earlywarning/30072026/suite25/suite25_model.pyr   ÚResBlock.__init__   s¯   ø€ Ü‰ÑÔœS ¡›[˜1´2·<²<À³?¨¬ÌBÏMÊMÔZ\×ZcÒZcÐdeÓZhÔik×ipÒipÓirÔsu×s}Òs}ð  Fó  tGô  HJ÷  HQò  HQð  RSó  HVô  WY÷  Waò  Wað  bió  Wjó  MkÀ4Å8ó    c                óF   • XR                  U R                  U5      5      -   $ r   ©r   r   )r   Úxs     r   ÚforwardÚResBlock.forward   s   € ˜q§¡¨$¯)©)°A«,Ó!7Ñ7Ð7r    r"   )çš™™™™™¹?é   )Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__r   r$   Ú__static_attributes__Ú__classcell__©r   s   @r   r	   r	      s   ø† ÷kç7Ð7r    r	   c                  óV   ^ • \ rS rSrSrS	U 4S jjrS r\S 5       rS r	S
S jr
SrU =r$ )Ú$StructureAwareChronologicalRetrievalé   ay  Standalone TabR-inspired retrieval model.

A = ``mlp``  : current-state neural baseline, no retrieval.
B = ``tabr`` : chronology-safe learned kNN/TabR retrieval from the state pool.
C = ``sacr`` : PRIMARY. Multi-view retrieval over same-student, same-course,
               structurally-related and state-neighbour pools.

Core TabR mechanics are retained: a shared encoder creates query/candidate keys,
candidates are re-ranked by learned squared-L2 similarity, historical labels are
embedded into values, T(k_q-k_c) is added to each value, and the retrieved context
is added to the query representation before the final predictor.
c                óò  >• [         TU ]  5         [        U5      U l        [	        U5      U l        [	        U5      U l        [	        U5      U l        [	        U5      U l        [        R                  " [	        U5      [	        U5      5      U l        [        R                  " [	        U5      [	        U5      -   S-   U5      U l        [        R                  " [        [	        U5      5       Vs/ s H  n[!        XI5      PM     sn5      U l        [        R$                  " U5      U l        [        R                  " XE5      U l        [        R                  " SU5      U l        [        R,                  " [        R                  " USU-  5      [        R.                  " 5       [        R0                  " U	5      [        R                  " SU-  USS95      U l        [        R                  " SS5      U l        Sn[        R,                  " [        R                  " US5      [        R.                  " 5       [        R                  " SUSS95      U l        [        R                  " USSS9U l        [        R:                  R=                  U R8                  R>                  5        [        R:                  R=                  U R6                  S	   R>                  5        [        R@                  " [B        RD                  " S
5      5      U l#        [        R                  " US
-   S
5      U l$        [        R:                  R=                  U RH                  R>                  5        [        R:                  R=                  U RH                  RJ                  5        [        R0                  " U
5      U l&        [        R                  " [        [	        U5      5       Vs/ s H  n[!        XI5      PM     sn5      U l'        [        R,                  " [        R$                  " U5      [        R.                  " 5       [        R                  " US5      5      U l(        [        R:                  RS                  U R*                  R>                  SS5        g s  snf s  snf )Né   r'   F)Úbiasé   é   é   é@   éÿÿÿÿé   g      ð¿g      ð?)*r   r   ÚstrÚvariantr   Úd_mainÚkey_dimÚcontext_sizeÚpool_contextr   Ú	EmbeddingÚfaculty_embr   ÚinputÚ
ModuleListÚranger	   Úencoderr   Úkey_normÚKÚlabel_encoderr   r   r   ÚTÚrel_embÚ
meta_valueÚ	meta_biasÚinitÚzeros_ÚweightÚ	ParameterÚtorchÚzerosÚ	pool_biasÚ	pool_gater4   Úcontext_dropoutÚ	predictorÚheadÚuniform_)r   Ú
n_featuresÚn_facultiesr<   r=   r>   Úfaculty_dimÚencoder_blocksÚpredictor_blocksr   rV   r?   r@   Ú_Úmeta_inr   s                  €r   r   Ú-StructureAwareChronologicalRetrieval.__init__   s+  ø€ Ü‰ÑÔ¬¨G«˜4œ<ÄÀVÃ°T´[ÔZ]Ð^eÓZfÈTÌ\Ôy|ð  ~Jó  zKÐgkÔgxô  ^að  bnó  ^oð  LPô  L]ÜŸš¤c¨+Ó&6´s¸;Ó7GÓHˆÔÔTV×T]ÒT]Ô^aÐblÓ^mÔnqÐr}Ón~Ñ^~ð  @Añ  _Að  BHó  UIÈÌô  WY÷  Wdò  Wdô  HMô  NQð  R`ó  Naô  Hbó  ecò  Hbð  CDô  fnð  ouö  f~ñ  Hbñ  ecó  Wdð  JNô  JVô  su÷  sò  sð  @Fó  sGð  eiô  erô  OQ÷  OXò  OXð  Y_ó  Ohð  HLô  HNÜŸ<š<¨¨&Ó1ˆÔ¼¿ºÄrÇyÂyÐQXÐYZÐ[aÑYaÓGbÔce×cjÒcjÓclÔmo×mwÒmwÐxó  nAô  BD÷  BKò  BKð  LMð  NTñ  LTð  U[ð  afñ  Bgó  :h°$´&Ü—\’\ " RÓ(ˆŒØˆÜŸš¤b§i¢i°¸Ó&;¼B¿GºG»IÄbÇiÂiÐPRÐSYÐ_dÑFeÓfˆŒÔvx×vÒvð  AHð  IJð  PUñ  wVÐgkÔguô  WY÷  W^ñ  W^÷  Weñ  Weð  fj÷  ftñ  ft÷  f{ñ  f{ô  W|ô  }÷  }Dñ  }D÷  }Kñ  }Kð  LP÷  L[ñ  L[ð  \^ñ  L_÷  Lfñ  Lfô  }gÜ—|’|¤E§K¢K°£NÓ3ˆŒÄ2Ç9Â9ÈVÐTUÉXÐVWÓCX°D´NÔY[×Y`ÑY`×YgÑYgÐhl×hvÑhv×h}Ñh}ÔY~ô  @B÷  @Gñ  @G÷  @Nñ  @Nð  OS÷  O]ñ  O]÷  Obñ  Obô  @cÜŸZšZ¨Ó8ˆÔÌÏÊÔy~ô  @Cð  DTó  @Uô  zVó  WWò  zVÐtuÔW_Ð`fÖWoñ  zVñ  WWó  IX¸¼ô  ce÷  cpò  cpô  qs÷  q}ò  q}ð  ~Dó  qEô  FH÷  FMò  FMó  FOô  PR÷  PYò  PYð  Z`ð  abó  Pcó  cdð  Y]ô  YbÜ
�‰×Ñ˜×+Ñ+×2Ñ2°3°rÕ:ùò ecùò WWs   Ã(Q/Î?Q4c                ób  • U R                  UR                  5       5      n[        R                  " UR	                  5       XCR	                  5       R                  S5      /S5      oPR                  U5      nU R                   H
  of" U5      nM     U R                  U R                  U5      5      ouU4$ )Nr9   )
rB   ÚlongrR   ÚcatÚfloatÚ	unsqueezerC   rF   rH   rG   )r   ÚcurrentÚfacultyÚsemzÚfr#   ÚbÚks           r   Ú_encodeÚ,StructureAwareChronologicalRetrieval._encode)   s„   € Ø
×
Ñ
˜7Ÿ<™<›>Ó
*ˆ¬U¯YªY¸¿¹»ÈÏ*É*Ë,×J`ÑJ`ÐacÓJdÐ7eÐfhÓ-i¨1×lvÑlvÐwxÓlyÐjkØ—”ˆA  !£ša‘Ø
�&‰&�—‘˜qÓ!Ó
"ˆ¨A¨# :r    c                ó†  • U R                   u  pE[        [        U5      U5      nU R                  U) S5      n[        R
                  " XcSS9u  px[        R                  " USU5      n	UR                  U	) S5      o©R                  S5      ) n[        R                  " U5      (       a  U
R                  5       n
SX«'   [        R                  " U
SS9n[        R                  " Xœ[        R                  " U5      5      n[        R                  " US S 2S 4   [        R                  " U5      U5      nUR                  S5      R                  SSUR                   S   5      n[        R                  " USU5      oìR                  S5      U-  R                  S5      n[        R                  " U 5      nUR!                  SXŒ5        UUU) 4$ )Nç    eÍÍÁr9   )rl   Údimr3   ç        ©rq   )ÚshapeÚminr   Úmasked_fillrR   ÚtopkÚgatherÚanyÚcloneÚFÚsoftmaxÚwhereÚ
zeros_likerf   ÚexpandÚsumÚscatter_)ÚsimÚmaskÚvaluesrl   ÚBÚPÚmaskedÚtopvÚtopiÚvalidÚsafeÚallbadÚwrx   ÚvvÚctxÚfullws                    r   Ú_masked_topk_contextÚ9StructureAwareChronologicalRetrieval._masked_topk_context.   sy  € à�I‰I‰ˆœœC ›F 1›�aØ�‰ ˜u TÓ*ˆ´U·Z²ZÀÈrÑ5R©9¨4ÔY^×YeÒYeÐfjÐklÐmqÓYrÐSXØ×Ñ˜u˜f TÓ*ˆ·9±9¸Q³<°-¨6Ü�9Š9�V×Ñ $§*¡*£,˜T¸B¨t©|Ü
�)Š)�D˜RÑ
 ˆ¤5§;¢;¨u´u×7GÒ7GÈÓ7JÓ#K ÌeÏkÊkÐZ`ÒabÐcgÐagÑZhÔin×iyÒiyÐz{Ói|Ð}~ÓNÈAØ�~‰~˜bÓ!×(Ñ(¨¨B¨v¯|©|¸BÑ/?Ó@ˆÄEÇLÂLÐQWÐXYÐZ`ÓDaÀ×grÑgrÐsuÓgvÐwyÑgy×f~Ñf~ð  @Aó  gBÐbeÜ×Ò˜sÓ#ˆ E§N¡N°1°TÔ$<ÀCÈÈvÈgÐDUÐ=Ur    c                ó¨  • [         R                  " US   R                  5       SS9n[         R                  " US   R                  5       US   R                  5       R	                  S5      [         R
                  " U5      S-  R	                  S5      [         R                  " U* S-  5      R	                  S5      [         R
                  " [         R                  " US   R                  5       SS95      S	-  R	                  S5      /S5      o0R                  US
   R                  5       R                  SS5      5      n[         R                  " X4/S5      $ )NÚrecencyrr   )ru   Ú
pool_flagsÚsame_facultyr9   ç      @Úcoarse_distanceg       @Úrelation_coder   é   )	rR   Úclampre   rd   rf   Úlog1pÚexprK   rc   )r   rk   ÚrecÚnumÚrs        r   Ú_metaÚ*StructureAwareChronologicalRetrieval._meta8   sE  € Ü�KŠK˜˜)™×*Ñ*Ó,°Ñ4ˆ¼¿ºÀAÀlÁO×DYÑDYÓD[Ð\]Ð^lÑ\m×\sÑ\sÓ\u×\Ñ\ð  ACó  ]Dô  FK÷  FQò  FQð  RUó  FVð  WYñ  FY÷  Edñ  Edð  egó  Ehô  in÷  irò  irð  twð  swð  xzñ  szó  i{÷  iEñ  iEð  FHó  iIô  KP÷  KVò  KVô  W\÷  Wbò  Wbð  cdð  evñ  cw÷  c}ñ  c}ó  cð  DFñ  WGó  KHð  IKñ  KK÷  JVñ  JVð  WYó  JZð  D[ð  \^ó  :_°S÷  bnñ  bnð  opð  q@ñ  oA÷  oFñ  oFó  oH÷  oNñ  oNð  OPð  QSó  oTó  bUð  `aô  ]b÷  ]fò  ]fð  hkð  gnð  oqó  ]rð  Vrr    c                óŒ  ^)^*^+• [        U=(       d    / 5      m)U R                  US   US   US   5      u  pVUS   R                  S   nU R                  S:X  d  ST);   a‚  [        R
                  " U5      n[        R                  " [        U5      U4UR                  S9n	[        R                  " [        U5      S	4UR                  S9n
[        R
                  " U
5      nGO—US   R                  u  pÇoÑS   R                  XÇ-  U5      oáS
   R                  S5      oñS   R                  S5      nU R                  XïU5      u  nnUR                  XÇS5      nUR                  XÇS5      nUS S 2S S S 24   U-
  R                  5       R                  S5      * [        R                  " [        U R                  5      5      -  nUS   R!                  5       nU R#                  U5      nU R%                  US   R'                  5       R)                  SS5      5      nST);   a  [        R
                  " U5      nUU R+                  US S 2S S S 24   U-
  5      -   nU R                  S:X  a=  ST);  a7  UU R-                  U5      -   nUU R/                  U5      R1                  S5      -   nU R                  S:X  a�  UUS   S   R!                  5       -  nU R3                  UUUU=(       d    U R4                  5      u  p‰n[        R                  " US	4UR                  S9n
UR                  5       U
S S 2S4'   U
R7                  5       nGO+/ n/ n/ n/ n[9        U=(       d    U R:                  5      nSSSSS.m*[=        S	5       HÙ  m+UUS   ST+4   R!                  5       -  n[?        U)U*U+4S jT* 5       5      (       a  [        R
                  " U5      nU R3                  UU R@                  T+   -   UUU5      u  n n!n"URC                  U 5        URC                  U!5        URC                  U"5        URC                  UR                  S5      R                  5       5        MÛ     [        RD                  " US5      n[        RD                  " US5      n[        RD                  " US5      R                  5       n[        RD                  " US5      n#U RG                  [        RH                  " U[        RJ                  " U#5      S-  /S5      5      n$U$RM                  UR!                  5       ) S5      n$UR!                  5       R?                  S5      ) n%ST);   a5  [        R
                  " U$5      RM                  UR!                  5       ) S5      n$[        R>                  " U%5      (       a  U$R7                  5       n$SU$U%'   [N        RP                  " U$SS9n
[        RR                  " UR!                  5       U
[        R
                  " U
5      5      n
[        RR                  " U%S S 2S 4   [        R
                  " U
5      U
5      oªRU                  S5      U-  R                  S5      oŠS S 2S S 2S 4   U-  R                  S5      n	U RW                  U5      nXX-   n&U RX                   H  n'U'" U&5      n&M     U R[                  U&5      R1                  S5      n(U(       d  U($ U(X‰X«S .4$ )!Nrg   Úfaculty_idxÚ
semester_zÚcandidate_xr3   ÚmlpÚno_retrieval)Údevicer:   Úcandidate_facultyr9   Úcandidate_semester_zÚcandidate_maskÚcandidate_yr   Ú	no_labelsÚsacrÚno_relation_metaÚtabrr•   ).é   r²   r'   )Úno_student_poolÚno_same_course_poolÚno_structural_poolÚno_state_pool.c              3  óJ   >#   • U  H  oT;   =(       a    TU   T:H  v •  M     g 7fr   © )Ú.0ÚaÚablÚdisabledÚps     €€€r   Ú	<genexpr>Ú?StructureAwareChronologicalRetrieval.forward.<locals>.<genexpr>O   s#   øé € ÐIÂ¸1 ™8×6¨°©°Q©Ô6Âùs   ƒ #r—   rp   Úfixed_pool_gatesrr   rs   )ÚcontextÚcandidate_attentionrU   Úpool_available).Úsetrm   rt   r<   rR   r~   rS   Úlenr©   ÚreshapeÚsquarer€   ÚmathÚsqrtre   r>   Úboolr¡   rI   rc   r›   rJ   rL   rM   Úsqueezer‘   r?   rz   r   r@   rE   ry   rT   ÚappendÚstackrU   rd   rœ   rv   r{   r|   r}   rf   rV   rW   rX   ),r   rk   Ú
return_auxÚablateÚcontext_overrider#   rl   r†   r�   ÚattÚpgÚavailr…   ÚDÚcxÚcfÚcsÚchÚckr‚   rƒ   ÚmetaÚlabelr„   ÚpmaskrŠ   ÚcontextsÚweightsÚvalidsÚcountsÚkpoolÚpmÚcr�   ÚvÚcntÚgate_logitsÚnoneÚzÚblockÚoutr»   r¼   r½   s,                                            @@@r   r$   Ú,StructureAwareChronologicalRetrieval.forward;   s»  ú€ Ü�—˜"Óˆ $§,¡,¨q°©|¸A¸mÑ<LÈQÈ|É_Ó"]™c˜aØ
ˆMÑ
×
 Ñ
  Ñ
#ˆØ�<‰<˜Ó .°CÓ"7Ü× Ò  Ó#ˆC¬¯ª´S¸³V¸A°JÀaÇhÁhÑ(O CÔSX×S^ÒS^Ô`cÐdeÓ`fÐghÐ_iÐqr×qyÑqyÑSzÐPRô  BG÷  BRò  BRð  SUó  BVò  |Aà�MÑ"×(Ñ(‰EˆA�¨mÑ,<×,DÑ,DÀQÁSÈÓ,K¨ÐQdÑOe×OmÑOmÐnpÓOqÈBð  xNñ  vO÷  vWñ  vWð  XZó  v[Ðrtð  bf÷  bnñ  bnð  oqð  uwó  bxñ  \að  \^ð  _að  |~÷  |Fñ  |Fð  GHð  KMó  |Nð  y{ð  RT÷  R\ñ  R\ð  ]^ð  acó  Rdð  OQØ’A�dš1�H‘+˜b‘.×(Ñ(Ó*×.Ñ.¨rÓ2Ð2´4·9²9¼UÀ4Ç<Á<Ó=PÓ3QÑQˆCÐWXÐYiÑWj×WoÑWoÓWqÐRVÐw{÷  xBñ  xBð  CDó  xEÐrvØ×$Ñ$ Q }Ñ%5×%:Ñ%:Ó%<×%BÑ%BÀ1ÀQÓ%GÓHˆEØ˜cÓ!¬×(8Ò(8¸Ó(? %Ø˜Ÿ™ ¢! Dª (¡¨B¡Ó/Ñ/ˆFØ�|‰|˜VÓ#Ð(:À#Ó(EØ˜dŸo™o¨dÓ3Ñ3�¸¸D¿N¹NÈ4Ó<P×<XÑ<XÐY[Ó<\Ñ8\°CØ�|‰|˜VÓ#Ø˜1˜\™?¨5Ñ1×6Ñ6Ó8Ñ8�Àt×G`ÑG`ÐadÐejÐkqð  sC÷  sXð  GK÷  GXñ  GXó  HY¹¸Àô  ]b÷  ]hò  ]hð  jkð  lmð  inð  vw÷  v~ñ  v~ñ  ]ð  Z\ð  HM÷  HSñ  HSó  HUð  @Bò  CDð  EFð  CFñ  @Gð  \^÷  \dñ  \dó  \fò  V[à� B˜G¨b v¸°ÄÐEU×EjÐY]×YjÑYjÓAk¸5Ø,-ÀAÐ[\ÐmnÑo�Ü˜qž�AØ˜A˜l™O¨C°¨EÑ2×7Ñ7Ó9Ñ9�BÜÖIÁÓI×IÑIÌU×M]ÒM]Ð^`ÓMaÈ"Ø×3Ñ3°C¸¿¹ÀqÑ8IÑ4IÈ"ÈVÐTYÓZ‘E�A�a˜Ð[c×[jÑ[jÐklÔ[mÐnu×n|Ñn|Ð}~Ônð  AG÷  ANñ  ANð  OPô  AQð  RX÷  R_ñ  R_ð  `b÷  `fñ  `fð  ghó  `i÷  `oñ  `oó  `qö  Rrñ "ô Ÿš X¨aÓ0�¼¿ºÀWÈQÓ9O°ÔV[×VaÒVaÐbhÐijÓVk×VqÑVqÓVsÐPUÔx}÷  yDò  yDð  EKð  LMó  yNÐtwð  [_÷  [iñ  [iô  jo÷  jsò  jsð  uvô  w|÷  wBò  wBð  CFó  wGð  HJñ  wJð  tKð  LNó  jOó  [Pð  OZð  ]h÷  ]tñ  ]tð  v{÷  v@ñ  v@ó  vBð  uBð  CGó  ]Hð  Q\ð  OT÷  OYñ  OYó  O[÷  O_ñ  O_ð  `aó  Obð  Nbð  IMØ%¨Ó,¼×9IÒ9IÈ+Ó9V×9bÑ9bÐdi×dnÑdnÓdpÐcpÐquÓ9v¨[Ü—9’9˜T—?‘?¨{×/@Ñ/@Ó/B ;ÐUWÀ;ÈtÑCTÜ—9’9˜[¨RÑ0�´E·K²KÀÇ
Á
ÃÈRÔPU×P`ÒP`ÐacÓPdÓ4e°Ôin×itÒitÐuyÒz{ð  }Að  {Añ  vBô  CH÷  CSò  CSð  TVó  CWð  XZó  j[Ðfh÷  amñ  amð  npó  aqð  rzñ  az÷  `ñ  `ð  @Aó  `Bð  \_ò  KLò  MNð  OSð  KSñ  HTð  U\ñ  H\÷  Gañ  Gað  bcó  Gdð  CFØ×$Ñ$ SÓ)ˆCØ
‰%ˆØ—^”^ˆE¡e¨A£h¢A‘^Ø�I‰I�a‹L× Ñ  Ó$ˆÞ ˜*Ø˜cÈÑbÐbÐbr    )rH   rJ   rV   r?   r=   rF   rB   rX   rC   r>   rG   rI   rM   rL   rT   r@   rU   rW   rK   r<   )
r¯   é€   r8   é   r'   r'   r&   r&   r7   rí   )FNN)r(   r)   r*   r+   Ú__doc__r   rm   Ústaticmethodr‘   r¡   r$   r,   r-   r.   s   @r   r0   r0      s:   ø† ñ÷	;ò.ð
 ñVó ðVòr÷cò cr    r0   )Ú
__future__r   rÈ   rR   Útorch.nnr   Útorch.nn.functionalÚ
functionalr{   Ú
POOL_NAMESÚModuler	   r0   r¸   r    r   Ú<module>rö      s@   ðå "Û Û Ý ß Ð à>€
ô8ˆr�y‰yô 8ôIc¨2¯9©9õ Icr    