i 4UdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z ddl mZddlmZmZmZeeej*Zee j.vre j.j1deeeej*j*Zee j.vre j.j1de ddlmZmZmZ dZ!eejHjKddZ&e&dz dz Z'e&dz dz Z(e&dz dz Z)e&dz dz Z*e&dz dz Z+e&dz dz dz Z,dZ-dZ.de#d<dZ/de#d <id!hd"d#d$d%hd$d&d%hd%d&hd&hd'd(d&d)hd)d*hd*hd+d,d-d*hd-hd.d/hd0d1d2d*hd3hd4d2hd5d6hd7d8d9hd9e0e0e0e0hd:hd;d*de#d?<hd@Z2d e#dA<ddBZ3ddCZ4ddDZ5ddEZ6ddFZ7ddGZ8ddHZ9eddIZ:eddJZ:d dKddLZ:ddMZ;ddd dN ddOZddRZ?ddSddT ddUZ@ddVZAddWZBddXZC ddYZDddZZEdd[ZFdd\ZGdd]ZHdd^ZIdd_ZJdd`ZKddaZLddbZM d ddcZNdddZOddeZPddfZQddgZRddhZSddiZTddjZUddkZVddlZWddmZXddnZYddoZZddpZ[ddqZ\ddrZ]ddsZ^ddtZ_dduZ`ddvZaddwZbddxZcddyZdddzZedd{Zfdd|Zgdd}Zhddd~Ziejdk(re jeiyy#e"$rd Z!dZhd Zd e#d <d hZ d e#d<Y9wxYw)u_ taskctl.py — main 진입 단일화 + 상태 enforcement layer (task-2467 Phase A+B 통합) 회장 절대 기준: "taskctl을 거치지 않고는 main을 절대 변경할 수 없다." "모든 PR은 bot이 생성하고, 인간은 승인만 하며, main 반영은 taskctl만 수행한다." 상태 모델 (14정상 + 5예외 = 19종): 정상: CREATED → WORKTREE_READY → RUNNING → [HANDOFF_READY →] COMMITTED → PR_OPEN → CI_PENDING → GEMINI_PENDING → REVIEW_READY → VERIFIED → HUMAN_APPROVED → MERGING → MERGED → DONE 예외: BLOCKED / CANCELLED / FAILED / ESCALATED / ADMIN_OVERRIDE_USED 호환: DISPATCHED / ACKED / GUARD_PASS (기존 11상태 backwards-compat) 저장 위치: {WORKSPACE}/.tasks/state/.json Evidence: {WORKSPACE}/.tasks/evidence//.json bypass (회장 전용): TASKCTL_BYPASS=1 환경변수로 skip. evidence에 강제 기록. 종료 코드: 0 PASS / 정상 전이 1 FAIL (가드 차단, 잘못된 전이, evidence 미달, etc.) 2 internal error (subprocess 실행 실패 등) ) annotationsN)datetimetimezone)Path)AnyNoReturnoverload)reconcile_orphaned_mergeRECONCILE_CLASSIFICATIONSSUPPORTED_CLASSIFICATIONSTF> state_orphaned_after_valid_merge!state_missing_after_taskctl_crash"state_corrupted_with_partial_merge#state_inconsistent_after_force_pushzset[str]_RECONCILE_CLASSIFICATIONSr _SUPPORTED_CLASSIFICATIONSWORKSPACE_ROOTz/home/jay/workspace.tasksstateevidencescriptszguard.shzqc_report_guard.pyzgemini_evidence_verify.pymemoryzorchestration-auditzadmin-override.jsonl)zjonghyuk.jeon@gmail.com)zcancel-kill-switchzqc-checkzhidden-path-auditz lock-in-checkzmerge-safety-checkzgemini-review-gatezci/guardguardztuple[str, ...]REQUIRED_CHECKS)CREATEDWORKTREE_READYRUNNING HANDOFF_READY COMMITTEDPR_OPEN CI_PENDINGGEMINI_PENDING REVIEW_READYVERIFIEDHUMAN_APPROVEDMERGINGMERGEDDONEBLOCKEDRECOVERABLE_BLOCKED CANCELLEDFAILED ESCALATEDADMIN_OVERRIDE_USED DISPATCHEDACKED GUARD_PASSSTATESrr0r/rr/r0rr>r rrrrr >r r$r!r1r!r">r)r r#r#>r)r r$r1r$r%r1>r r$r%>r'r&r$r&>r,r'r*r'r(>r,r r+r->r,r&r r-r.)r+r,r.r)r*r-zdict[str, set[str]]ALLOWED_TRANSITIONS>r(r,r+r.TERMINAL_STATEScftjtjj dS)N%Y-%m-%dT%H:%M:%SZ)rnowrutcstrftimeB/home/jay/workspace/.worktrees/task-2472+1-dev2/scripts/taskctl.py_nowr>s! << % . ./C DDr<c H tj} t jgddddttjjxsd}|d|d S#t$r#tjj dd}YywxYw#t$rd}YDwxYw) NUSERunknowngitconfigz user.emailTcapture_outputtexttimeoutcwdz unknown@localz <>) getpassgetuser Exceptionosenvironget subprocessrunstr WORKSPACEstdoutstrip)useremails r=_actorrZs1   +dA3y>  &,,  V2eWA  1zz~~fi01   s#A$AB$)BB B! B!ct|dz S)N.json) STATE_DIRtask_ids r= _state_pathr`s '%( ((r<c|jDcic]\}}|dk7s ||}}}tj|dddScc}}w)N _checksumFT),:) ensure_ascii sort_keys separators)itemsjsondumps)rkvpayloads r=_canonical_jsonrnsE % B1k1Aq!tBGB ::gETj YYCs AAcxtjt|jdj S)Nutf-8)hashlibsha256rnencode hexdigest)rs r=_compute_checksumrus* >>/%077@ A K K MMr<c@|dgdgdddidddid ddddddddddddS)Nr) git_diff_sha changed_pathsbranch pr_numberpr_state ci_checksguard_sh_resultqc_report_guard_resultmerge_timestamp exit_codesFusedtsactorrrrreasonaudit_log_offset)r_ current_state transitionsrhuman_approvedbypassadmin_overrider;r^s r= _new_staters[" #&*#    t< $  % r<c$tjdd|jddt||d<t |d}|j d}|j tj|ddd |j|y) NTparentsexist_okrbr_z .json.tmpFreindentrpencoding) r]mkdirpoprur` with_suffix write_textrirjreplace)rptmps r=_saverst OOD4O0 IIk4 *51E+E)$%A -- $CNN4::e%BWNUKKNr<cyNr;r^s r=_loadrs+.r<cyrr;)r_ allow_missings r=rrsJMr<rc ~t|}|js|rytd|d|dd tj|j d}jd d}t|}||k7rtd |d |d |d d||d <|S#t $r}td|d|dYd}~_d}~wwxYw)Nustate 파일 없음: u (먼저 'taskctl init u ' 실행)rprustate 파일 파싱 실패:  → rbuJchecksum 불일치: 외부 수정 의심 (state file tampered). task_id=z stored=z expected=u0 → taskctl만 상태 변경 가능합니다.) r`exists_dieriloads read_textrNrru)r_rrrexcstoredexpecteds r=rrsGA 88:  $QC'>wiy QSTU> 1;;;89YY{D )F 'H   "x "$> ?    E+ L > +A3eC5 91==>s%B B< B77B<crt|z }|jdddjtjt t tjd}|j|||dz }tjt|d\}} tj|dd 5}tj||d d dddtj |t|y#1swY)xYw#t"$r' tj$|#t&$rYwxYwwxYw)uA9종 evidence를 .tasks/evidence//.json에 기록.Tr )commandr timestamppidr\.tmpdirsuffixwrprFrrN) EVIDENCE_DIRrjoinsysargvrZr>rOgetpidupdatetempfilemkstemprTfdopenridumprrNunlinkOSError) r_namermev_dirrecordpathfdtmp_pathfs r=_save_evidencer!s  G #F LLL-88CHH%Vyy{ F  MM' tfEN "D##F FCLB  YYr3 1 ?Q IIfaeA > ? 8SY' ? ?   IIh      sH D8C:'D:D?D D6D&%D6& D2/D61D22D6rmetaforcec |d}|rn{||k(r|dvrnq|dvr|tvretd|d|ddnQt||tj |t }||vr#td|d|dt |xsd d d||d<|j d d }||t|xsd djtjdtt|z d}|rd|d<|r||d<|dj|y)Nr>r >r,r)r+r-r*u비정상 전이: ru& (terminal 상태에서 전이 불가)ru (허용: none)r_rAtaskctlrrfromtorrr exit_code evidence_pathTforcedrr)r5r_check_forbidden_transitionsr4rQsetsortedr>rrrrTrappend) rtargetrrrsrcallowedr_entrys r= _transitionr@s,  C  36[0 Y Y / ! %cU%x7]^`a b %S&1%))#su5  $SEvhjAZTZ@[[\] $E/ii 9-Gf#)88CHH%\G34E h f  -&r<cB|dk(r|dvrtd|dd|dk(r|dvrtd|dd|d k(r|dk7rtd|d d|d k(r|d k7rtd|d d|dk(r|tvrtd|dd|dk(r|d k(r tddyyy)u<6개 금지 전이를 명시적으로 차단 (회장 §3.9).r$>r r$r1r#u금지 전이: uF → VERIFIED (반드시 REVIEW_READY 또는 GUARD_PASS 상태 필요)rr%r$r1u> → HUMAN_APPROVED (VERIFIED 또는 GUARD_PASS 상태 필요)r&u+ → MERGING (HUMAN_APPROVED 상태 필요)r(r'u → DONE (MERGED 상태 필요)r+u금지 전이: CANCELLED → u (CANCELLED는 terminal 상태)r)uF금지 전이: BLOCKED → MERGING (BLOCKED 상태에서 merge 차단)N)rr)rrs r=rrhs+` ` cU"h i  !!c1K&K cU"` a  s&66 cU"M N  C8O cU"B C   kfCE1 +F83R S   iFi/ T  0r<cjtd|tjtj|y)N [taskctl] file)printrstderrexit)msgcodes r=rrs" Jse 3::.HHTNr<c td|y)Nr)r)rs r= _print_okrs Jse r<x)rJrIenvc |}|2tjjd}|r t|nt}t j |dd|t|itj|xsiS)N TASKCTL_CWDTrGrHrIrJr)rOrPrQrrUrRrSrT)cmdrJrIr actual_cwdenv_cwds r=_runrsgJ**../&-T']9 >>    O )rzz )ciR )  r<cdD]'}tjj|}|s%|cStdz }|j r |j dj D]_}dD]X}|j|s|jdddjjdjd ccSa yy#t$rYywxYw) N)BOT_GITHUB_TOKEN GH_BOT_TOKENz .env.keysrpr)zBOT_GITHUB_TOKEN=z GH_BOT_TOKEN==r"') rOrPrQrUrr splitlines startswithsplitrWrN)env_nametokenv_keyslineprefixs r=_load_bot_tokenrs8jjnnX& J;&H  **G*<GGI SDSFv.#zz#q1!4::<BB3GMMcRRS S     s9C AC C CCc v tjgddddttjj }tjjddjtjd}||Dcgc]}|j c}vS#t $rd}YowxYwcc}w)NrBTrErFCHAIRMAN_EMAILSrc) rRrSrTrUrVrWrNrOrPrQrr r)rYres r=_verify_chairmanr s +dA3y>  &  jjnn.0IJPPQTUG 01QWWY0 00 1sAB% B6% B32B3c tjsytjtj }d\}}tj djD]}|js tj|}|jdd}tj|jdd}||z j}|d kr|d z }|d kr|d z }|d k\r||d fS|dk\r||dfS||dfS#t$rYwxYw)zWreturns (soft_count_30d, hard_count_90d, status: OK|SOFT_CAP_WARNING|HARD_CAP_EXCEEDED))rrOK)rrrprrr Zz+00:00rZrEHARD_CAP_EXCEEDEDSOFT_CAP_WARNINGr)ADMIN_OVERRIDE_LOGrrr8rr9rrrWrirrQ fromisoformatrdaysrN)r8softhardrrects_strrdeltas r=_check_admin_caprs  $ $ & ,,x|| $CJD$",,g,>IIK zz|  **T"CWWT2&F''sH(EFB2XOOE{ {   qyT... qyT--- t     s7A/D D  D c @tjjddt\}}}t ||d||||dz|dzd }tj dd5} | j tj|d d zdddy#1swYyxYw) NTrchairmanr) rr_rzrrhead_shabypassed_checkssoft_count_this_monthhard_count_this_quarterarprFre ) rparentrrr>openwriterirj) r_rzrr r!rr_rrs r=_record_admin_overrider+s##D4#@$&MD$f*!%#'!8 C  w 7<1  3U3d:;<<>*B /3 66r<ctdddt|ddgd}|jdk7rd |jd d j iS t j |jxsd S#t j$rd d icYSwxYw)ugh pr view로 PR 정보 조회.ghprview--jsonzEstate,mergeable,mergeStateStatus,statusCheckRollup,author,headRefNamerrIrerrorN{}json_parse_failed) rrT returncoderrWrirrVJSONDecodeError)rzprocs r= _gh_pr_viewr=s  dFC NY D !TU+11344.zz$++-..   .,--.s "A//B B c tgdjj}tgd}|jjDcgc]}|js|}}tgdjj}tgdj}|xsd|xsd|t |jDcgc]}|jsdc}dScc}wcc}w)N)rC rev-parsez --abbrev-refHEAD)rCdiffzorigin/main..HEADz --name-only)rCr?r@)rCstatusz --porcelainr)ryrwrxgit_status_porcelain_lines)rrVrWrlen)ryrArchangeddiff_sha porcelainlns r=_collect_git_evidencerI-s > ? F F L L NF C DD++002@Qaggiq@G@0188>>@H56==I.D (D &)y7K7K7M*\QSQYQYQ[1*\&]  A+]sC,%C, C1C1c&|sdiddddStdddt|ddgd }|jd k7r'didd|jd dj xsd dS t j |jxsd }|jdxsg}i}|D]m}|jdxs|jdxsd}|jdxs(|jdxs|jdxsd}|si|||<otD cic]} | |j| d} } |jd| ||jd|jddS#t j$r}diddd|dcYd}~Sd}~wwxYwcc} w)N no_pr_number)r{r| mergeablemerge_state_status pr_view_errorr1r2r3r4z2state,mergeable,mergeStateStatus,statusCheckRolluprr5rr7gh_errorr8z json_parse: statusCheckRolluprcontextr  conclusionrrBUNKNOWNMISSINGrLmergeStateStatus)r{r| ci_checks_allrLrM) rrTr:rrWrirrVr;rQr) rzr<datarrollupci_mapchkrrRn required_maps r=_collect_pr_evidencer];s  r&*^M M  dFC NF D ! r&*!%TU!3!9!9!;!IzK KSzz$++-.XX) * 0bFF&wwv:#'')"4:ggl+8swww/?8*8.7  %F4L & :IIAAvzz!Y//ILIHHW%!XXk*"hh'9:     S r&*|C5=QS SSJs$#E#F#F 6 FF F ctjsddddStdtt||gd}|jdk(rd nd |j|j d d|j d dd S) NrTzguard.sh not foundresultrrbashr5rPASSFAIL rar stdout_tail stderr_tail)GUARD_SHrrrTr:rVr)stager_r<s r= _run_guard_shrl^sp ?? ##AUVV Xw7 ED OOq0&f__{{45){{45)  r<c tjsddddStdttd|dttgd }|j d k(rd nd |j |j d d|jd ddS)NrTr_zqc_report_guard.py not foundr`python3 --task-idz --workspacerr5rrdrerfrg)QC_REPORT_GUARDrrrTrUr:rVr)r_r<s r=_run_qc_report_guardrqjs  ! ! ###A_``  C(+w sS\~^ D !OOq0&f__{{45){{45)  r<cH|sytd|jDS)NFc3&K|] }|dk( yw)SUCCESSNr;).0rls r= z,_all_required_checks_pass..|s:!qI~:s)allvalues)r|s r=_all_required_checks_passryys"  :y'7'7'9: ::r<c|jjddtjt |jd\}} t j |dd5}tj||dd d d d t j|t |y #1swY)xYw#t$r' t j|#t$rYwxYwwxYw) u1tempfile + os.replace 를 이용한 atomic write.TrrrrrprFrrN) r'rrrrTrOrrirrrNrr)rrWrrrs r= _atomic_writer{sKKdT2##DKK(8HLB  YYr3 1 =Q IIdAE! < = 8SY' = =   IIh      sH B2$B&>'B2&B/+B22 C"<CC" CC"CC"ct|j}|jrtd|jyt |j}|dj ddt tdjtjdtt|jz dt|t}t|jddjtjtt |j!d|j!d d d d|j!d dd td |jd |dy)Nzalready initialized: rrrrrstartryrwr ) rrrryr rVrrsharzzinit u → CREATED (r)r`r_rrrrr>rZrrrrTrrrIrrQ)argsrrgit_evs r=cmd_initrsDLL!Axxz)$,,89 t|| $E -ITVfh88CHH%A\DLL89!  %L " $F4<<88CHH%f**X&JJ~.zz.) + dll^>!A67 r<ct|j}t||t|t |t |jd|y)Nrru: → rrr_rrZrr)rrrrs r=_simple_transition_cmdrsA $,, EvVXD9 %L fVH-. r<ct|dS)Nr/rrs r= cmd_dispatchrs !$ 55r<ct|dS)Nr0rrs r=cmd_ackrs !$ 00r<c&t|j}|d}|dvr:t|dtt |t |jdyt|dtt |t |jdy)Nrr3rru : → RUNNINGrrrrrs r=cmd_runrsy $,, E  C 77E9FH5 e T\\N-01y1 %L m,- r<ct|dS)u<worktree-ready: CREATED/DISPATCHED/ACKED → WORKTREE_READY.rrrs r=cmd_worktree_readyrs !$(8 99r<ct|j}|ddk7rtd|dddt|dt t |t |jdy ) u#handoff: RUNNING → HANDOFF_READY.rruhandoff 불가: 현재 상태=u (RUNNING 필요)rrru: → HANDOFF_READYrrr_rrrZrrrrs r= cmd_handoffrse $,, E _* -eO.D-EEV WYZ[fh7 %L 123 r<c.t|j}|d}|dvrtd|ddt}|j dxsd}t |jd||j d g||j d ddd ||d j d d ||d d<|j d |d d <|j d g|d d <t |dtt|t|jd|dddy )uCcommit: RUNNING/HANDOFF_READY → COMMITTED + commit.json evidence.r>rrucommit 불가: 현재 상태=u& (RUNNING 또는 HANDOFF_READY 필요)rrwr commitrxryrrrz) rwrx commit_hashryrVrrr~rzrru: → COMMITTED (sha=Nr) rr_rrIrQrrrZrr)rrrrr s r= cmd_commitrs# $,, E  C .. ,SE1W XZ[\ " $Fzz.)/RH4<< OR8**X&:&**;7 , )1E*n%"(**X"6E*h)/OR)HE*o&{&(3 %L 3HRaL>CD r<ct|j}|d}|dvrtd|ddd}d}d}d}d}d}d } t} | j d xsd} | j d xsd} t |d d rt } | sOt|jddddd| dddt|dtddit|tdd|j}d|jd|}d|jd}i}| r| |d<d} ddd d!|d"|g}t||d#$}|jj}|jj}|j}|jdk7rtddd%| d&d'g|d($}|jdk(rj t!j"|j}|j d)}|j d*d}|j d+xsij d,d}d}|t|jdd-||j||| dd.td-|dn|}tddd%| d&d'g|d($}|jdk(rh t!j"|j}|j d)}|j d*|}|j d+xsij d,d}d/}|xsd}|j'd0j)d1}|j+d1xs|j-d0xs||v}|st|jdd2|d3|d4d|d5|| ||d6d7t|dtd8|d9t|td:|d;dn't |dds td<t|d?td|itgd@jjxsd}t|jd|j| || |||xs| | |||| dA t|t1|jdB|d4y#t$$rYVwxYw#t$$rYwxYw)Cuypr-open: COMMITTED → PR_OPEN. --pr : 기존 PR 번호 입력 --auto: bot token으로 직접 PR 생성 r>r rrrupr-open 불가: 현재 상태=u" (COMMITTED 또는 RUNNING 필요)rNr rmanualrwryautoFpr-openu;BOT_GITHUB_TOKEN 미설정 — fail-fast (chairman goal #4)zBOT_GITHUB_TOKEN missingT)r6rrVrr~rzbot_token_missingr-rrruMpr-open --auto: BOT_GITHUB_TOKEN 미설정 — fail-fast (chairman 명시 #4)[z] zTask z% PR (auto-created by taskctl pr-open)GH_TOKENbotr1r2createz--titlez--body<rrIr3r4znumber,url,authorrnumberurlauthorloginuPR 생성 실패: )r6rrVrr~rz)zjeon-jonghyuk-taskctl-botzapp/z[bot]uPR author bot 검증 실패: z (allowlist=rznon-bot author: re)r6rrVrr~rz pr_authorbot_author_checkpr_author_not_bot)rruPR author 검증 실패: u — chairman goal #2 #5u+pr-open: --pr <번호> 또는 --auto 필요rrzr rCr? origin/main) r_rybase_shar rzpr_urlr created_byrVrrr~u: → PR_OPEN (PR #)rr_rrIrQgetattrrrrrZrrrVrWrr:rirrN removeprefix removesuffixendswithrr2r)rrrrzrr stdout_str stderr_strrrrr ry bot_token short_desctitlebody env_override create_cmdr< find_procpr_info view_procviBOT_AUTHOR_ALLOWLIST_author author_norm is_bot_authorrs r= cmd_pr_openrs $,, E  C FF -cU2T UWXY IFIJJIJ " $Fzz.)/RH ZZ ! 'RFtVU##%  4<<V4!%)5  {&(&(;< > %L `bc d\\ DLL>J<0t||n$IJ') '0L $J $ u d JL"=[[&&( [[&&( OO ??a tVVX7JK "I##q("jj)9)9:G ' H 5I$[[3F!(X!6!<" A A'2 NI !I t||Y1*>!%((#!% 9)*6: FtVVX7JK "I##q(I$4$45B "x 0IVVE62F!#!1!7R < /r**62??H   W % 3!!&) 322   4<<8 \RfQgghi$,YK8&&$* 5  {&((;+46 7 %L ,YM9QRTU VtT4( > BGG  )2j+&yi7HI78??EEGM2H4<<<<,*  -  %L 1)A>? i!4!s&A)Q)A'Q  QQ Q-,Q-c t|j}|d}|dk7rtd|dd|djd}t |}|d|dd<|d |dd <t }|jd xsd }t |jd ||d t|d |d |jd d d|dt|dtd|it|t|jd|dy)uHci-check: PR_OPEN → CI_PENDING. 8 required CI checks 수집 + ci.json.rr uci-check 불가: 현재 상태=u (PR_OPEN 필요)rrrzr{r|rwr cirNr)rzr|all_passr rVrrr~r!r2ru: → CI_PENDING (PR #r) rr_rrQr]rIrryrrZrr)rrrpr_npr_evrr s r= cmd_ci_checkrs $,, E  C i .se3D EqI    -D  &E$)*$5E*j!%*;%7E*k" " $Fzz.)/RH4<<;'-eK.@A))OR0 ( |684,G %L 4TF!<= r<c(t|j}|d}|dk7rtd|dd|djd}t }|jdxsd }t j jd d }d |d }tjrttdz }|tjvr tjjd| ddlm} | |||} t!| t"r|j%| nt| |d<n(t)dtdtj*d|d<t-|jd||d|jdd|jdd d |jdd d|d t/|dt1d |i!t3|t5|jd"y#t&$r0} t)d| tj*d| |d<Yd} ~ d} ~ wwxYw)#uSgemini-evidence: CI_PENDING → GEMINI_PENDING. evaluate_gate 호출 + gemini.json.rr!u&gemini-evidence 불가: 현재 상태=u (CI_PENDING 필요)rrrzrwr GH_REPOJeon-Jonghyuk/dev_workspaceSKIP)hold_block_passr rr) evaluate_gate raw_resultu@[taskctl] WARNING: evaluate_gate 호출 실패 (graceful skip): ruevaluate_gate 실패: warningNz[taskctl] WARNING: u% 없음 — gemini gate graceful skipu gemini_evidence_verify.py 없음geminizgemini-code-assistseverity_countr) rzr app_slugrrrVrrr~r"r2ru: → GEMINI_PENDING)rr_rrQrIrOrPGEMINI_EVIDENCE_VERIFYrrTrUrrinsertgemini_evidence_verifyr isinstancedictrrNrrrrrZrr) rrrrrr repo gemini_result scripts_dirr gate_resultrs r=cmd_gemini_evidencers $,, E  C l 5cU:N OQRS    -D " $Fzz.)/RH ::>>)%B CD8>H$UM$$&)i/0 chh & HHOOA{ + F <'h=K+t,$$[1.1+.> l+ !"8!99^ _ $F i 4<<('++,G##Ir2 , 'vxtTlK %L 234 / F TUXTYZadakak l)?u'EM) $ Fs!AG H!&H  Hct|j}|d}|dk7rtd|ddt|dt t |t |jdy ) u.review-ready: GEMINI_PENDING → REVIEW_READY.rr"u#review-ready 불가: 현재 상태=u (GEMINI_PENDING 필요)rr#ru: → REVIEW_READYrrrs r=cmd_review_readyrse $,, E  C  23%7O PRST~VX6 %L 012 r<c6t|j}|d}|tvrtd|ddt }|d|dd<|d|dd<|d|dd<|j dxsd }|dj d }t |}|d |dd <|d |dd <|j d |dd <|j d|dd<d|vr |d|dd<td|j}|d|dd<||dd<t|j}|d|dd<||dd<|d|ddd<|d|ddd<t} |ddk(xr|ddk(} t|jd|d|d| ||j dd |j dd | rdnd||d | r|d vrt|d!tddd"#nt|d!tddd"#d|ddd<t|t|jd$|jr!t!t#j$|d%d&'y|d(vrt|d)td*d+i#d|ddd<t|g} |ddk7r| j'd,|d|ddk7r| j'd-|dt|jd.d/j)| d0|jr!t!t#j$|d%d&'y)1Nruverify 불가: 현재 상태=z (terminal)rryrrwrxr rzr{r|rLrMrNpre-pushrar}guard_sh_detailr~qc_report_guard_detailrrverify_guard_shverify_qc_report_guardrdverifyrhrir) r}r~hidden_path_auditr rVrrr~rz> r0r rrr!r/r1r#rr"rr1)guard_shqc_report_guardru): verify PASS → GUARD_PASS (= VERIFIED)Frr>r$r1r%r rz"verify failed, demoting to PR_OPENz guard.sh=zqc_report_guard=z: verify FAIL [, ])rr_r5rrIrQr]rlrq_hidden_path_audit_internalrrrZrrmachinerrirjrr) rrrrr rrguard_evqc_ev audit_resultr fail_reasonss r= cmd_verifyrs $,, E  C o ,SE =qA " $F"("2E*h(.~(>E*n%)/)@E*o&zz.)/RH    -D  &E$)*$5E*j!%*;%7E*k"%*YY{%;E*k".3ii8L.ME**+%-2?-Cj/*Z6H+3H+=E*'(+3E*'(  .E27/E*./27E*./9A+9NE*l#$56@Ek@RE*l#$<=/0L f$ & (Ov % 4<<#H-"'/),,}b1,,}b1"Q ,  ! ! |68*0VL N |68*0VL N45j,'1 e T\\N"KLM << $**UqA B ::E9FH"$HI K01E*l#H- %L LV#i(:';<= X& .uX.?@A odii .E-FaHI || djjU1=> r<crt|j}|d}|dvrtd|ddt|ddxs t }|dj d }d}|rWt jj d }|r|}n3t|}|j d xsij d xsd}d |vr|jd dn|}t} | j dxsd} |rW|sUt|jdddd|ddd| |d t|dt ddit|td|dd|rZ||k(rUt|jddd||ddd| |d t|dt ddit|td|ddd } dd!lm} | |} | j s+d"} t#d#| j$d$t&j(%d'|d(<t|jd|xsd)|d*| | d"k(t-|dj d+id'| ddd| |t/d,t|d-t || d.d|dd/d0<t|t1|jd1|dy#t*$rt#d&t&j(%YwxYw)2uLapprove: VERIFIED 또는 GUARD_PASS → HUMAN_APPROVED. self-approve 차단.rruapprove 불가: 현재 상태=u$ (GUARD_PASS 또는 VERIFIED 필요)rbyNrrzTASKCTL_PR_AUTHOR_OVERRIDErrrrrwr approvalreu%pr_author lookup failed — fail-fastzgh pr view returned no author) rarrapproverrVrrr~rzr-rpr_author_lookup_failedru-approve 차단: pr_author 조회 실패 (PR #rzself-approve detecteduself-approve 차단z self-approveu,self-approve 차단: PR author == approver (system)check_approver_identityrz [WARN] P0-5: u → manual approval로 분류ru8[WARN] lifecycle_guards not found — P0-5 guard skippedTrrArdr|)rrra approval_typerci_pass gemini_passr rVrrr~rzrr%)rrrapproveu: → HUMAN_APPROVED (by: )rr_rrrZrQrOrPr=rrIrrrlifecycle_guardsrokrrrr ImportErrorryr>r)rrrrrr _overridepr_dataapprover_loginrr rr approver_chks r= cmd_approver _s $,, E  C ,, ,SE1U V  tT4(4FHH    -D I JJNN#?@ !I!$'G X.4"99'BJdI/2hX^^C(+HN " $Fzz.)/RH It||Z=&5 2  E;fh"$=> @ e   $M  3 344RSZZ #E 4<<+)"&8+,U:->-B-B;PR-STf. 'vx"0=QS12E*l#I. %L 88HJK 5 [ HszzZ[s(AJ$J65J6c t|j}t|dtdt |ddit |t |jdy)Nr+rru: → CANCELLEDr)rr_rrZrrrrs r= cmd_cancelr sO $,, E{&(h =>@ %L o./ r<ct|j}t|dtd|jit |t |jd|jdy)Nr,rru: → FAILED (rr)rr_rrZrrrrs r=cmd_failrsS $,, Exvx ,. %L nT[[M;< r<ct|jd}|U|jr/tt j |jddddytd|jdy|jr"tt j |dd ytd |d td |dtdt |d|d}td|jdtd|jdtd|jdtd|jdtd|dtd|dy)NTr)r_rmissingFr%rz: state file missingrrrztask: r_zstate: rz transitions: rrzbranch: ryzpr: rzz guard_sh: r}zqc_report_guard: r~zhuman_approved: rzbypass: r)rr_rrrirjrDrQ)rrevs r= cmd_statusrsl $,,d 3E } << $**)-/=BD E Jt||n,@A B || djjU1=>  uY'()* o./01 c% "6789: :  )*+, RVVK()*+ 266"34567 !"&&)A"B!CDE  '7!8 9:; x)*+ r<cr&t|j} ddlm}m}||j}|ds)t |jd|t d|dd||j}|ds)t |jd|t d |ddt}t|dd }t|dd } |rdttd|d<tdtj ddlm} | |j} | j"s/d|ddd<t%|t d| j&dn|r`t)s t ddt+\} } }|dk(rt d| d d|d!k(rYtd"| d#tjn8|d$d%k7r6d|ddd<t%|t d&|d$d'|jd(d|d$d)k(r"d|ddd<t%|t d*d|d$d+k(r"d|ddd<t%|t d,dt-d-|j}|d.|dd/<||dd0<|d.d1k7r)d|ddd<t%|t d2|d3d4dt/|j}|d.|dd5<||dd6<|d.d1k7r)d|ddd<t%|t d7|d3d4d|dj1d8}|rt3|}|d9|dd9<|d:|dd:<|j1d;|dd;<|j1d<|dd<<|j1d;d=vrE|j1d;4d|ddd<t%|t d>|j1d;dt5|d:s(d|ddd<t%|t d?|d:d|dj1d8}|s"d|ddd<t%|t d@dt7}|j1dAxsdB}| rt}||ddC<d|ddD<d|ddd<|d$d%k(s|s|rBt9|dEtd||dF|Gt%|t9|dHtddi|Gnt9|dHtd|dI|Gt |jddJj;tj<ddd|dBdB||ddK t%|t?|jdL|d4y|d$d%k(r+t9|dEt||dM|xs|Gt%|n*|s|r&t9|dEt||dMdGt%||rJt|ddNxsdN}tA|j|||dOgPdtdQ|ddR|dS<t%|tBjDj1dTdU}dVdWdtG|dXdYdZ|g}|r|jId[tK|d\d]id^_}|jL|jNd`d|jd`dda|ddb<dB}|jLdk7rr|jL|ddd<|jr|jd`dndB&dc}tQ&fdd|D}|r\ t9|detdf|jLd4&dgddhdG tGtT}|tjVvr tjVjYd|ddll-m.}||jdEdedf|jLdm&dgddn|jdogtTpt |jddJj;tj<|jLdBde||jNd`d|jd`d||ddq t%|t dr|jLds&dtddu|jdv|jLxsdt9|ditddj|jLidGt |jddJj;tj<|jLdBdi||jNd`d|jd`d||dw t%|t dx|jLds|jdtd|jLxsdt}||ddC<d|ddd<|}tKdVdydz|d{gd|}} | jLdk(r2 tcjd| jN}!|!j1d~dB} ddlm4}"d}# tk|}$|$j1dxsd}#|"|||#}%|%j"s{d|ddd<t9|ditdd|%j&idGt |jd|%jmt%|t d|%j&d|%jnj1d||dd<t9|dHt||||d|xs|G|rt9|dtddidGt |jddJj;tj<d|dH||jNd`d|jd`d|||d t%||rt?|jd|dyt?|jd|dy#t$r8}t |jd d d |d dt d|dYd}~ d}~wwxYw#t$r0}d|ddd<t%|t d|dYd}~d}~wwxYw#tR$r,t9|ditddj|jLdkidGYwxYw#tt^t`f$rYpwxYw#tf$rdB}YwxYw#tf$rd}#YwxYw#t$rtdtjYwxYw)Nrcheck_state_file_present check_done_escalated_coexistencermerge_blocked_state_missingu#merge 차단 (state file missing): rrmerge_blocked_coexistenceumerge 차단 (coexistence): "merge_blocked_guard_v2_import_failFu*silent_corruption_guard v2 import 실패: silent_corruption_guard_v2rrru$merge 차단 (P-SC v2 import fail): admindry_runTrru3★★★ TASKCTL BYPASS USED — Chairman overrider)check_bypass_auditrrmergeumerge 차단 (P0-8): u-merge 차단 (lifecycle_guards import fail): u<admin override 차단: 회장(chairman) 자격 검증 실패ru1admin override 차단: HARD_CAP_EXCEEDED (분기 u회 사용 ≥ 5회)ru3[taskctl] WARNING: SOFT_CAP_WARNING — 이번 달 u회 사용 (soft limit 3회)rr%umerge 차단: 현재 상태=u* (HUMAN_APPROVED 필요. 'taskctl approve u ' 먼저)r+umerge 차단: state=CANCELLEDr)u=merge 차단: state=BLOCKED (HOLD/CONFLICT 시 머지 차단)rrar}guard_sh_detail_mergerdu+merge 차단: guard.sh pre-push FAIL (exit=rrr~qc_report_guard_detail_mergeu)merge 차단: qc_report_guard FAIL (exit=rzr{r|rLrM>N MERGEABLEumerge 차단: PR mergeable=u1merge 차단: 8 required CI checks 미통과 — u7merge 차단: PR 번호 없음 (taskctl pr-open 먼저)rwr r merge_dry_runr&)rrrrr')rrr) rrmerge_commit_shar{r rVrr~rzru,: dry-run merge → MERGING → MERGED (PR #)rrzadmin overrideself_approve_constraint)r_rzrr r!rrrrrr1r2z--mergez--delete-branch--repo--adminTASKCTL_INVOKEDr.rrrf)rrhrimerge_subprocess)zbranch protectionzRequired status checkzrequired status checkzreview requiredzapproving review unresolvedznot in mergeable statezPull request is not mergeablezmerge state statusrUr)DIRTYUNSTABLEBEHINDc3&K|]}|v ywrr;)rumarkerris r=rvzcmd_merge..sQV6[0Qr*ztransient merge block (exit=8)rrir,zgh pr merge exit=z (transient detect failed)append_recovery): .tasks/evidence/z /merge.jsonr_ from_stateto_staterevidence_paths workspace) rrr$r{r rVrr~rz transientuCmerge 차단 (transient → RECOVERABLE_BLOCKED): gh pr merge exit=z stderr=r7z (use 'taskctl recover z ' to retry)) rrr$r{r rVrr~rzumerge 실패: gh pr merge exit=api/repos/ /commits/mainrr5r~)check_merge_commit_sha baseRefName)r base_branchzP0-6 SHA mismatch: merge_sha_failumerge 차단 (P0-6): r$u<[WARN] lifecycle_guards not found — P0-6 SHA check skipped)r2rrr$r.zadmin override used) rrr$r{r rVrr~rzrz: admin-override merge PR #u/ → MERGING → MERGED → ADMIN_OVERRIDE_USEDz : merged PR #u- → MERGING → MERGED (taskctl done 필요))8rr_utils.silent_corruption_guardrrrrrr/rr>rZrrrrrrrrr rrlrqrQr]ryrIrrrrr+rOrPrTrrr:rVany SystemExitrUrrutils.audit_chairman_recoveryr3AttributeErrorrrirrNr?r=as_dictdetail)'rrrrsf_chkcoex_chkrrrrr bypass_chkrr cap_statusrrrrrr merge_tsrr merge_cmdr<r$transient_markers is_transient_ws_root_append_recovery owner_repoapi_procapi_data_check_merge_sha pr_base_ref_pr_datasha_chkris' @r= cmd_merger[s $,, E> *$,,7d| 4<<)F O 6vh7G6HI1 M3DLLA~ 4<<)Dh O /0B/CDa H F D'5 )EdIu-G &X h C#**U K ;+DLL9J==;<j!,/8e ,Z->->,?@!D ! OQR S!1!3dJ , , & 46  + + EdVKghZZ   !%5 578E* l +G 4 %L .u_/E.FG<<@LL>T   ![ 078E* l +G 4 %L 0! 4  !Y .78E* l +G 4 %L PRS T T\\:/7/Aj+,5=j12 H  '78E* l +G 4 %L !+./q2  %T\\26;Hoj23NLL67  & $ #  e  ::>>)%B CDtWc$i388+HHOOAx0! LL(29$//9J#kZ^Z_N`Mab*4<<. D$(  4<<88CHH-!__$&1$++de,++de,!! 3  %L $$(OO#4H[=O?kk$%() + OO q vH+3E*'(/0E*l#G,J u |=9:Ha "zz(//2H'||E26  _O"&  "4(H#<< 6>$K#4d Lzz78E* l +G 4 xvx&*=gnn=M(NO" $ 4<<)97??;L M %L ((891 =070B0BCUWg0hj,- xvx FU*:<o'  E0"$9: 4<<88CHH%,++de$++de$ +  %L T\\N"=dVCrst  T\\N-v5bcd  >t||%IB3%H1L  3C5 91== >6 K78E* l +G 4 %L @F J J  Kp (E868"*.??PPj,k!l"&(( (2 9  v "!  " K  _ LSVS]S]^^_sBl;Am,n1Bo-1o*p( o<B4p m -mm n$%nn1o  o o'&o'* o98o9< p p p  p$p65p6cF t|j}|ddk7rtd|ddd ddlm}|dj d }|s&t |jd d d d tddtjj dd}|t||}|ds)t |jd |td|dd ddlm }m }||j} | ds)t |jd| td| dd||j} | ds)t |jd| td| dd dd#l m} m} | |j} | j s>t |jd$| j#td%| j$d|dj d }|dj d&xs|dj d'}| |j||}|j s>t |jd(|j#td)|j$dtjj dd}d-}t'd.d/d0|d1gd23}|j(dk(r2 t+j,|j.}|j d4d-}t2d5z d6z }|j5d7d78||jd9z }|j7t+j8|jt;|d:d d;<d=>t |jd?|t=|t;d-d-d||dj d d@t?|dAtABtC|tE|jdC|dDy#t$r8}t |jdd d|ddtd|dYd}~-d}~wwxYw#t$r8}t |jdd d |d!dtd"|dYd}~d}~wwxYw#t$r8}t |jdd d*|d+dtd,|dYd}~+d}~wwxYw#t0$rd-}YwxYw)Eu<done: state == MERGED 검증 + .done 생성 → DONE 전이.rr'udone 불가: 현재 상태=u (MERGED 필요)rr)verify_done_preconditionsrrzdone_blocked_silent_corruptionFz4pr_number missing in state.evidence (P-SC pre-check)rru7done 차단 (P-SC): pr_number missing in state.evidencerrru&done 차단 (P-SC silent_corruption): rdone_blocked_guard_import_failu'silent_corruption_guard import 실패: silent_corruption_guardru done 차단 (P-SC import fail): Nrdone_blocked_state_missingu"done 차단 (state file missing): done_blocked_coexistenceudone 차단 (coexistence): !done_blocked_guard_v2_import_failufsilent_corruption_guard v2 (check_state_file_present/check_done_escalated_coexistence) import 실패: ru#done 차단 (P-SC v2 import fail): )check_g3_fail_blocks_donecheck_done_g3_pass_evidencedone_blocked_g3_failudone 차단 (P0-1): r$rwdone_blocked_g3_evidenceudone 차단 (P0-2): u lifecycle_guards import 실패: ru,done 차단 (lifecycle_guards import fail): r r1r<r=r>rr5r~reventsTrz.done)r_rr$rrrprdone)r$ done_pathrrVrrr~rzr(ru: → DONE (.done: r)#rr_rrCr]rQrrOrPintrrrrrerfrrHrrr:rirrVrNrUrrrjr>rTrrZrr)rrr]pr_n_screpo_sc sc_resultrrrrJrKrerf g3_fail_chk pr_n_for_g3head_sha_for_g3 g3_pass_chkrr$rUrV events_dir done_files r=cmd_donervs $,, E _) )%*@)AAQ R  :K #'' 4 4<<)IPL  JA N**..,IJ-c'lGD  4<<)I9 U 9)H:M9NOQR S=l)$,,7d| 4<<)Ev N 5fX6F5GH! L4DLLA~ 4<<)CX N .x/A.BCQ GF[/ = ~~ 4<<)?ATATAV W ' (:(:';>)%B CD uv]34Ha "zz(//2H'||E26  X%0JTD1 ~U33I  t||46(8:HMVW Y4<<,^f:&**;7 * vVX. %L 1)A>? G :t||%E?uE.H  /u 5q99:. = t||%H~@CDE1K  23% 8!<<=8 Ft||%E8>'H  ;C5 A1EEF( "!  "s\B"OBP DQ $1R P-PP Q -QQ  R-R  R R R cddlm}||j}tt j |dd|j drdSdS)u.tasks/state/{task_id}.json 무결성 검사. JSON 출력: exists, readable, json_valid, checksum_present, checksum_match, current_state, issues 토르-A의 utils/state_repair.py::inspect_state 함수를 호출. r) inspect_stateFrrchecksum_matchr)utils.state_repairrxr_rrirjrQ)rrxras r=cmd_state_inspectr{sA 1 4<< (F $**V% :; +,13!3r<cddlm}||j|j|jt |j }ttj|dd|jdrdSdS) ustate file checksum repair. Chairman approval evidence 필수. --approved-by-chairman --evidence --action 토르-A의 utils/state_repair.py::repair_state 함수를 호출. r) repair_state)approved_by_chairmanrr repair_actionFrrrr) rzr}r_r~rrZactionrrirjrQ)rr}ras r=cmd_state_repairrsa0  !66mmhkk F $**V% :; 4 1'a'r<cddlm}||j}tt j |dd|j drdSdS)urepair 후 후속 검증. .verify-pending 마커 제거 시 PASS. 토르-A의 utils/state_repair.py::verify_consistency 함수를 호출. r)verify_consistencyFrrrr)rzrr_rrirjrQ)rrras r=cmd_verify_consistencyr4s@ 6  -F $**V% :; 4 1'a'r<c D t|j}|ddk7rtd|ddd|djd}|s tddtj jd d }g}||d }d \}}} t d ddt|d|ddgd} | j| j| j}}}d} |dk(ry tj|} | jd} | jdxsg}|Dcgc]}|jdr|}}| dk(xr| } | t!|d|d<nd|j%xsd!|i|d<| s|j'd"|djd#xsd$}d}|r t d d%d&|d'|d(gd}|jdk(rtj|j}|jd)xsg}|Dcgc]:}|jd*d+k(r$|jd,d-vr|jd.<}}|Dcgc](}|jd*d+k7s|jd.*}}| xr| xr t)|}t!|||d/|d0<nd|jxsd$d1di|d0<ndd2i|d0<|s|j'd3d} dd4lm}||| }t)t/|d5d}|t/|d6d$d7|d8<|s|j'd:d} t d ddt|d|dd;gd}|jdk(r\tj|j}|jd<xsd$}|jd=xsd$} |d>vxs| d?v}|| d@|dA<nd|jxsd$d1di|dA<|s|j'dB|rTt3|jdCd||dDtdEdFj5|dGtj6|dHddIdt9|dJt;dgdKdLM tt<}!|!t>j@vr t>j@jCd|!ddNl"m#}"|"|jddJdOdP|jdQgt<Rt3|jdSdTddJ|dUtM|tO|jdVy#t$r%} t| jd| }Yd} ~ Nd} ~ wwxYwcc}w#tj"$r} dd | i|d<Yd} ~ d} ~ wwxYwcc}wcc}w#t$r*} dt| jd| i|d0<Yd} ~ d} ~ wwxYw#t0$r dd9i|d8<Yt$r*} dt| jd| i|d8<Yd} ~ d} ~ wwxYw#t$r*} dt| jd| i|dA<Yd} ~ Od} ~ wwxYw#t0tHtJf$rYvwxYw)WuRECOVERABLE_BLOCKED → MERGING 자동 복귀. 4 조건 모두 충족 시에만 복귀: 1. review threads all resolved (gh pr view --json reviewDecision,reviewThreads) 2. required CI all PASS (gh api repos/{repo}/commits/{sha}/check-runs) 3. Gemini High 0건 (lifecycle_guards.check_gemini_severity) 4. mergeStateStatus CLEAN 또는 MERGEABLE admin override 없이 객관적 4 조건만 평가. 단일 조건 미충족 시 차단. rr*urecover 불가: 현재 상태=u (RECOVERABLE_BLOCKED 필요)rrrzu3recover 차단: pr_number missing in state.evidencerr)rzr)r r r1r2r3r&r4zreviewDecision,reviewThreadsrr5: NFrreviewDecision reviewThreads isResolvedAPPROVED)decisionunresolved_countreviewr6z JSON decode: zgh exit=)review_threads_unresolved_or_not_approvedrwr r<r=z /commits/z /check-runs check_runsrB completedrR>neutralskippedsuccessr)totalfailedpendingrr1zhead_sha missingrequired_ci_not_all_pass)check_gemini_severityrrr_rzlifecycle_guards not installedgemini_high_present_or_unknownzmergeStateStatus,mergeablerUrL>CLEAN>r")rBrL merge_statemerge_state_not_cleanrecover_blocked)rfailed_conditionsrIu$recover 차단: 4 조건 미충족 (rz ). detail=r%ir&)rrrr)recovered_fromconditions_passedrr2z>auto-recover: 4 conditions PASS (review/ci/gemini/merge_state)r5z /recover.jsonr6recoverT)rrrrIu1: RECOVERABLE_BLOCKED → MERGING (4 조건 PASS))(rr_rrQrOrPrrTr:rVrrNtype__name__rirrDr;rWrboolrrrrrrrjrrZrUrrrrFr3rGrrr)#rrrrrrIrc1stdout1stderr1proc1r review_okrWrthreadstr*r ci_okproc2cdatarunsrbadr gemini_okrgem_chkmss_okproc4mdatamssrLrRrSs# r= cmd_recoverrDs $,, E _!66 ,U?-C,DE+ ,     -D  BAF ::>>)%B CD#%+/>F)C'1 4THd 5 7  !& 0 0%,, gWI ax @::g&Dxx 01Hhh/52G%,HAEE,4G!HJH!Z/C^I$$' O F8 $W]]_%H(3%8HIx   !LMZ $$^4:H E EuvYxj LME1$ 5<<0yy.4",0&'uuX+5l+3TTEE&M 37YQ!%%/[:X155=YY B7{BT  Y!& t !(%,,*<"de)DEt  !34t   !;<I E:'$TB$67 gx4 x   !ABFJ 4THd 3 5    q JJu||,E))./52C +.4"II%Cm)CF/2$KF= !%,u||/Ar45.I$JF= !   !89t||%6!29  2499=N3O2PQjje 388 # HHOOAx (  LL,S"4<<. >  4<<% -  %L <<.IJ i 1#Y''(3%01I ## @ '=)>?F8  @* Z E#S (:(:';2cU%CDF4L E& G#%EFx E#S (:(:';2cU%CDxE, J!(T#Y-?-?,@3%*H I}JT  1   sAS( ?T T!T%TAU.?U -U3U U AU9V B!W6A2X( T1TTTU1 UU U VVV WW$W  W XW??XXXc ts tdd|j}|j}t |j }|j }|s tdd|tvrtd|dttd|tvr td|dttddi}|jxsgD]L}d|vrtd |d d|jdd\}}|j||j<Nd Dcgc] }||vs| } }| rtd | d d|d} |d} t|} | js t| z } t!| } t"j$j'dd}t)d|d|d| d| ddd t* tddt+|| | | |t|}t-|d|| | | ||d|j'd|j'd|j'd|j'd d! |ds0td"|j'dd#|j'ddt)d$|d%|j'd d&|j'dy'cc}w)(ureconcile: state file missing + PR merge + .done valid 케이스 정합화. classification enum 4종 중 ``state_orphaned_after_valid_merge``만 1차 지원. 기타 enum은 reject (인식만). 검증 단계: 1. PR state=MERGED 2. mergeCommit ancestor of origin/main 3. .done payload schema (task-timer or taskctl_done 포맷) 4. .done sha256 audit jsonl 일치 5. .g3-fail 자동 분류 (false_alert_resolved_by_late_report만 허용) 6. state 재구성 (CREATED→...→DONE 합성) 7. checksum 생성 (taskctl 호환) 8. audit 14필드 jsonl append 9. verify-consistency 10. marker read-only 유지 ugreconcile 불가: utils.state_repair import 실패. WORKSPACE_ROOT 환경변수 또는 sys.path 확인.ruWreconcile 차단: --approved-by-chairman 플래그 필수 (회장 승인 확인 필요)u!reconcile 차단: classification=u) 은 정의되지 않은 enum. 허용: u6 는 enum 인식만 지원. 1차 실 동작 지원: u7 이 케이스는 향후 spec 갱신 + 구현 필요.ru--evidence 형식 오류: u (key=value 필요))r2 merge-commitu0reconcile 차단: --evidence 필수 키 없음: u6 예: --evidence pr=40 --evidence merge-commit=r2rrrureconcile 시작: task_id=z, classification=z, pr=z, merge_commit=N z...uDreconcile 불가: state_repair 모듈 핸들 None (재import 실패))r_rzr$rrr:r~ reconciler step_failedr audit_path state_path) classificationrzr$rr~ result_okrrrrureconcile 실패: step_failed=z , reason=ureconcile 성공: task_id=u → DONE state_path=z audit_path=r)_STATE_REPAIR_AVAILABLErr_rrr~rrrrrrrWr is_absoluterUrTrOrPrQr_reconcile_orphaned_merger)rr_rapprovedevidence_path_str evidence_dictitemrkrl missing_keysrzr$ev_pathevidence_path_absrras r= cmd_reconcilers$ #  B  <  77 //AB))/0J)K(LME F   %'M$"- d? -dX5HI1 Mzz#q!1#$779 aggi - 6P!-9OAPLP >|nMD E  d#I$^4$%G    g%G  ::>>)%B CD $WI->~>NO[(8"(='>c C !( SUVW &)' %F7K(,* (D\zz-0**X&jj.jj. *  $< ,VZZ -F,GHjj*+ -   $WI. <012 <01 3 }Qs  J J cdgd}gd}d}g}g}|D]d} tjddd|gttddd }|jd k(r%|j j D]}|jd d }|r|d n|t|d k\r|d nddvr9tfd|DrNjdr`j} | jdxsJ| jdxs7| jdxs$| jdxs| jd} tfd|D} | s| s|j||j| g|sdnd} | ||dS#t$r} |jd| Yd} ~ d} ~ wwxYw)u%repo 전체 grep으로 금지 패턴 검색. PASS/FAIL 반환. 회장 §3.8: 주석/docstring/문자열 단순 언급은 violation 아님. 실제 subprocess 호출만 차단. code_call_markers: subprocess.run / _run([ / 리스트 형태로 인자 전달 — 실제 호출 패턴. )z gh pr createz gh pr mergezgit push origin mainzgit push --force origin mainz&worktree_manager finish --action merge)z.gittestsfixtures .worktrees node_modules __pycache__) z subprocess.z_run(z_run([z"gh", "pr", "create"z'gh', 'pr', 'create'z"gh", "pr", "merge"z'gh', 'pr', 'merge' check_call check_outputzPopen(rCgrepz-nTr)rJrGrHrIrrdrrr zscripts/taskctl.pyc3&K|]}|v ywrr;)rurrs r=rvz._hidden_path_audit_internal..s;33$;;r0)z.mdz.txtr\z.logz.jsonlz.ymlz.yaml#z- z* z"""z'''c3&K|]}|v ywrr;)rumcontents r=rvz._hidden_path_audit_internal..s)R1!w,)Rr0z audit_error: Nrdre)ra violationswarnings)rRrSrTrUr:rVrrrDrDrrWrrrN)forbidden_patternsexcludescode_call_markersrrpatternr<rpartsstripped is_commenthas_call_markerrrarrs @@r=rrs ZH JH%%5$ 5>>g. N#$D !# KK224,D JJsA.E',58$D*-e*/eAhrG+t3 ;(;; }}%`a &}}H!++C06#..t46#..t46$..u56$..u5 '*)R@Q)R&RO! - %%d+7,%5L&V6FJH MM 5    cU3 4 4 5sE F F/F**F/c~t}|ddk(r tdytdt|ddtj |dD] }td |tj "y ) u@audit-hidden-paths: repo 전체 grep으로 우회 경로 감지.rardu*hidden-path-audit PASS: 우회 경로 0건rz"[taskctl] hidden-path-audit FAIL: ru 건 발견rz VIOLATION: r)rrrrDrr)rrarls r=cmd_audit_hidden_pathsrsx ( *F h6!>? 23vl7K3L2MZX::  % 8A M!%CJJ 7 8r<c |j|j|jttdz }|t j vr t j jd| ddlm}td z d z z tjtj}|jd |jd  dM dNfd }tdz dz dz j!s|ddtdddt\}}|stti?}|j&dk7rit%dd0d6d7tgt%dd8d9gd@|j&dA|j(dBdj+}| |t|dj-dCttdD|j.dEddF }t;|t=dGdHj-dCdIdJdKdL y#t$r}td|d|ddYd}~d}~wwxYw)Puotakeover: handoff 검증 → 새 worktree+branch 생성 → start_task_guard 자동 호출 → evidence 저장.rr)validate_handoffu'validate_handoff 모듈 import 실패: z u9/validate_handoff.py 파일이 있는지 확인하세요.rNrrz%Y%m%dT%H%M%SZr7c  jdd|xsijddd d||d }tdd z |y#t$rYywxYw) NTr previous_bottask/-r) r_rnew_bot from_branch new_branch started_at ts_filenametakeover_statusfailure_reason failure_check takeover-r\)rrQr{rN) rrhandoff_data_partialrevidence_dir_earlyrrr_rts_isos r=_save_early_failurez)cmd_takeover.._save_early_failures   $ $TD $ A"!5!; @ @ P"* %gYay9$*#+"(!. B ,;-u/MMr R   sA A AArhandoffsr\uhandoff 파일 없음: 1_handoff_existsrT)r_rycheck_head_shaworkspace_rootuhandoff 검증 실패: z; 2_validate_handoffuhandoff 검증 실패: rCr?z--verifyz from-branch 'u' 존재하지 않음: 3_from_branch_existsr r rru#새 worktree 경로 이미 존재: 5_worktree_path_collisionu/새 worktree 경로가 이미 존재합니다: ru새 branch 이미 존재: 6_branch_collisionu 새 branch 'u_'가 이미 존재합니다. 다른 bot ID를 사용하거나 기존 branch를 삭제하세요.ru origin/main HEAD 조회 실패: rc jd tt  d|d }t|y#t$rYywxYw)Nrr) r_rrrr  handoff_pathrrnew_worktree_pathrrrr)rQrTr{rN)rrr evidence_filer handoff_datarrrr recorded_headr_rrs r=_save_failed_evidencez+cmd_takeover.._save_failed_evidenceD sj " , 0 0 @"$) #L 1*(%():%;$*#+"(B - ,   s=A A  A worktreeaddz-brugit worktree add 실패: zstart_task_guard.pyremovez--forceryz-Dustart_task_guard.py 없음: z--task--botrrrustart_task_guard 실패 (exit=r4r7rrrf) r_rrrr rrrrrrrstart_guard_stdoututakeover 성공: z previous_bot=u → new_bot=z new branch: z new worktree: z evidence: r)rrTrrTrz dict | NonereturnNone)rrTrr)r_rrrTrUrrrrrrrr8rr9r:rrrr:rrWrQrVrRrS executablerOrPr{r) rrrrnow_utcrrerrors err_linesr< proc_branch proc_main evidence_dirr proc_wtrstart_guard_script proc_guardrrrrrrrrrrrr_rrs @@@@@@@@@@@@@r= cmd_takeoverrs<D !K=(? @Q@Q@S?T U "  K=(? @Q@Q@S?T U  !$$Z4M!L0gYay3II!12C1D E '  =>O=P Q   7),J{J CDK"( 5  :,'Q R  89Iq  / 0@0@0F0F0H/I JAN%%'Hx'*4w>L Y{m5#AAM* z5  j G Q,W^^-A-A-C,DEf% VQ*Y69NN  $ $ &&25JJ  $ $ & eZ9c:K6L MN eXtZ 01/0B/CDf% VQ /0(GWgV  ! " :;= R%,',-.(/  + k   5cU; V X    s7T U"T;;Uc tjdd}|jdd}d}|jdd }|||j t |jd d }|||j t |jdd }|||j t |jdd }|||j t |jdd }|||jdtdd|jddd|j t |jdd }|||jddd|j t |jdd }|||jd!dd"#|j t |jd$d% }|||jd&dd'|jd(dd)|jd*dd+#|j t |jd,d- }|||jd*d.|j t |jd/d0 }|||jd*d1|j t |jd2d3 }|||jddd4|j t" |jd5d6 }|||jd7d8dd9d:;|jd|j t$ |jd?d@ }|||j t& |jdAdB }|||j t( |jdCdD }|||j t* |jdEdF }|||j t, |jdGdH }|||j t. |jdIdJ }|||j t0 |jdKdL }|||j t2 |jdMdN }|||j t4 |jdOdP }|jdQddR>|jdSdt7gdTdUV|jdWdXgdYZ|jd[dd\|jd]dd^>|j t8 |jd_d` }|j t: |jdadb }|||j t< |jdcdd }|||jd[dde>|jdWddf>|jdgdhdigddjk|j t> |jdldm }|||j t@ |S)nNruhtask 상태 enforcement layer + main 진입 단일 경로 (task-2467: 14+5 state machine + PR lifecycle))prog descriptionrT)destrequiredc*|jddy)Nr_utask ID (예: task-2467)help) add_argument)sps r= _add_taskidz!build_parser.._add_taskid s  (BCr<inituCREATED 상태 생성r")funcdispatchu DISPATCHED 전환 (compat alias)ackuACKED 전환 (compat alias)rSuRUNNING 전환ru<PR_OPEN 전환 (bot token PR 생성 또는 PR 번호 입력)z--pruPR 번호 (수동 입력))rdefaultr#z--auto store_trueu bot token으로 직접 PR 생성)rr#ruSevidence 자동 수집 + guard.sh + qc_report_guard, PASS 시 GUARD_PASS(=VERIFIED)z --machineustate JSON 출력ru+HUMAN_APPROVED 전환 (self-approve 차단)z--byu6승인자 (human login). 미지정 시 _actor() 사용)r+r#ru.main 진입 단일 경로 (MERGING → MERGED)z --dry-runu,actual gh pr merge skip — 상태만 전이r'u1chairman admin override (audit log 자동 기록)z--reasonuadmin override 사유canceluCANCELLED 전환)r+failu FAILED 전환)r rBu현재 상태 + evidence 출력u JSON 출력takeoveruQhandoff evidence 기반 봇 인계 — 새 worktree + branch + start_guard 자동z--fromrBRANCHu/이전 봇의 branch (예: task/task-2458-dev4))rr metavarr#r u새 봇 ID (예: dev5))r r#zworktree-readyu*WORKTREE_READY 전환 (dispatch/ack alias)handoffu0HANDOFF_READY 전환 (RUNNING → HANDOFF_READY)ru6COMMITTED 전환 (RUNNING/HANDOFF_READY → COMMITTED)zci-checku/CI_PENDING 전환 + 8 required CI checks 수집zgemini-evidenceu,GEMINI_PENDING 전환 + evaluate_gate 호출z review-readyu5REVIEW_READY 전환 (GEMINI_PENDING → REVIEW_READY)rju3DONE 전환 (MERGED → DONE + .done 파일 생성)ruWRECOVERABLE_BLOCKED → MERGING 복귀 (review/CI/gemini/merge_state 4 조건 PASS 시)ruistate file missing + PR merge + .done valid 케이스를 정합화 (state_orphaned_after_valid_merge 등)rou대상 task IDz--classification)r rrrureconcile 케이스 분류)r choicesr#z --evidenceruWkey=value 형식 evidence (반복 가능: --evidence pr=40 --evidence merge-commit=abc))rr+r#z--approved-by-chairmanu9회장 승인 (필수 — 이 플래그 없이는 차단)z--evidence-pathu회장 audit jsonl 경로zaudit-hidden-pathsuVrepo 전체 grep으로 우회 경로 감지 (gh pr create/merge, git push origin main)z state-inspectu6state file 무결성 검사 (checksum, json 유효성)z state-repairu*checksum repair (chairman evidence 필수)u승인자 이름u!chairman approval evidence 경로z--actionrecompute_checksumrollback_to_backupurepair 동작 선택)r3r r#zverify-consistencyu?repair 후 후속 검증 (.verify-pending 마커 제거 확인))!argparseArgumentParseradd_subparsers add_parser set_defaultsrrrrr$rlrrr r[r rrrrrrrrrrvrrrrr{rr)rsubr&r%s r= build_parserr< s  = A   D  9CD %< =BOR__(_3  )K LBOR__,_7 $A BBOR__'_2 $4 5BOR__'_2  (f gBOOOFd9TOUOOH\8ZO[OOO%  b  dBOOOK ;NOOOOO$  (U VBOOOFD/gOhOOO% &V WBOOOK GIOOIlLNOOJ3JOKOOO# '9 :BOOOJO-OOO$ _ 5BOOOJO.OOO" 'H IBOOOK =OIOOO$  `  BOOO}tX >OOGd1IOJOOO& (/[ \BOR__*<_=  (Z [BOR__+_6 '_ `BOR__*_5  )Z [BOR__,_7 )0^ _BOR__*=_> -d eBOR__*:_; %Z [BOR__(_3  f  BOR__+_6 6  B OOK$5EOFOO  * OO f  OO  H OO%;VOWOOO' , e  gBOO/O0 .f gBOR__*;_< -Y ZBOOO,tBTOUOOL46YOZOO%';< #  OO)O* ,3t uBOR__*@_A Hr<cDt}|j|} |j|}xsdS#t$rtj $r}t d|dYd}~6d}~wt$r/}t dt|jd|dYd}~ld}~wwxYw)Nzsubprocess timeout: rzinternal error: rr) r< parse_argsr(rErRTimeoutExpiredrrNrr)rparserrrcrs r=mainrBF s ^F   T "D@ YYt_ 7N   $ $. #C5 )1-- @ S 2 232cU ;Q??@s!4BA$$ B0%BB__main__)rrT)r_rTrr)rdict[str, Any]rrT)r_rTrrD)rrDrr)r_rTrrrdict[str, Any] | None)r_rTrrTrmrDrr) rrDrrTr str | NonerrErrrr)rrTrrTrr)r)rrTrrlrr)rrTrr) r list[str]rJz Path | NonerIrlrzdict[str, str] | Nonerzsubprocess.CompletedProcess)rrF)rr)rztuple[int, int, str]) r_rTrz int | NonerrTr rTr!rGrr)rzrlrrD)rrD)rzrHrrD)rkrTr_rTrrD)r|zdict[str, str]rr)rrrWrDrr)rargparse.Namespacerrlr)rrIrrTrrErrl)rzargparse.ArgumentParser)rzlist[str] | Nonerrl)l__doc__ __future__rr6rLrqrirOrRrrrrpathlibrtypingrrr rT__file__r' _SCRIPTS_DIRrr_WORKSPACE_ROOT_STRrzr rr rr rrr__annotations__rPrQrUr]rrjrprrr rr2rr4r5r>rZr`rnrurrrrrrrrrrr rr+r/r=rIr]rlrqryr{rrrrrrrrrrrrrr r rrr[rvr{rrrrrrrr<rBrrr;r<r=rRs8#  '** 4>(() sxxHHOOA|$ $x.//667chh&HHOOA*+ #$  02GH I  7 * 8#j0 y : -i'*>>"Y.1LL),AADZZ. $ <, 8,7,-, i) * , yk , 8 ,i-,),B,#Y/,<,D,!9-,;,7,$:%,& vh',( CE),,e5>I23=,(DSRE ()Z N: . . M M16<>LP.2#%'+%'%'(,%'P% Z 04C&*#/J,. 16< <'<14<<$-< <47 .&  F  ; * >;? "7 CF 61  :   :\ ~ 8. b  "U zb J   NB (A Rc L  z CHHTVeP # $, +, s K99LL