3j'rUdZddlmZddlZddlZddlZddlmZmZddlm Z ddl m Z m Z dZ ded <d Zded <d Zded <dZded<dZded<dZded<dZded<GddeZd*dZd+dZddd,dZd-dZd.d Zd/d!Zd"d# d0d$Zd*d%Z d1d&Zeed' d2d(Z gd)Z!y)3uanu_v3.branch_ref_allocator — task-2553+9 collision-safe branch name allocator (회장 §4-1~4-4 / 9-R.3 / 9-R.4 / 9-R.6). 근본원인: live 메인 워크스페이스가 ``task/task-2553p1-f1-clean-replacement`` 에 checkout 돼 있고, activation runner 의 ``git checkout -B `` 가 그 **live-checked-out branch ref 를 reset** → task-2553+8 DEFENSIVE_HOLD. 본 모듈 = 충돌하지 않는 **고유 신규 replacement branch name 을 할당**. 충돌은 강제 reset 이 아니라 **회피(새 name)** 로만 해소한다 (회장 §3). 설계 불변식: - **read-only**: ``git worktree list`` / ``git show-ref`` / ``git ls-remote`` 만 호출. branch 생성·reset·checkout·push·prune **부재**(정적·런타임). - **loop-until-clean (9-R.3)**: 단발 uuid 확률 방어 금지. candidate 가 (worktree checked-out ∪ local refs ∪ remote refs) 3-source 전부에서 absent 될 때까지 반복. bounded ``max_attempts``(기본 8) 초과 → HOLD. - **강제 reset 0 (회장 §3)**: 어떤 경우에도 기존 ref 를 reset/삭제 않음. - **9-R.6 audit trail**: 결과 provenance 는 ``schemas/ branch_allocation_provenance.schema.json`` 와 1:1 (base_sha single authority — base_name 미기록). ) annotationsN)datetimetimezone)Path)CallableFinalzanu_v3.branch_ref_allocatorz Final[str]ALLOCATOR_MODULEz1.0.0ALLOCATOR_VERSIONz&anu_v3.branch_allocation_provenance.v1PROVENANCE_SCHEMA ALLOCATEDSTATUS_ALLOCATEDHOLD_FOR_CHAIR STATUS_HOLDz Final[int]DEFAULT_MAX_ATTEMPTS)worktreeshow-ref ls-remote rev-parsezFinal[tuple[str, ...]]READ_ONLY_GIT_VERBSceZdZdZy)BranchAllocatorErroru>allocation 실패. fail-closed: branch mutation 절대 부재.N)__name__ __module__ __qualname____doc__2/home/jay/workspace/anu_v3/branch_ref_allocator.pyrr2sHrrcftjtjj dS)Nz%Y-%m-%dT%H:%M:%SZ)rnowrutcstrftimerrr_now_utcr$6s! << % . ./C DDrcttjj}dD]}|j|d|S)uF9-R.2 동일 패턴 — GIT_* 오염 변수 제거 (isolation 강제).)GIT_DIR GIT_WORK_TREEGIT_INDEX_FILEGIT_OBJECT_DIRECTORYGIT_COMMON_DIRN)osenvironcopypop)eks r_sanitized_envr1:s9 A a Hr<)timeoutc .|r |dtvrtd|dddtdtt|j }t j dd|g|d d |d t }|j|jjfS) uabsolute ``git -C `` **read-only** 전용. (rc, stdout) 반환. 호출 verb 가 READ_ONLY_GIT_VERBS 화이트리스트 밖이면 즉시 거부 (런타임 fail-closed — mutating git 호출 경로 부재 강제). ru.read-only git verb 화이트리스트 위반: Nz (allowed=)gitz-CTF)capture_outputtextr3checkenv) rrstrrresolve subprocessrunr1 returncodestdoutstrip)targetr3argsabspathprocs r_git_rorGHs 47"55"> g%%     D ??DKK--/ //rct|ddd\}}|dk7rtd|i}d}|jD]}|jdr|t ddj }1|jdsC|F|t ddj }|jd st|||t d d<|S) u``git worktree list --porcelain`` → {branch_name: worktree_path}. 모든 worktree(live 포함) 의 checked-out branch ref 를 파싱한다. rlistz --porcelainrzworktree list rc=Nz worktree zbranch refs/heads/)rGr splitlines startswithlenrB) repo_pathrcoutmappingcur_wtlinerefs rlist_checked_out_branchesrUbs iV]CGB Qw"%6rd#;<< GF ; ??; '#k*+,224F __Y 'F,>s9~'--/C~~m,4:C ./01 ; NrcBt|ddd\}}|dk7s|r|dk(ry|S)ulive(메인) workspace 가 현재 checkout 한 branch (detached → None). 이 branch ref 는 회장 §3 에 따라 **절대 reset 하지 않는다** (식별 전용). rz --abbrev-refHEADrNrG)rNrOrPs rlive_checkout_branchrYvs/ infEGB QwcSF] Jrc6t|dddd|\}}|dk(S)z@``git show-ref --verify --quiet refs/heads/`` (read-only).rz--verifyz--quietrJrrX)rNnamerO_s rlocal_ref_existsr]s- :z9 D66J EB 7Nrorigin)remotecdt|dd||\}}|dk7ryt|jS)uD``git ls-remote --heads origin `` 비어있지 않으면 True.rz--headsrT)rGboolrB)rNr[r_rOrPs rremote_ref_existsrbs7iiFGB Qw  rcDtjjddS)zuuid4 hex 12 (9-R.3 suffix).N )uuiduuid4hexrrr _new_runidrhs ::<  CR  rc:||vt||t||dS)uHcandidate 의 3-source 점유 여부 (read-only). True = 점유(충돌).rlocalr_)r]rb)rN candidate checked_outs r_proberns*,!)Y7#Iy9 r) max_attempts runid_factoryc t|}t|}t|||}t|j }d} d} |s|} d} d} nKd} d} | |krB| dz } |} |d| } t|| |}t|j s| } n| |krBt t tt||t|dt|dt|d d | || | d d }| d |d<t|d<d|dg|d<|S| |d<t|d<|S)u[collision-safe branch name 할당 (read-only, loop-until-clean). 1. candidate = ``base_name`` → 3-source(worktree/local/remote) 전부 absent 면 ``chosen_strategy=base`` 로 즉시 확정. 2. 하나라도 present → ``-`` 재생성·재검사 반복. 3. ``max_attempts`` 회 내 clean candidate 미발견 → ``STATUS_HOLD`` ("clean unique branch allocation 실패", 회장 §9 / 9-R.3). 강제 reset/삭제/생성 **0** — 충돌은 새 name 회피로만 해소(회장 §3). 반환 = branch_allocation_provenance.schema.json 와 1:1 dict. Nrbaser5suffixed-rrkr_rjT) schemaallocator_moduleallocator_versionts_utcbase_shacollision_detectedsources_checkedrunidrYchosen_strategyattempts read_onlyallocated_branch_namestatusu8clean unique branch allocation 실패 (loop-until-clean uB회 초과, 회장 §9 / 9-R.3). 강제 reset 0 — 회장 보고. hold_reasons) rUrYrnanyvaluesr r r r$rarr )rN base_nameryrorprm live_branch base_proberzr|r~ allocatedstrategyrlprobe base_records rallocate_branchrsr&,I6K&y1K 9k:JZ..01EH   % MH!OE$+Qug.I9i=Eu||~&% %$,.*0Z 34*W-.:h/0  +#!K&/1 +, + H !!-/0 0' N# +4K'(,K r) r r r r rrrrUrYr]rbr)returnr<)rdict[str, str])rC str | PathrDr<r3intrztuple[int, str])rNrrr)rNrrz str | None)rNrr[r<rra)rNrr[r<r_r<rra)rNrrlr<rmrrzdict[str, bool]) rNrrr<ryr<rorrpzCallable[[], str]rdict)"r __future__rr+r>rerrpathlibrtypingrrr __annotations__r r r rrr Exceptionrr$r1rGrUrYr]rbrhrnr__all__rrrrsQ,#  '"<*< ':' H:H**** Z*#$j$/+I9IE  <>04(8@  !$ 14   !      $-'1 LLL L  L % L L^ r