Ë
    �Ïji'  ã                  ó<  — d Z ddlmZ ddlmZmZmZmZ ddlm	Z	 ddl
Z
ddlmZmZ ddlmZ ddlmZ dd	lmZ dd
lmZmZ ddlmZmZmZmZ ddlmZ ddlmZm Z m!Z!  e
jD                  e#«      Z$dZ%dZ& G d„ d«      Z'dd„Z(dd„Z)dd„Z*dd„Z+	 	 d	 	 	 	 	 	 	 	 	 dd„Z,y)uP   Solution Architect skill â€” technical design + metadata plan from requirements.é    )Úannotations)ÚDictÚListÚOptionalÚTuple)ÚUUIDN)ÚDesignArtifactÚenforce_allowlist)ÚRequirementsArtifact)ÚArtifactStore)ÚCodeEvidence)Ú	LLMClientÚget_llm_client)Ú	DataModelÚOrgSchemaProviderÚdetect_objectsÚget_org_schema_provider)Úload_coding_standards)ÚKnowledgeHitÚKnowledgeServiceÚclassify_metadata_path)ÚTriggersÚFlowszCustom fieldszValidation ruleszPermission sets)zAPEX-07zLWC-01c                  óT   — e Zd Z	 	 	 	 d	 	 	 	 	 	 	 	 	 dd„Z	 	 d	 	 	 	 	 	 	 dd„Zd	d„Zy)
ÚSolutionArchitectNc                ó„   — |xs
 t        «       | _        |xs
 t        «       | _        |xs
 t	        «       | _        || _        y ©N)r   Úllmr   Ú	knowledger   ÚschemaÚ	artifacts)Úselfr   r   r    r!   s        ú=/var/www/html/gaurav-v2/packages/agents/solution_architect.pyÚ__init__zSolutionArchitect.__init__   s:   € ð Ò*œ.Ó*ˆŒØ"Ò8Ô&6Ó&8ˆŒØÒ9Ô 7Ó 9ˆŒØ"ˆ�ó    c              ƒ  óP  K  — |j                   › ddj                  |j                  «      › �}| j                  j	                  |d¬«      ƒ d {  –—† }| j                  |«      ƒ d {  –—† }t        ||||«      }| j                  j                  |«      ƒ d {  –—† }|j                  |_	        |j                   s|j                   |_         t        |«      }t        ||«       t        ||xs g «       |�+| j                  xs
 t        «       }	|	j                  |d|«       |S 7 ŒÒ7 Œ»7 ŒŒ­w)NÚ é   )Úlimitzdata-model.json)ÚsummaryÚjoinÚacceptance_criteriar   ÚgatherÚload_data_modelÚbuild_architect_promptr   Údesign_solutionÚjira_keyr
   Úapply_data_model_checksÚapply_existing_code_checksr!   r   Ú
write_json)
r"   ÚrequirementsÚrun_idÚexisting_codeÚqueryÚhitsÚ
data_modelÚpromptÚartifactÚstores
             r#   ÚdesignzSolutionArchitect.design+   s  è ø€ ð  ×'Ñ'Ð(¨¨#¯(©(°<×3SÑ3SÓ*TÐ)UÐVˆØ—^‘^×*Ñ*¨5¸Ð*Ó:×:ˆØ×/Ñ/°Ó=×=ˆ
