ó
    °L¶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 SK	7   " S S\R                  5      r " S S\R                  5      r " S S	\R                  5      rg)
é    )ÚannotationsN)Ú*c                  ó2   ^ • \ rS rSrSU 4S jjrS rSrU =r$ )Ú	QueryPoolé	   c                óŽ   >• [         TU ]  5         [        R                  " XUSS9U l        [        R
                  " U5      U l        g )NT)ÚdropoutÚbatch_first)ÚsuperÚ__init__ÚnnÚMultiheadAttentionÚattnÚ	LayerNormÚnorm)ÚselfÚd_modelÚheadsr	   Ú	__class__s       €Úd/root/disk_3tb/earlywarning/30072026/suite24_target_conditioned_structural_residual/suite24_model.pyr   ÚQueryPool.__init__
   sJ   ø€ Ü‰ÑÔ¤R×%:Ò%:¸7ÐQXÐeiÑ%j˜4œ9Ôuw÷  vBò  vBð  CJó  vKÐkoÕktó    c           	     óœ  • UR                   S   S:X  a@  [        R                  " U5      [        R                  " [	        U5      S4UR
                  S94$ UR                  5       o3R                  S5      oCR                  5       n[        R                  " U) 5      (       a  SXT) S4'   U) o`R                  US S 2S S S 24   X"USSS9u  pxUS S 2SS S 24   n[        R                  " US S 2S 4   U[        R                  " U5      5      oxS S 2SS S 24   n[        R                  " X8[        R                  " U5      5      o€R                  U5      U4$ )Né   r   )ÚdeviceT)Úkey_padding_maskÚneed_weightsÚaverage_attn_weights)ÚshapeÚtorchÚ
zeros_likeÚzerosÚlenr   ÚboolÚanyÚcloner   Úwherer   )	r   ÚqÚxÚmaskÚvalidÚ	safe_maskÚkey_paddingÚoutÚws	            r   ÚforwardÚQueryPool.forward   sX  € à�7‰7�1‰:�q‹=¤× 0Ò 0°Ó 3´E·K²KÄÀQÃÈÀ
ÐRS×RZÑRZÑ4[Ð [Ð[Ø�Y‰Y‹[ˆŸx™x¨›{˜·Z±Z³\¨9Ü�9Š9�e�V×Ñ°˜Y v¨a xÑ0Ø�Jˆ§Y¡Y¨q²°4º°©{¸1ÐP[Ðimð  DH Yð  &I™u˜sØ’�!’A�‰Jˆœ5Ÿ;š; uªQ¨t¨V¡}°S¼×9IÒ9IÈ#Ó9NÓO�sÒTUÐVWÒXYÐTYÑRZÐPQÔ]b×]hÒ]hÐimÔpu÷  qAò  qAð  BCó  qDó  ^EÐ[\÷  MVñ  MVð  WZó  M[ð  \]ð  M]ð  F]r   )r   r   )é@   é   çš™™™™™¹?)Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__r   r0   Ú__static_attributes__Ú__classcell__©r   s   @r   r   r   	   s   ø† ÷K÷]ð ]r   r   c                  ó6   ^ • \ rS rSrSrSU 4S jjrS rSrU =r$ )ÚPositiveGateé   zbVery low-capacity monotone evidence gate. More available/relevant evidence cannot lower authority.c                óð   >• [         TU ]  5         [        R                  " [        R
                  " U5      5      U l        [        R                  " [        R                  " [        U5      5      5      U l	        g )N)
r   r   r   Ú	Parameterr    r"   Ú
raw_weightÚtensorÚfloatÚbias)r   Ú
n_featuresrD   r   s      €r   r   ÚPositiveGate.__init__   sY   ø€ Ü‰ÑÔ¬2¯<ª<¼¿ºÀJÓ8OÓ+P˜4œ?Ô[]×[gÒ[gÔhm×htÒhtÔuzÐ{ó  vAó  iBó  \CÐQUÕQZr   c                ó¨   • [         R                  " U R                  [        R                  " U R
                  5      U-  R                  S5      -   5      $ )Néÿÿÿÿ)r    ÚsigmoidrD   ÚFÚsoftplusrA   Úsum©r   r)   s     r   r0   ÚPositiveGate.forward   s8   € œuŸ}š}¨T¯Y©Y¼¿
º
À4Ç?Á?Ó8SÐTUÑ8U×7ZÑ7ZÐ[]Ó7^Ñ-^Ó_Ð_r   )rD   rA   )ç      ø¿)	r5   r6   r7   r8   Ú__doc__r   r0   r9   r:   r;   s   @r   r=   r=      s   ø† Ùl÷Cç_Ð_r   r=   c                  óV   ^ • \ rS rSrSrS	U 4S jjrS rS r\S 5       r	S
S jr
SrU =r$ )Ú#TargetConditionedStructuralResidualé   aä  Suite24 model.

variant='history': student-history correction only, fixed bounded authority.
variant='structural': history + direct course-structure corrections, fixed bounded authority.
variant='evidence': same two corrections with monotone row-wise evidence-conditioned gates.

The primary prediction is Committee-anchored. An auxiliary standalone head is trained jointly
so the experiment also measures how much of the task the relational architecture can solve without Committee.
c
                óˆ
  >• [         TU ]  5         [        U5      U l        X l        [        U	5      U l        [        R                  " [        R                  " [        U5      [        R                  " 5       [        R                  " U5      5      U l        [        R                  " [        R                  " [        U5      [        R                  " 5       [        R                  " U5      5      U l        [        R                  " [        R                  " [         U5      [        R                  " 5       [        R                  " X"5      5      U l        [        R$                  " SU5      U l        [        R                  " [        R                  " SU-  U5      [        R                  " 5       [        R                  " U5      5      U l        [        R                  " U5      U l        [        R                  " U5      U l        [/        X#U5      U l        [/        X#U5      U l        [        R                  " [        R                  " SU-  S-   S5      [        R                  " 5       [        R4                  " U5      [        R                  " SS5      5      U l        [        R                  " [        R                  " SU-  S-   S5      [        R                  " 5       [        R4                  " U5      [        R                  " SS5      5      U l        [;        SS5      U l        [;        SS5      U l        SU-  S-   n
[        R                  " [        R                  " U
S	5      [        R                  " 5       [        R4                  " U5      [        R                  " S	S
5      [        R                  " 5       [        R4                  " U5      [        R                  " S
S5      5      U l         Uc  [B        RD                  " [        5      O"[B        RF                  " U[B        RH                  S9o¶c  [B        RJ                  " [        5      O"[B        RF                  " U[B        RH                  S9nUc  [B        RD                  " [        5      O"[B        RF                  " U[B        RH                  S9oØc  [B        RJ                  " [        5      O"[B        RF                  " U[B        RH                  S9nU RM                  SU5        U RM                  SURO                  S5      5        U RM                  SU5        U RM                  SURO                  S5      5        g )Né   r3   é   é   é€   r   g      ð¿rO   é   r2   )ÚdtypeÚstudent_meanÚstudent_stdgü©ñÒMbP?Úcourse_meanÚ
course_std)(r   r   ÚstrÚvariantÚdrC   Ú	delta_capr   Ú
SequentialÚLinearÚSTUDENT_RAW_DIMÚGELUr   Ústudent_encÚCOURSE_RAW_DIMÚ
course_encÚEDGE_RAW_DIMÚedge_encÚ	EmbeddingÚrel_embÚ	pair_projÚhist_token_normÚstruct_token_normr   Ú	hist_poolÚstruct_poolÚDropoutÚ
hist_deltaÚstruct_deltar=   Ú	hist_gateÚstruct_gateÚ
standaloner    r"   Ú	as_tensorÚfloat32ÚonesÚregister_bufferÚ	clamp_min)r   r`   r   r   r	   r[   r\   r]   r^   rb   Ú	stand_dimÚsmÚssÚcmÚcsr   s                  €r   r   Ú,TargetConditionedStructuralResidual.__init__$   s9  ø€ Ü‰ÑÔ¬¨G«˜4œ<¸G´VÔSXÐYbÓScÀDÄNÜŸš¤r§y¢y´ÀÓ'IÌ"Ï'Ê'Ë)ÔTV×T`ÒT`ÐahÓTiÓjˆÔÜŸš¤b§i¢i´¸wÓ&GÌÏÊË	ÔRT×R^ÒR^Ð_fÓRgÓhˆŒÜ—m’m¤B§I¢I¬l¸7Ó$CÄBÇGÂGÃIÌbÏiÊiÐX_ÓNhÓiˆŒÜ—\’\ " WÓ-ˆŒÜ—}’}¤R§Y¢Y¨q°©y¸Ó%AÄ"Ç'Â'Ã)ÌBÏLÊLÐY`ÓLaÓbˆŒÜŸ\š\¨'Ó2ˆÔÌ"Ï,Ê,ÐW^ÓJ_°4Ô3IÜ  ¨wÓ7ˆŒÌÐSZÐahÓIi¸Ô8HÜŸš¤b§i¢i°°'±	¸!±¸CÓ&@ÄÇÂÃÌ2Ï:Ê:ÐV]ÓK^Ô_a×_hÒ_hÐilÐmnÓ_oÓpˆŒÜŸ-š-¬¯	ª	°!°G±)¸A±+¸cÓ(BÄ2Ç7Â7Ã9ÌRÏZÊZÐX_ÓM`Ôac×ajÒajÐknÐopÓaqÓrˆÔÜ# A dÓ+ˆŒ¼\È!ÈDÓ=Q¨DÔ,<Ø�G‘)˜A‘+ˆ	ÜŸš¤b§i¢i°	¸#Ó&>¼r¿wºw»yÌÏÊÐT[ÓI\Ô]_×]fÒ]fÐgjÐkmÓ]nÔoq×ovÒovÓoxÔy{÷  zDò  zDð  ELó  zMô  NP÷  NWò  NWð  XZð  [\ó  N]ó  ^ˆŒØ+7Ñ+?Œ5�;Š;”Ô'ÄUÇ_Â_ÐUaÔhm×huÑhuÑEvˆñ  ZmÔz÷  {Eò  {Eô  FUô  {Vô  sx÷  sBò  sBð  CNô  UZ÷  Ubñ  Ubñ  scÐwyØ*5Ñ*=Œ5�;Š;”~Ô&Ä5Ç?Â?ÐS^Ôej×erÑerÑCsˆñ  VhÔw|÷  xBò  xBô  CQô  xRô  ns÷  n}ò  n}ð  ~Hô  OT÷  O\ñ  O\ñ  n]ÐtvØ×Ñ˜^¨BÔ/°×0DÑ0DÀ]ÐSU×S_ÑS_Ð`dÓSeÔ0fÐgk×g{Ñg{ð  }Jð  KMô  hNð  OS÷  Ocñ  Ocð  dpð  qs÷  q}ñ  q}ð  ~Bó  qCõ  ODr   c                óz   • U R                  UR                  5       U R                  -
  U R                  S-   -  5      $ ©Nç�íµ ÷Æ°>)ri   rC   r]   r^   rM   s     r   Ú_courseÚ+TargetConditionedStructuralResidual._course6   s0   € ˜tŸ™°·±³	¸$×:JÑ:JÑ0JÈTÏ_É_Ð]aÑMaÑ/bÓcÐcr   c                óz   • U R                  UR                  5       U R                  -
  U R                  S-   -  5      $ r…   )rg   rC   r[   r\   rM   s     r   Ú_studentÚ,TargetConditionedStructuralResidual._student7   s5   €  × 0Ñ 0°!·'±'³)¸D×<MÑ<MÑ2MÐPT×P`ÑP`ÐaeÑPeÑ1fÓ gÐgr   c                óž   • U R                  5       R                  SS5      n [        R                  " U 5      [        R                  " U * 5      -
  $ )Nr†   gé!çýÿï?)rC   Úclampr    ÚlogÚlog1p)Úps    r   Ú_committee_logitÚ4TargetConditionedStructuralResidual._committee_logit8   s4   € à
�'‰'‹)�/‰/˜$˜vÓ
&ˆ¬e¯iªi¸«l¼5¿;º;ÈÀr»?Ñ.JÐ'Jr   c                ó´	  • [        U=(       d    / 5      o@R                  US   5      oPR                  US   5      o`R                  [        R
                  " XVXV-  [        R                  " XV-
  5      /S5      5      nU R                  US   5      o€R                  US   R                  5       5      o�R                  US   R                  5       R                  SS5      5      o R                  X‰-   U
-   5      o±S	   R                  5       nS
U;   a  [        R                  " U5      nU R                  X{U5      u  pÞU R                  US   5      oðR                  US   R                  5       5      nU R                  US   R                  5       R                  SS5      5      nU R!                  UU-   U-   5      nUS   R                  5       nU R"                  S
:X  d  SU;   a  [        R                  " U5      nU R%                  UUU5      u  nnUS   R                  5       n[        R&                  " US S 2S4   [(        -  US S 2S4   [*        -  US S 2S4   [(        -  US S 2S4   [(        -  US S 2S4   [(        -  US S 2S4   [*        -  /S5      R                  SS5      nU R-                  [        R
                  " XVUU/S5      5      R/                  S5      nU R1                  [        R
                  " XVUUU/S5      5      R/                  S5      nUS S 2S4   S:„  R3                  UR4                  5      nUS S 2S4   S:„  R3                  UR4                  5      nU R"                  S:X  aA  SU;  a;  U R7                  US S 2/ SQ4   5      U-  nU R9                  US S 2/ SQ4   5      U-  nOUnUnSU;   d  SU;   a  [        R                  " U5      nU R"                  S
:X  d  SU;   d  SU;   a  [        R                  " U5      nU R:                  [        R<                  " U5      -  U-  nU R:                  [        R<                  " U5      -  U-  nUU-   n U R?                  US   5      n!U!U -   n"[        R
                  " XVXV-  [        R                  " XV-
  5      UUU/S5      n#U RA                  U#5      R/                  S5      n$U(       d  U"$ U"U$U UUUUUUUUS.
4$ ) NÚ	student_xÚtarget_course_xrH   Ú	history_xÚhistory_edgeÚhistory_relr   é   Úhistory_maskÚhistoryÚstruct_xÚstruct_edgeÚ
struct_relÚstruct_maskÚ
structuralÚsupportr   é   rV   r3   é   ÚevidenceÚfixed_gates)r   r¢   rV   r3   )r   r£   r¢   Úhistory_gateÚhistory_correctionrw   Ústructural_correctionÚ	committee)
Ústandalone_logitÚ
correctionr§   r¨   r¦   Ústructural_gateÚhistory_attentionÚstructural_attentionÚhistory_reprÚstructural_repr)!ÚsetrŠ   r‡   rn   r    ÚcatÚabsrk   rC   rm   Úlongr�   ro   r$   r!   rq   rp   r`   rr   ÚstackÚMAX_HISTORY_COURSESÚMAX_STRUCT_COURSESrt   Úsqueezeru   ÚtorZ   rv   rw   rb   Útanhr‘   rx   )%r   ÚbatchÚ
return_auxÚablateÚablÚsÚcr(   ÚhxÚheÚhrÚhtÚhmÚrhÚwhÚsxÚseÚsrÚstr   ÚrsÚwsr¡   ÚsupÚdh_rawÚds_rawÚ
hist_availÚstruct_availÚghÚgsÚdhÚdsÚcorrÚzcÚzÚ
stand_reprÚz_inds%                                        r   r0   Ú+TargetConditionedStructuralResidual.forward<   si  € Ü�—˜"Óˆ§¡¨e°KÑ.@Ó A˜aÇLÁLÐQVÐWhÑQiÓDjÀ!×m{Ñm{ô  }B÷  }Fò  }Fð  HIð  LMñ  LOô  PU÷  PYò  PYð  Z[ñ  Z]ó  P^ð  G_ð  `bó  }có  ndÐklØ�<‰<˜˜kÑ*Ó+ˆ¯}©}¸UÀ>Ñ=R×=XÑ=XÓ=ZÓ/[¨B×_kÑ_kÐlqÐrñ  mA÷  mFñ  mFó  mH÷  mNñ  mNð  OPð  QSó  mTó  `UÐ\^÷  Ymñ  Ymð  npñ  nsð  tvñ  nvó  Ywð  VXð  AOñ  {P÷  {Uñ  {Uó  {Wð  xzØ˜Óœu×/Ò/°Ó3˜BØ�n‰n˜Q "Ó%‰ˆØ�<‰<˜˜jÑ)Ó*ˆ¯m©m¸EÀ-Ñ<P×<VÑ<VÓ<XÓ.Y¨2Ð]a×]iÑ]iÐjoÐp|Ñj}÷  kCñ  kCó  kE÷  kKñ  kKð  LMð  NPó  kQó  ^RÐZ\ð  VZ÷  Vlñ  Vlð  moð  prñ  mrð  suñ  muó  Vvð  SUð  zð  @Mñ  zN÷  zSñ  zSó  zUð  wyØ�<‰<˜Ó" l°cÓ&9¼U×=MÒ=MÈbÓ=Q¸"Ø×Ñ˜q  BÓ'‰ˆˆ2Ø�iÑ ×&Ñ&Ó(ˆ¬U¯[ª[¸'Â!ÀAÀ#¹,ÔGZÑ:ZÐ[bÒcdÐefÐcfÑ[gÔhzÑ[zð  |Cò  DEð  FGð  DGñ  |Hô  I\ñ  |\ð  ]dò  efð  ghð  ehñ  ]iô  j}ñ  ]}ð  ~Eò  FGð  HIð  FIñ  ~Jô  K^ñ  ~^ð  _fò  ghð  ijð  gjñ  _kô  l~ñ  _~ð  :ð  @Bó  .C÷  .Iñ  .Ið  JKð  LMó  .N¨Ø�‰œuŸyšy¨!¨b°¨°bÓ9Ó:×BÑBÀ2ÓFˆÈd×N_ÑN_Ô`e×`iÒ`iÐklÐoqÐrtÐuxÐjyÐz|Ó`}ÓN~÷  OGñ  OGð  HJó  OKÀvØšA˜a˜C‘L ‘N×&Ñ& v§|¡|Ó4ˆ
À7Ê1ÈQÈ3Á<ÐPQÁ>×BUÑBUÐV\×VbÑVbÓBc°\Ø�<‰<˜Ó#¨¸SÓ(@Ø�~‰~˜c¢!¢I +Ñ.Ó/°
Ñ:ˆB¸d×>NÑ>NÈsÒSTÒU\ÐS\É~Ó>^Ð_kÑ>k¹2àˆB˜\˜"Ø˜SÓ Ð$8¸CÓ$?Ä5×CSÒCSÐTVÓCWÀØ�<‰<˜Ó" m°sÓ&:Ð>UÐY\Ó>\Ô`e×`pÒ`pÐqwÓ`xÐ]_Ø�>‰>œ%Ÿ*š* VÓ,Ñ,¨RÑ/ˆ°4·>±>Ä%Ç*Â*ÈVÓBTÑ3TÐUWÑ3W°Ø�‰Uˆ�d×+Ñ+¨E°+Ñ,>Ó?�2À"ÀTÁ'ÀÜ—9’9˜a !¡#¤e§i¢i°±£n°R¸¸3Ð?ÀÓCˆ
È$Ï/É/ÐZdÓJe×JmÑJmÐnpÓJqÀEÞ ˜(Ø U¸ÐRTÐmoð  @Bð  UWð  lnð  FHð  XZð  moñ  pð  pð  	pr   )ri   ra   rb   rk   rt   rv   rq   ro   rn   rm   rx   ru   rw   rr   rp   rg   r`   )	r¤   r2   r3   r4   NNNNg      è?)FN)r5   r6   r7   r8   rP   r   r‡   rŠ   Ústaticmethodr‘   r0   r9   r:   r;   s   @r   rR   rR      s7   ø† ñ÷Dò$ dÚgØñKó ðK÷pò pr   rR   )Ú
__future__r   Úmathr    Útorch.nnr   Útorch.nn.functionalÚ
functionalrJ   Úsuite24_graph_indexÚModuler   r=   rR   © r   r   Ú<module>ræ      sP   ðå "Û Û Ý ß Ð Ü !ô	]�—	‘	ô 	]ô`�2—9‘9ô `ô7p¨"¯)©)õ 7pr   