Ë
    ´Ïjh  ã                  ó„   — d Z ddlmZ ddlmZmZ ddlmZ ddlm	Z	 ddl
mZmZ ddlmZ ddlmZmZ  G d	„ d
«      Zdd„Zy)zRequirement Analyst skill.é    )Úannotations)ÚListÚOptional)ÚRequirementsArtifact)Ú	JiraIssue)Ú	LLMClientÚget_llm_client©Úsanitize_text)ÚKnowledgeHitÚKnowledgeServicec                  ó,   — e Zd Z	 	 d	 	 	 	 	 dd„Zdd„Zy)ÚRequirementAnalystNc                óP   — |xs
 t        «       | _        |xs
 t        «       | _        y )N)r	   Úllmr   Ú	knowledge)Úselfr   r   s      ú>/var/www/html/gaurav-v2/packages/agents/requirement_analyst.pyÚ__init__zRequirementAnalyst.__init__   s#   € ð
 Ò*œ.Ó*ˆŒØ"Ò8Ô&6Ó&8ˆ�ó    c              ƒ  ó"  K  — |j                   › d|j                  › �}| j                  j                  |d¬«      ƒ d {  –—† }t	        ||«      }| j
                  j                  |«      ƒ d {  –—† }|j                  |_        |j                   s|j                   |_         |j                  s]t        |j                  «      dk\  rE|j                  xs ddk\  r2|j                  r&d|_	        g |_        |j                  xs dd	z   |_        |S 7 ŒÌ7 ŒŸ­w)
NÚ é   )Úlimité   r   gffffffæ?TÚ z9 | Auto-cleared after human comments (non-blocking gaps).)ÚsummaryÚdescriptionr   ÚgatherÚbuild_analyst_promptr   Úanalyze_requirementsÚkeyÚjira_keyÚis_clearÚlenÚacceptance_criteriaÚ
confidenceÚcommentsÚclarification_questionsÚnotes)r   ÚissueÚqueryÚhitsÚpromptÚartifacts         r   ÚanalyzezRequirementAnalyst.analyze   sí   è ø€ Ø—=‘=�/  5×#4Ñ#4Ð"5Ð6ˆØ—^‘^×*Ñ*¨5¸Ð*Ó:×:ˆÜ% e¨TÓ2ˆØŸ™×6Ñ6°vÓ>×>ˆà!ŸI™IˆÔØ×ÒØ$Ÿ}™}ˆHÔð ×!Ò!Ü�H×0Ñ0Ó1°QÒ6Ø×$Ñ$Ò)¨¨cÒ1Ø—’à $ˆHÔØ/1ˆHÔ,Ø&Ÿn™nÒ2°Ð6qÑqˆHŒNØˆð# ;øà>ús"   ‚<D¾D¿.DÁ-DÁ.BDÄD)NN)r   zOptional[LLMClient]r   zOptional[KnowledgeService]ÚreturnÚNone)r+   r   r1   r   )Ú__name__Ú
__module__Ú__qualname__r   r0   © r   r   r   r      s0   „ ð $(Ø04ð9à ð9ð .ð9ð 
ó	9ôr   r   c                óž  — | j                   xs g }dj                  d„ | j                  dd  D «       «      }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t        | j                  «      › d| j                  › ddj                  | j                  «      › dt        | j                  «      › d|r!t        d«      j                  d„ |D «       «      nd› d|xs d› d|› d ||«      › d ||«      › d�S c c}w c c}w )NÚ
c              3  ó”   K  — | ]@  }d |j                  d«      › dt        t        |j                  d«      xs d«      «      › �–— ŒB y­w)ú- Úauthorú: Úbodyr   N)Úgetr   Ústr)Ú.0Úcs     r   Ú	<genexpr>z'build_analyst_prompt.<locals>.<genexpr>/   sC   è ø€ ð ÙSgÈaˆ"ˆQ�U‰U�8‹_Ð˜R¤¬c°!·%±%¸³-Ò2EÀ2Ó.FÓ GÐHÔIÑSgùs   ‚AAiöÿÿÿz, c              3  ól   K  — | ],  }|j                  d «      xs |j                  d«      xs d–— Œ. y­w)ÚfilenameÚidÚ?N)r>   ©r@   Úas     r   rB   z'build_analyst_prompt.<locals>.<genexpr>2   s1   è ø€ Ð_ÑM^È˜AŸE™E *Ó-ÒC°·±°t³ÒCÀÓCÑM^ùs   ‚24ú(none)Ú
confluenceÚgitc                ó8   — | sydj                  d„ | D «       «      S )NrI   r8   c              3  óT   K  — | ]   }d |j                   › d|j                  › �–— Œ" y­w)r:   r<   N)ÚtitleÚsnippet)r@   Úhs     r   rB   z4build_analyst_prompt.<locals>.fmt.<locals>.<genexpr>9   s&   è ø€ ÐA¹b¸˜2˜aŸg™g˜Y b¨¯©¨Ô4¹bùs   ‚&()Újoin)Úhss    r   Úfmtz!build_analyst_prompt.<locals>.fmt6   s   € ÙØØ�y‰yÑA¹bÓAÓAÐAr   uÛ  You are the Requirement Analyst for Agent Nova (Salesforce development automation).
Decide if the Jira requirement is clear enough to implement allowlisted Salesforce metadata.