Ü'¨°d¸JÈÓVˆØŸ™×1Ñ1°&Ó9×9ˆØ(×1Ñ1ˆÔØ×ÒØ+×3Ñ3ˆHÔÜ$ XÓ.ˆÜ ¨*Ô5Ü" 8¨]Ò-@¸bÔAØÐØ—N‘NÒ5¤m£oˆEØ×Ñ˜VÐ%6¸
ÔCØˆð ;øØ=øà9ús7   ‚AD&ÁD ÁD&Á&D"Á'0D&ÂD$ÂB	D&Ä"D&Ä$D&c              ƒ  óŒ  K  — dj                  |j                  g|j                  ¢|j                  xs d‘«      }t	        |«      }|st        ddg¬«      S 	 | j                  j                  |«      ƒ d {  –—† S 7 Œ# t        $ r<}t        j                  d|t        |«      ¬«       t        dd	|› �g¬«      cY d }~S d }~ww xY w­w)
NÚ
Ú Únonez.No Salesforce objects detected in requirements)ÚsourceÚwarningsÚdata_model_describe_failed)ÚobjectsÚerrorrG   zData model lookup failed: )r+   r*   r,   Únotesr   r   r    ÚdescribeÚ	ExceptionÚloggerÚwarningÚstr)r"   r5   ÚtextrF   Úexcs        r#   r.   z!SolutionArchitect.load_data_modelA   sÂ   è ø€ Ø�y‰yØ×!Ñ!Ð_ L×$DÑ$DÐ_Àl×FXÑFXÒF^Ð\^Ð_ó
ˆô ! Ó&ˆÙÜ FÐ6fÐ5gÔhÐhð	\ØŸ™×-Ñ-¨gÓ6×6Ð6Ð6ùÜò 	\Ü�N‰NÐ7ÀÔPSÐTWÓPXˆNÔYÜ GÐ9SÐTWÐSXÐ7YÐ6ZÔ[Õ[ûð	\üsH   ‚ACÁA< Á5A:Á6A< Á9CÁ:A< Á<	CÂ1B<Â6CÂ7CÂ<CÃC)NNNN)
r   zOptional[LLMClient]r   zOptional[KnowledgeService]r    zOptional[OrgSchemaProvider]r!   zOptional[ArtifactStore]ÚreturnÚNone©NN)r5   r   r6   zOptional[UUID]r7   úOptional[List[CodeEvidence]]rP   r	   )r5   r   rP   r   )Ú__name__Ú
__module__Ú__qualname__r$   r>   r.   © r%   r#   r   r      s~   „ ð $(Ø04Ø.2Ø-1ð
#à ð
#ð .ð
#ð ,ð	
#ð
 +ð
#ð 
ó
#ð "&Ø6:ð	à*ðð ðð 4ð	ð
 
óô,\r%   r   c                óx  — | j                   }| j                  D �]™  }|j                  |j                  «      }|j                  r|€Œ.|�?|j                  s3d|j
                  › d|j                  › d�}||vr|j                  |«       Œo|j                  dk(  ru|�s|j                  j                  «       |j                  «       v }|rG|j                  dk(  r8d|_        |j
                  › d|j                  › d	�}||vr|j                  |«       |j                  d
k(  s�Œ|€�Œ|j                  j                  «       |j                  D �ch c]  }|j                  «       ’Œ c}v }|s�ŒN|j                  dk(  s�Œ_d|_        d|j
                  › d|j                  › d�}||vs�Œ‰|j                  |«       �Œœ yc c}w )z=Flag plan items that conflict with the discovered data model.NzObject u    not found in org/repo â€” z targets a missing objectÚCustomFieldÚcreateÚupdateÚ.u6    already exists â€” plan changed from create to updateÚValidationRulezValidation rule u*    already exists â€” plan changed to update)Úrisks_or_escalationsÚmetadata_planÚgetÚobjectÚexistsÚnameÚapi_nameÚappendÚmetadata_typeÚlowerÚfield_namesÚactionÚvalidation_rules)r>   r:   ÚrisksÚitemÚobjÚmsgrb   Úvs           r#   r2   r2   O   s„  € à×'Ñ'€EØ×$Õ$ˆØ�n‰n˜TŸ[™[Ó)ˆØ�;Š;˜3˜;ØØˆ? 3§:¢:Ø˜CŸH™H˜:Ð%@ÀÇÁÀÐOhÐiˆCØ˜%ÑØ—‘˜SÔ!ØØ×Ñ Ò.°3°?Ø—]‘]×(Ñ(Ó*¨c¯o©oÓ.?Ð?ˆFÙ˜$Ÿ+™+¨Ò1Ø&�”ØŸ™˜
 ! D§M¡M ?Ð2hÐi�Ø˜eÑ#Ø—L‘L Ô%Ø×ÑÐ!1Ô1°c²oØ—]‘]×(Ñ(Ó*À#×BVÒBVÓ.WÑBV¸Q¨q¯w©w­yÐBVÑ.WÐWˆFÛ˜$Ÿ+™+¨Ô1Ø&�”Ø(¨¯©¨
