'j+(pdZddlZddlZddlmZddlmZdefdZdefdZde fd Z de fd Z de fd Z de fd Z de fd Zde fdZde defdZdededzfdZde dedzfdZde de dedzfdZde de defdZ d$dedede de de de dzde deded ed!e defd"Z d%dede de de de d!e defd#Zy)&u Azure DevOps REST API client (api-version=7.1). Handles: - Monthly iteration (classification node) — auto-creates if missing - Monthly User Story ("Maintenance :: Month Year") — auto-creates if missing - Task creation under the User Story, linked to Zammad ticket - Idempotent: checks for existing task by ticket number before creating Auth: HTTP Basic with PAT (Personal Access Token). URL: Supports both hosted (dev.azure.com) and self-hosted (DEVOPS_URL). N)datetime)settingsreturnctjdtjj j }d|ddS)z.Basic auth headers for standard JSON requests.:Basic zapplication/json Authorizationz Content-Typebase64 b64encoder devops_patencodedecodetokens -/var/www/html/zammad-automation/app/devops.py_authrsI   q!4!4 56==? @ G G IE!%)* ctjdtjj j }d|ddS)zEBasic auth headers for JSON Patch requests (work item create/update).rr zapplication/json-patch+jsonr r rs r_patch_headersrsI   q!4!4 56==? @ G G IE!%)5 rcftjjddtjS)z(Base URL including org: https://host/org/)r devops_urlrstrip devops_orgrr_rootr&s,!!((- .a0C0C/D EErc<tdtjS)z!Base URL including org + project.r)rrdevops_projectrrr_baser"+sgYa//0 11rc^tdtjdtjS)zCBase URL including org + project + team (for team-scoped settings).r)rrr! devops_teamrrr _team_baser%0s)gYa//0(2F2F1G HHrctj}d|jdjd|jS)z.Current month iteration name, e.g. M_JUN_2026.M_z%b_)rnowstrftimeupperyearr)s riteration_namer.5s7 ,,.C  T"((*+1SXXJ 77rcRtj}d|jdS)z@Current month User Story title, e.g. 'Maintenance :: June 2026'.zMaintenance :: z%B %Y)rr)r*r-s r story_titler0;s$ ,,.C S\\'23 44rcKt}d}tjd4d{}|jt d|d|t d{}|j dk(r|j}nS|jt d |t d |i d{}|j|j}|d }|jtd |t d |i d{dddd{tjd|S777707"#1d{7swY2xYww)zEnsure monthly iteration classification node exists and is assigned to the team. Returns full iteration path like 'ProjectName\M_JUN_2026'.z7.1timeoutN*/_apis/wit/classificationNodes/iterations/z ?api-version=headersz6/_apis/wit/classificationNodes/iterations?api-version=namer7jsonidz0/_apis/work/teamsettings/iterations?api-version=\) r.httpx AsyncClientgetr"r status_coder;postraise_for_statusr%rr!)r9apiclientrnoder2iter_ids rget_or_create_iterationrJAsd  D C  ,  **wiA$}UXTY ZG   ==C 668D{{7)QRUQVWd^#B    !779Dt*kk|nLSE RG   )  4%% &b //5   )    s|'ED1E/D<D4AD</D60AD<D8D< ED:E4D<6D<8D<:E<EE E Er9c Ktjd4d{}|jtd|dt d{}|j dk(cdddd{S7U7&7 #1d{7swYyxYww)zPReturn True if iteration classification node exists (used by web UI validation).r2r3Nr5?api-version=7.1r6r8)r>r?r@r"rrA)r9rErFs rcheck_iteration_existsrMds  ,$$**wiA$GW XG  }}# $$$ $$$$sVBA3B-A9A5A9! B-A7.B5A97B9B ?B B Bitem_idcKtjd4d{}|jtd|dt d{}|j dk(r dddd{y|j |jcdddd{S77X7:7 #1d{7swYyxYww)z9Fetch a work item by ID. Returns None if not found (404).r2r3N/_apis/wit/workitems/rLr6i)r>r?r@r"rrArCr;)rNrErFs r get_work_itemrQns  ,**wi,WI5E FG   ==C   vvx stCB%C-B-B'B-# C.B)/C4B- CB+ C'B-)C+C-B?3B6 4B?;C ticket_numbercKdd|di}tjd4d{}|jtdt |d{}|j |j jd g}|s dddd{y|d d }td tjd |}||dcdddd{S777G7 #1d{7swYyxYww)zqSearch for an existing Task with this ticket number in the title. Returns {id, url} if found, None otherwise.queryzSELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @project AND [System.WorkItemType] = 'Task' AND [System.Title] CONTAINS '#z" ' AND [System.State] <> 'Removed'r2r3N/_apis/wit/wiql?api-version=7.1r: workItemsrr<r/_workitems/edit/r<url) r>r?rBr"rrCr;r@rrr!)rRwiqlrErFitemstask_idtask_urls rfind_existing_taskr^{s  -.;O<. . D  , 0 0++wi6 7G    ["- 0 0 0(4.gYa 7 788I'Sh/ 0 0 0  0 0 0 0 0st#C8CC8+C#C7C# C8CC8,C# C8C!C8C#C8!C8#C5)C, *C51C8title iter_pathcKdd|d|di}tjd4d{}|jtdt | d{}|j |j jd g}|r|d d ndcdddd{S77S7 #1d{7swYyxYww) zsSearch for a User Story with exact title in the given iteration. Returns work item ID if found, None otherwise.rTzSELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @project AND [System.WorkItemType] = 'User Story' AND [System.Title] = 'z ' AND [System.IterationPath] = 'z!' AND [System.State] <> 'Removed'r2r3NrUr:rVrr<)r>r?rBr"rrCr;r@)r_r`rZrErFr[s rfind_user_storyrbs  %&+G,--6K8.  . D  ,11++wi6 7G    ["-!&uQx~D111 1111sV&CB)C+B/B+?B/ C#B-$C+B/-C/C5B8 6C=CcpKdd|ddd|dddddddddg}tjd 4d {}|jtd t | d {}|j |j dcd d d d {S7g7:7 #1d {7swYy xYww)z2Create a new User Story work item. Returns its ID.add/fields/System.Titleoppathvalue/fields/System.IterationPathz/fields/System.WorkItemTypez User Story/fields/System.StateActiver2r3Nz0/_apis/wit/workitems/$User Story?api-version=7.1r:r<)r>r?rBr"rrCr;)r_r`patchrErFs rcreate_user_storyrns4uM ' Custom.ExpertEstimate maps to a custom field in this DevOps instance. Returns {id, url} of created task. NzZammad Ticket: #z
Title: z
Link: zrdre# rfz/fields/System.DescriptionrjrkNewz /relations/-z"System.LinkTypes.Hierarchy-ReverserP)relrYz&/fields/Microsoft.VSTS.Common.Activityz2/fields/Microsoft.VSTS.Scheduling.OriginalEstimatez//fields/Microsoft.VSTS.Scheduling.RemainingWorkz/fields/Custom.ExpertEstimatez/fields/System.Tagsr2r3z*/_apis/wit/workitems/$Task?api-version=7.1r:r<rrWrX) rJrappendr>r?rBr"rrCr;rr!)rorprRrqrrr`rsrtrurvrw descriptionrmrErFitemr\r]s r create_taskrs&133  "-1%'!!+ Bzl$ @4m_Al^4 6:Zef8   E F]efR]noO]kl=^mn E   E+@4PQ  , 0 0++wiA B"$   vvxt*gYa 7 788I'Sh/ 0 0 0=4< 0  0 0 0 0skED0BE!D3"E%+D9D5A D9 E*D7+E3E5D97E9E ?E E Ec >Kt|d{}|r d|d|dddStd{}t}t||d{} | t ||d{} t | |||||||d{} | | d| dddS77b7F727w)aIdempotent task creation flow: 1. Return existing task if found (no duplicate) 2. Ensure monthly iteration exists 3. Ensure monthly User Story exists 4. Create and return new Task Returns {story_id, task_id, task_url, created: bool}.Nr<rYF)ror\r]created)r`rsrwT)r^rJr0rbrnr) rprRrqrrrsrwexistingr`s_titlerotasks rensure_and_creaters( 66H Xd^RWejkk-//I G$Wi88H*7I>>)]L*   D !T$ZT%[]a bb#709> sUBB BBBBB&B'BBBBBBB)N Development?rg?)rr)__doc__r r>rconfigrdictrrstrrr"r%r.r0rJboolrMintrQr^rbrnfloatrrrrrrs  tFsF 2s2 ICI 88 5S5 0s 0F$s$t$   0C0D4K06111t103330!!"!<0<0<0<0 <0  <0 Tz <0<0<0<0<0 <0 <0H" cccc c  c  c cr