Clarity rules (follow strictly):
- Set is_clear=true when the story identifies the target object, what metadata to create/change, and the expected behavior â€” OR has explicit acceptance criteria covering those.
- Prefer reasonable defaults over questions for minor scope details (which layouts, record types, profiles, naming style, docs/training).
- Only set is_clear=false for true blockers: missing object, no concrete change, no behavior/AC, or conflicting requirements.
- If Comments contain human answers, treat them as locked decisions. Do not re-ask the same or equivalent questions; set is_clear=true unless a real blocker remains.
- Never invent acceptance criteria that are not present or clearly stated in comments.
- When is_clear=true, clarification_questions MUST be an empty list.

Jira key: z

Summary: z	
Status: z	
Labels: z

Description:
z

Acceptance criteria:
é
   c              3  ó8   K  — | ]  }d t        |«      z   –— Œ y­w)r:   Nr
   rG   s     r   rB   z'build_analyst_prompt.<locals>.<genexpr>O   s   è ø€ Ð2©r¨!ˆd”] 1Ó%Õ%©rùs   ‚u7   (none provided â€” extract from Description if present)z

Comments:
z

Attachments: z

Confluence hits:
z

Repository hits:
zÊ

v1 allowlist: custom fields, validation rules, record-triggered Flows, Apex classes/triggers, LWCs, permission sets.
Out of scope: production deploy, merge, sharing/OWD redesign, destructive deletes.
)rR   úList[KnowledgeHit]r1   r?   )r&   rQ   r(   ÚattachmentsÚsourcer"   r   r   ÚstatusÚlabelsr   Úchr)	r+   r-   Úacr(   rW   rP   Ú	conf_hitsÚ	repo_hitsrS   s	            r   r    r    -   s  € Ø	×	"Ñ	"Ò	( b€BØ�y‰yñ ØSX×SaÑSaÐbeÐbfÑSgóó €Hð —)‘)Ñ_ÈU×M^ÒM^Ó_Ó_ÒkÐck€KÙ Ó=™D�q A§H¡H°Ó$<’˜D€IÐ=Ù Ó6™D�q A§H¡H°Ó$5’˜D€IÐ6óBð
ð �9‰9ˆ+ð 
Ü
˜Ÿ™Ó
&Ð	'ð (	Ø	�‰ˆð 	Ø	�‰�5—<‘<Ó	 Ð!ð "ô ˆu× Ñ Ó!Ð "ð #ñ 79„€Rƒ‡�Ñ2©rÓ2Ô2Ð>wÐ xð yð 
ÒˆXÐ ð àˆ]ð ñ €YƒÐ ð ñ €YƒÐ ð ð?#ð #ùò >ùÚ6s   Á EÁ5EÁ?E
ÂE
N)r+   r   r-   rV   r1   r?   )Ú__doc__Ú
__future__r   Útypingr   r   Úpackages.artifacts.requirementsr   Úpackages.integrations.jirar   Úpackages.integrations.llmr   r	   Úpackages.integrations.sanitizer   Úpackages.knowledge.retrieversr   r   r   r    r6   r   r   Ú<module>rg      s,   ðÙ  å "ç !å @Ý 0ß ?Ý 8ß H÷ñ ô>1r   