°!°D·M±M°?ÐBlÐm�Ø˜eÓ#Ø—L‘L Ö%ñ- %ùò" /Xs   ÅF7c                óæ   — i }| D ]i  }|j                   dvrŒt        |j                  «      }|sŒ*|d   |d   j                  «       f}|j	                  |«      }|�|j
                  dk(  sŒe|||<   Œk |S )zU(metadata_type, lower name) -> evidence; default-branch files win over open PR files.)ÚcodeÚpr_filer   é   Úopen)Úkindr   Útitlerg   r`   Ústate)ÚexistingÚindexÚevÚ
classifiedÚkeyÚcurrents         r#   Ú_existing_metadata_indexr~   k   s}   € à13€EÛˆØ�7‰7Ð-Ñ-ØÜ+¨B¯H©HÓ5ˆ
ÙØØ˜!‰}˜j¨™m×1Ñ1Ó3Ð4ˆØ—)‘)˜C“.ˆØˆ?˜gŸm™m¨vÓ5ØˆE�#ŠJð ð €Lr%   c                ó   ‡	— |sy| j                   Š	dˆ	fd„}t        |«      }| j                  D ]ò  }|j                  }|j                  dv r!|j
                  rd|vr|j
                  › d|› �}|j                  |j                  |j                  «       f«      }|€Œl|j                  xs d}|j                  dk(  r) ||j                  › d|› d|j                  › d	|› d
�«       Œ´|j                  dk(  sŒÄd|_         ||j                  › d|› d|› d|j                  › d�«       Œô |D ]g  }|j                  dv sŒ|j                  dk(  sŒ"|j                  dk(  rdnd} |d|› d| j                  › d|j                  xs |j                  › �«       Œi y)zKFlip create->update for metadata already in GitHub; flag open PRs/branches.Nc                ó2   •— | ‰vr‰j                  | «       y y r   )re   )rn   rk   s    €r#   Úaddz'apply_existing_code_checks.<locals>.add�   s   ø€ Ø�eÑØ�L‰L˜Õð r%   )rY   r]   r\   ÚGitHubrt   r'   z  is also changed on open branch z in u(    â€” coordinate to avoid merge conflictsrZ   r[   z already exists in ú (u(   ) â€” plan changed from create to update)ÚprÚbranchr„   ÚPRr…   zOpen z for z already exists: )rn   rM   rP   rQ   )r^   r~   r_   rd   rf   ra   r`   rg   Úreporw   Úrefri   rv   ru   r1   Úurl)
r>   rx   r�   ry   rl   rc   rz   ÚwhereÚlabelrk   s
            @r#   r3   r3   {   s”  ø€ áØØ×'Ñ'€Eõô % XÓ.€EØ×$Ô$ˆØ�}‰}ˆØ×ÑÐ!BÑBÀtÇ{Â{ÐWZÐbfÑWfØ—k‘k�] ! D 6Ð*ˆDØ�Y‰Y˜×*Ñ*¨D¯J©J«LÐ9Ó:ˆØˆ:ØØ—‘Ò#˜8ˆØ�8‰8�vÒÙØ×%Ñ%Ð& a¨ vÐ-MÈbÏfÉfÈXÐUYÐZ_ÐY`ð a:ð :õð �[‰[˜HÓ$Ø"ˆDŒKÙ�4×%Ñ%Ð& a¨ vÐ-@ÀÀÀrÈ"Ï(É(ÈÐS{Ð|Õ}ð %ó" ˆØ�7‰7Ð&Ò&¨2¯8©8°vÓ+=ØŸG™G tšO‘D°ˆEÙ�%˜�w˜e F§O¡OÐ#4Ð4EÀbÇfÁfÒFXÐPR×PXÑPXÐEYÐZÕ[ñ r%   c           	     óè   — | syg }| D ]X  }|j                   rd|j                   d d › �nd}|j                  d|j                  «       › d|j                  xs d› d|› �«       ŒZ d	j	                  |«      S )
Nz(none found)u    â€” i,  rA   ú- rƒ   zno urlÚ)r@   )Úsnippetre   r‹   r‰   r+   )rx   Úlinesrz   r�   s       r#   Ú_existing_code_blockr‘   �   sw   € ÙØØ€EÛˆØ02·
²
�E˜"Ÿ*™* T cÐ*Ð+Ñ,ÀˆØ�‰�r˜"Ÿ(™(›*˜ R¨¯©Ò(:°(Ð';¸1¸W¸IÐFÕGð ð �9‰9�UÓÐr%   c                ó†  — dj                  d„ | j                  D «       «      xs d}|D �cg c]  }|j                  dk(  sŒ|‘Œ }}|D �cg c]  }|j                  dk(  sŒ|‘Œ }}dd„}d| j                  › d| j                  › d	| j
                  › d
|› d| j                  r+t        d«      j                  d„ | j                  D «       «      nd› d| j                  xs d› d ||«      › d ||«      › d|r|j                  «       nd› dt        |«      › dt        «       j                  dt        t        ¬«      › d�S c c}w c c}w )Nr@   c              3  ó&   K  — | ]	  }d |› �–— Œ y­w©r�   NrW   )Ú.0Úas     r#   Ú	<genexpr>z)build_architect_prompt.<locals>.<genexpr>­   s   è ø€ ÐFÑ%E �R˜�s”8Ñ%Eùó   ‚ú(none)Ú
confluenceÚgitc                ó8   — | sydj                  d„ | D «       «      S )Nr™   r@   c              3  óT   K  — | ]   }d |j                   › d|j                  › �–— Œ" y­w)r�   z: N)rv   r�   )r•   Úhs     r#   r—   z6build_architect_prompt.<locals>.fmt.<locals>.<genexpr>´   s&   è ø€ ÐA¹b¸˜2˜aŸg™g˜Y b¨¯©¨Ô4¹bùs   ‚&()r+   )Úhss    r#   Úfmtz#build_architect_prompt.<locals>.fmt±   s   € ÙØØ�y‰yÑA¹bÓAÓAÐAr%   a³  You are the Solution Architect for Agent Nova (Salesforce development automation).
Produce a technical design and metadata plan for allowlisted Salesforce metadata only.
Escalate anything outside the v1 allowlist.

The design is published to Confluence as a Technical Design document with these sections:
1. Overview  2. Scope  3. Data Model  4. Picklist Configuration  5. Page Layout Configuration
6. Validation Rule  7. Processing Behavior  8. Security and Access  9. Deployment Components
10. Testing Strategy  11. Acceptance Criteria Traceability  12. Implementation Summary.

Use a concise feature name as summary (example: "Account Segment Classification"), not a sentence.

Jira key: z

Summary: z
Confidence from analyst: z

Acceptance criteria:
z

Out of scope from analyst:
é
   c              3  ó&   K  — | ]	  }d |z   –— Œ y­wr”   rW   )r•   Úxs     r#   r—   z)build_architect_prompt.<locals>.<genexpr>É   s   è ø€ Ð@Ñ ?˜1ˆd�Q�hÑ ?ùr˜   z	

Notes: z

Confluence hits:
z

Repository hits:
z

Org data model:
z(not loaded)zJ

Existing code in GitHub (kind/state, repo@branch or PR, file, snippet):
a'  

Reuse existing fields and automation from the data model and repository hits. Use action=update
for metadata that already exists; never create a duplicate field. List existing Apex/Flow/triggers
on the same object under dependencies when they may interact with the change.
For existing code in GitHub: plan action=update for those files, never recreate a file that already
exists, and list open pull requests or branches for this ticket under dependencies or risks.

Team naming and metadata standards (api_name values and notes must follow these):
i¸  )Ú	max_charsÚsectionsÚrule_idsaK  

v1 allowlist metadata types: CustomField, ValidationRule, Flow (record-triggered), ApexClass, ApexTrigger, LightningComponentBundle, PermissionSet.
Out of scope: profiles, sharing/OWD redesign, connected apps, destructive deletes, production deploy.

Return a metadata_plan with metadata_type, api_name, action (create|update), object (if applicable), and notes.
For CustomField notes include: data type, field label, picklist values, default value, required-at-definition.
For ValidationRule notes include: purpose, formula (Salesforce formula syntax), error message, error location.
)rŸ   úList[KnowledgeHit]rP   rM   )r+   r,   rC   r1   r*   Ú
confidenceÚout_of_scope_itemsÚchrrH   Úprompt_blockr‘   r   ÚSTANDARDS_DESIGN_SECTIONSÚSTANDARDS_DESIGN_RULES)	r5   r9   r:   r7   Úacrž   Úconfr‡   r    s	            r#   r/   r/   §   s{  € ð 
�‰ÑF \×%EÒ%EÓFÓ	FÒ	RÈ(€BÙÓ8‘t�!˜qŸx™x¨<Ó7ŠA�t€DÐ8ÙÓ1‘t�!˜qŸx™x¨5Ó0ŠA�t€DÐ1óBð
ð × Ñ Ð
!ð "
Ø
×
Ñ
Ð	ð  Ø&×1Ñ1Ð2ð 3ð €ð ð EQ×DcÒDc„€Rƒ‡�Ñ@ × ?Ò ?Ó@Ô@ÐiqÐ rð sà×ÑÒ&˜hÐ'ð (ñ €Tƒ€ð ñ €Tƒ€ð ñ )€×ÑÔ¨nÐ =ð >ô �mÓ$Ð %ð 	&ô Ó×%Ñ%°Ô?XÔcyÐ%ÓzÐ {ð |ðU2ð 2ùò 9ùÚ1s   «D9Á D9Á
D>ÁD>)r>   r	   r:   r   rP   rQ   )rx   úList[CodeEvidence]rP   z#Dict[Tuple[str, str], CodeEvidence])r>   r	   rx   r°   rP   rQ   )rx   rS   rP   rM   rR   )
r5   r   r9   r§   r:   zOptional[DataModel]r7   rS   rP   rM   )-Ú__doc__Ú
__future__r   Útypingr   r   r   r   Úuuidr   Ú	structlogÚpackages.artifacts.designr	   r
   Úpackages.artifacts.requirementsr   Úpackages.db.artifactsr   Ú#packages.integrations.github_searchr   Úpackages.integrations.llmr   r   Ú packages.integrations.org_schemar   r   r   r   Ú#packages.knowledge.coding_standardsr   Úpackages.knowledge.retrieversr   r   r   Ú
get_loggerrT   rK   r¬   r­   r   r2   r~   r3   r‘   r/   rW   r%   r#   Ú<module>r¿      s¾   ðÙ Vå "ç .Ó .Ý ã ç GÝ @Ý /Ý <ß ?÷ó õ Fß `Ñ `à	ˆ×	Ñ	˜hÓ	'€àiÐ Ø.Ð ÷.\ñ .\ób&ó8ó \óDð '+Ø26ð	AØ&ðAà
ðAð $ðAð 0ð	Að
 	ôAr%   