LiP 2dZddlZddlmcmZddlZddlZddl Z ddl m Z ddl Z ddl Z e ejjddZedz dz dz Zgd Zd e d e j&fd Ze j*d e d e j&fd ZGddZGddZej2j5ddddlmZd&deded efdZd'dede d efdZ!d(dede"de"d efdZ#de dedededed e f d Z$Gd!d"Z%edz d#z Z&Gd$d%Z'y))u test_3docs_e2e.py — 3문서 2유형 체계 End-to-End 통합 테스트 Phase 1~5 구현 완료된 3문서 체계(plan.md / context-notes.md / checklist.md)의 전체 흐름을 4개 그룹으로 검증한다: 1. dispatch → 3문서 자동 생성 2. team_prompts 3문서 지침 포함 여부 3. QC verifier 3문서 검증 (PASS / WARN / SKIP / FAIL 시나리오) 4. DIRECT-WORKFLOW.md 3문서 단계 존재 확인 기존 tests/test_dispatch_task_docs.py 와 독립 파일로 작성되어 충돌 없이 병렬 실행 가능. N)PathWORKSPACE_ROOT/home/jay/workspaceprompts templates task-docs)zplan.template.mdzcontext-notes.template.mdzchecklist.template.mdtmp_pathreturncttjjdd}t |t j vr)t j jdt |ddl}tt jjD]}|dk(s t j|=ddl }||_ |S)uMdispatch 모듈을 tmp_path를 WORKSPACE로 설정하여 격리 로드한다.rrrNdispatch)rosenvirongetstrsyspathinsertprompts.team_promptslistmoduleskeysr WORKSPACE)r workspacermod_name _dispatchs +/home/jay/workspace/tests/test_3docs_e2e.py_load_dispatch_with_workspacer'sRZZ^^$46KLMI 9~SXX% 3y>* ))+,& z ! H%&!#I c#$K|dz jdd|dz dz jdd|dz dz dz }|jddtD]B}t|z }|js||z j |j d d Dt tjjd d }tjjd }t|}|||_ ||tjd <y y w)uU격리된 WORKSPACE를 사용하는 dispatch 모듈 반환 + 템플릿 파일 복사.memoryTparentsexist_oktasksrrrutf-8encodingrrr N)mkdirTEMPLATE_FILESREAL_TEMPLATE_DIRexists write_text read_textrr rrrrrr)r tmpl_dirfnamesrcreal_workspace_original_dispatchmods r dispatch_modr4As t< 7"))$)F)#k1K?H NN4$N/]%' ::<   ) )#---*IT[ ) \] "**..)9;PQRN4 ' 1C I"CM%"4 J&s A0D3BDceZdZdZdej deddfdZdej deddfdZdej deddfdZ y) TestDispatchCreateTaskDocsu1dispatch._create_task_docs() E2E 통합 테스트r4r r Ncd}|j|d}d}||u}|stjd|fd||fdtjvstj |rtj |ndtj |dz}tjd d zd |iz}ttj|dx}}t|t} | s!tjd d zdtjvstj trtj tnddtjvstj |rtj |nddtjvstj trtj tndtj | dz} ttj| d} |dz dz dz |z } | j}|} | stjd| dzdtjvstj | rtj | ndtj |tj | dz} ttj| dx}} | j}|} | stjddzdtjvstj | rtj | ndtj |tj | dz} ttj| dx}} dD]} | | z } | j}|} | stjd| dzdtjvstj | rtj | ndtj |tj | dz} ttj| dx}} y)u#level=3(critical)에서 tasks/{task_id}/ 디렉토리와 3문서 파일이 생성된다. _create_task_docs(task_id, level=3) 호출 후 memory/plans/tasks/{task_id}/ 경로에 plan.md, context-notes.md, checklist.md 세 파일이 모두 존재해야 한다. task-9001levelN)is not)z%(py0)s is not %(py3)sresultpy0py3u>_create_task_docs가 None을 반환했다 (Path 반환 기대) >assert %(py5)spy5u(반환값이 Path 타입이어야 한다z7 >assert %(py4)s {%(py4)s = %(py0)s(%(py1)s, %(py2)s) } isinstancer)r?py1py2py4r plansr$u(디렉토리가 생성되지 않았다: C >assert %(py4)s {%(py4)s = %(py2)s {%(py2)s = %(py0)s.exists }() } expected_dirr?rErFu4디렉토리가 파일이 아닌 폴더여야 한다zC >assert %(py4)s {%(py4)s = %(py2)s {%(py2)s = %(py0)s.is_dir }() }plan.mdcontext-notes.md checklist.mdu*3문서 파일이 생성되지 않았다: fpath)_create_task_docs @pytest_ar_call_reprcompare @py_builtinslocals_should_repr_global_name _saferepr_format_assertmsgAssertionError_format_explanationrCrr+is_dir)selfr4r task_idr= @py_assert2 @py_assert1 @py_format4 @py_format6 @py_assert3 @py_format5rIr/rOs r5test_critical_level_creates_directory_and_three_fileszPTestDispatchCreateTaskDocs.test_critical_level_creates_directory_and_three_filesds//q/A!cvT!cccvTccccccvcccvcccTccc#ccccccc&$'S'SS)SSSSSSSzSSSzSSSSSS&SSS&SSSSSS$SSS$SSS'SSSSSS(*W4w>H ""_"$_$__(PQ]P^&_______|___|___"___$______""\"$\$\\&\\\\\\\|\\\|\\\"\\\$\\\\\\D XE 5(E<< W<> W> W W%OPUw#W W W W W W W5 W W W5 W W W< W W W> W W W W W W Xrc  d}|j|d|dz dz dz |z }dD]"}||z }|j}|}|stjd|d zd t j vstj |rtj|nd tj|tj|d z} ttj| d x}}|jd } | j}d}||} | stj|ddzdt j vstj | rtj| ndtj|tj|tj| dz} ttj| d x}x}} | jdd} | d| j}tj|}dD]}||v}|stj d|fd||fdt j vstj |rtj|nddt j vstj |rtj|nddz}tj|d|ddzd|iz} ttj| d }|d}||k(}|stj d|fd ||ftj|dt j vstj |rtj|ndd!z}tj|d"|d#|dd$zd%|iz}ttj|d x}}d&}|| v}|stj d'|fd(|| ftj|dt j vstj | rtj| ndd!z}tj|d)d$zd%|iz}ttj|d x}}d*}|| v}|stj d'|fd(|| ftj|dt j vstj | rtj| ndd!z}tj|d+d$zd%|iz}ttj|d x}}%y ),u생성된 3문서 각각의 YAML frontmatter에 필수 필드 4개가 존재한다. task_id, type, scope, status 필드가 있어야 하며, {task_id} / {date} 플레이스홀더가 실제 값으로 치환되어야 한다. z task-9002r9r:r rGr$rKu파일이 없다: rHrOrJNr%r&z---u: YAML frontmatter(---) 없음zN >assert %(py6)s {%(py6)s = %(py2)s {%(py2)s = %(py0)s.startswith }(%(py4)s) }content)r?rErFpy6)r\typescopestatusin)z%(py0)s in %(py2)sfielddata)r?rEu: 필수 YAML 필드 'u' 없음z >assert %(py4)srFr\==)z%(py1)s == %(py3)srDr@u$: task_id 치환 실패 — 기대: u , 실제: rArBz {task_id})not in)z%(py1)s not in %(py3)su(: {task_id} 플레이스홀더 미치환z{date}u%: {date} 플레이스홀더 미치환)rPr+rQrWrSrTrUrVrXrYr- startswithindexstripyaml safe_loadrR)r[r4r r\rIr/rOr^rarbre @py_assert5 @py_format7end_idx yaml_textrmrl @py_format3 @py_assert0r]r_r`s r)test_yaml_frontmatter_has_required_fieldszDTestDispatchCreateTaskDocs.test_yaml_frontmatter_has_required_fields{s&&wa&8(*W4w>H D ^E 5(E<< ?<> ?> ? ?%7w#? ? ? ? ? ? ?5 ? ? ?5 ? ? ?< ? ? ?> ? ? ? ? ? ?oowo7G%% Ve V%e, V, V V7U.V V V V V V V7 V V V7 V V V% V V Ve V V V, V V V V V VmmE1-G'*002I>>),D? V}UUUuUUUUUUuUUUuUUUUUUUUUUUUU/EeWH&UUUUUUU V ? ?g-  ?g   I#   v  '.   I'.  '=gYjQUV_Q`Pab      c;g- c c c;g c c c; c c c c c cg c c cg c c c c%8b/c c c c c c c ]87* ] ] ]87 ] ] ]8 ] ] ] ] ] ]7 ] ] ]7 ] ] ] ]ug5\,] ] ] ] ] ] ] ]% ^rcd}dddd}|jdd}g|jdtdtd tffd }t |d | |dk\r|j||t |d t }d }||k(} | s tjd | fd||fdtjvstjt rtjt nddtjvstjrtjndtj|tj|dz} tjddzd| iz} ttj| dx}x} }|dz dz dz |z } | j } | }| }|stjd| dzdtjvstj| rtj| ndtj| tj|dz}ttj|dx} x}}y#t |d wxYw)udispatch 내부 로직에서 level=2(normal)일 때는 _create_task_docs가 호출되지 않는다. dispatch()는 내부 레벨 정수가 3 이상일 때만 _create_task_docs를 호출한다. level<3 조건을 재현하여 호출 횟수가 0임을 검증한다. z task-9003r9)normalcriticalsecurityrtidlvr c<j||f||S)N)append)rrcalled original_fns r _tracking_fnzaTestDispatchCreateTaskDocs.test_normal_level_does_not_call_create_task_docs.._tracking_fns MM3) $sB' 'rrPrrn)z0%(py3)s {%(py3)s = %(py0)s(%(py1)s) } == %(py6)slenr)r?rDr@rfuFnormal(Lv.2) 레벨에서 _create_task_docs가 호출되면 안 된다z >assert %(py8)spy8Nr rGr$uEnormal 레벨에서 3문서 디렉토리가 생성되면 안 된다: zG >assert not %(py4)s {%(py4)s = %(py2)s {%(py2)s = %(py0)s.exists }() }rIrJ)rrPrintobjectsetattrrrQrRrSrTrUrVrWrXrYr+)r[r4r r\ _level_to_int docs_levelrr]rw @py_assert4rx @py_format9rIr^rar`rrs @@r0test_normal_level_does_not_call_create_task_docszKTestDispatchCreateTaskDocs.test_normal_level_does_not_call_create_task_docss#$!C "&&x3 (*"44  (c (s (v (  1<@ DQ..w C L"5{ C6{iai{aiii{aiiiiiisiiisiiiiii6iii6iii{iiiaiii!iiiiiiii (*W4w>H && &( (( ( TT`Sa b   6        '  )      L"5{ Cs I00I?) __name__ __module__ __qualname____doc__types ModuleTyperrcr}rrrr6r6asw;X!,,X8<X X.^!,,^8<^ ^B! !,,! 8<! ! rr6c\eZdZdZej dd dZd dZd dZd dZ y) TestTeamPromptsThreeDocsSectionu=team_prompts._build_three_docs_section() E2E 통합 테스트TautouseNcttjjdd}t |t j vr)t j jdt |ddlm }||_ y)u4_build_three_docs_section 함수를 임포트한다.rrr)_build_three_docs_sectionN) rr rrrrrrrr_build)r[rrs r_import_build_fnz0TestTeamPromptsThreeDocsSection._import_build_fnsO(8:OPQ y> ) HHOOAs9~ .B/ rc|jdd}d}||v}|stjd|fd||ftj|dt j vstj |rtj|nddz}tjdd zd |iz}ttj|d x}}y ) ulevel='critical'이면 반환 문자열에 '3문서 활용 지침' 텍스트가 포함된다. _build_three_docs_section("task-9001", "critical") 호출 결과에 '3문서 활용 지침' 문자열이 반드시 포함되어야 한다. r8ru3문서 활용 지침rjz%(py1)s in %(py3)sr=rpuAcritical 레벨에서 '3문서 활용 지침' 텍스트가 없다rArBN rrQrRrVrSrTrUrWrXrYr[r=r|r]r_r`s r4test_critical_level_contains_three_docs_guide_headerzTTestTeamPromptsThreeDocsSection.test_critical_level_contains_three_docs_guide_headers [*5& &&0  &&  '   6  +1  +1   P     rc|jdd}d}||v}|stjd|fd||ftj|dt j vstj |rtj|nddz}tjdd zd |iz}ttj|d x}}y ) ulevel='critical'이면 '보고서 작성 전 3문서 업데이트' 문구가 포함된다. _build_three_docs_section("task-9001", "critical") 호출 결과에 보고서 작성 전 3문서 업데이트를 안내하는 텍스트가 포함되어야 한다. r8ru)보고서 작성 전 3문서 업데이트rjrr=rpuYcritical 레벨에서 '보고서 작성 전 3문서 업데이트' 안내 문구가 없다rArBNrrs r1test_critical_level_contains_update_before_reportzQTestTeamPromptsThreeDocsSection.test_critical_level_contains_update_before_reports [*5: :fD  :f  ;   6  ?E  ?E   h     rc|jdd}d}||k(}|stjd|fd||fdtjvstj |rtj |ndtj |dz}tjdt|d zd |iz}ttj|d x}}y ) ulevel='normal'이면 빈 문자열('')을 반환한다. normal(Lv.2) 수준 작업에서는 3문서 지침이 불필요하므로 _build_three_docs_section 이 빈 문자열을 반환해야 한다. z task-9004rrn)z%(py0)s == %(py3)sr=r>uEnormal 레벨에서 빈 문자열이 반환되어야 한다. 실제: rArBN) rrQrRrSrTrUrVrWreprrXrY)r[r=r]r^r_r`s r&test_normal_level_returns_empty_stringzFTestTeamPromptsThreeDocsSection.test_normal_level_returns_empty_strings [(3 v|  v   6        TTXY_T`Sa b     rr N) rrrrpytestfixturerrrrrrrrrs1GV^^D!0"0      rrz+/home/jay/workspace/teams/dev6/qc/verifiers)verifyr\ricd|d|d|dS)u,테스트용 plan.md 내용을 생성한다. --- task_id: zH type: plan scope: task created: 2026-04-16 updated: 2026-04-16 status: u --- # 계획서: uR ## 목표 E2E 통합 테스트 완성 ## 범위 3문서 체계 전체 검증 r)r\ris r _make_plan_mdrs1 9 (y!) *r placeholderc&|sdnd}d|d|d|dS)u5테스트용 context-notes.md 내용을 생성한다.u실제 결정 근거 내용u!결정 근거: [미입력 내용]rum type: context scope: task created: 2026-04-16 updated: 2026-04-16 status: in-progress --- # 맥락 노트: u ## 결정 근거  r)r\rbodys r_make_context_notes_mdrs90; (AdD 9$9% &  r completedtotalcg}t|D]6}||kr|jd|dz |jd|dz8dj|}d|d|d|dS)u]테스트용 checklist.md 내용을 생성한다. completed/total 비율로 완료율 설정.u - [x] 항목 u - [ ] 항목 rruq type: checklist scope: task created: 2026-04-16 updated: 2026-04-16 status: in-progress --- # 체크리스트: z )rangerjoin)r\rrlinesichecklist_bodys r_make_checklist_mdr"s E 5\2 y= LL=Q0 1 LL=Q0 1 2 YYu%N 9&Yd  "  rr plan_contentcontext_contentchecklist_contentc|dz dz dz |z }|jdd|dz j|d|d z j|d|d z j|d|S) uTtmp workspace에 3문서 파일을 기록하고 디렉토리 경로를 반환한다.r rGr$Tr!rLr%r&rMrN)r(r,)rr\rrrdocs_dirs r_write_three_docsr9s|8#g-7'AH NN4$N/ %%lW%E ""...Q **+assert %(py6)srfN rrrr_three_docs_verifyrrQrRrVrWrXrY r[r r\r=r|rar]rbrxs rtest_pass_scenarioz*TestQcVerifierThreeDocs.test_pass_scenarioLs"&w}E27N0AQO  $Gs8}Mh 6 6)  6       $*  LFS[L\K]^ +, .      rc d}t||t|dt|dt|dd t |t | }|d }d }||k(}|st jd |fd||ft j|t j|dz}t jd|d d|ddzd|iz}tt j|dx}x}}y)uWARN 시나리오: plan.md status=draft면 WARN이 반환된다. 3문서가 모두 존재하더라도 plan.md의 status 필드가 'draft'이면 결과 status가 'WARN'이어야 한다. ztask-e2e-warn-draftdraftrFrr9rrrrriWARNrnrru9plan.md status=draft이면 WARN이어야 한다. 실제: rrrrfNrrs rtest_warn_scenario_draft_statusz7TestQcVerifierThreeDocs.test_warn_scenario_draft_statusbs (&ww?27N0AQO  $Gs8}Mh 6 6)  6       $*  HxHXGYZ +, .      rc d}t||t|dt|dt|dd t |t | }|d }d }||k(}|st jd |fd||ft j|t j|dz}t jd|d d|ddzd|iz}tt j|dx}x}}y)uWARN 시나리오: 플레이스홀더 미치환 잔존 시 WARN이 반환된다. context-notes.md 본문에 '[미입력 내용]' 형태의 플레이스홀더가 남아 있으면 결과 status가 'WARN'이어야 한다. ztask-e2e-warn-phrrTrr9rrrrrirrnrru<플레이스홀더 잔존 시 WARN이어야 한다. 실제: rrrrfNrrs r%test_warn_scenario_placeholder_existsz=TestQcVerifierThreeDocs.test_warn_scenario_placeholder_existsws %&w}E27M0AQO  $Gs8}Mh 6 6)  6       $*  K6RZK[J\] +, .      rcxd}t|t|}|d}d}||k(}|stjd|fd||ftj|tj|dz}tj d|dd |d d zd |iz}t tj|d x}x}}y )uSKIP 시나리오: 3문서 디렉토리 자체가 없으면 SKIP이 반환된다. Lv.2 이하 작업처럼 memory/plans/tasks/{task_id}/ 디렉토리가 없으면 결과 status가 'SKIP'이어야 한다. ztask-e2e-skip-nodirectoryrriSKIPrnrru6디렉토리 없을 때 SKIP이어야 한다. 실제: rrrrfN)rrrQrRrVrWrXrYrs rtest_skip_scenario_no_directoryz7TestQcVerifierThreeDocs.test_skip_scenario_no_directorys .$Gs8}Mh 6 6)  6       $*  EVHEUDVW +, .      rc>d}|dz dz dz |z }|jdd|dz jt|d d |d z jt|d d t |t |}|d}d}||k(}|st jd|fd||ft j|t j|dz}t jd|dd|ddzd|iz} tt j| dx}x}}y)u FAIL 시나리오: 3문서 디렉토리는 있으나 파일 중 하나가 누락되면 FAIL이 반환된다. memory/plans/tasks/{task_id}/ 디렉토리는 존재하지만 checklist.md가 없는 경우 결과 status가 'FAIL'이어야 한다. ztask-e2e-fail-missingr rGr$Tr!rLrrr%r&rMFrrriFAILrnrru0파일 누락 시 FAIL이어야 한다. 실제: rrrrfN) r(r,rrrrrQrRrVrWrXrY) r[r r\rr=r|rar]rbrxs rtest_fail_scenario_missing_filez7TestQcVerifierThreeDocs.test_fail_scenario_missing_filesA *h&07:WDtd3 I )) '- 87 *  & &22 "7 > 3 $Gs8}Mh 6 6)  6       $*  ?vh?O>PQ +, .      r) rrrrrrrrrrrrrrrIsdc 4 D ,   * d t *         rrzDIRECT-WORKFLOW.mdc\eZdZdZej dd dZd dZd dZd dZ y) TestDirectWorkflowThreeDocsStepsuVDIRECT-WORKFLOW.md에 3문서 관련 단계 텍스트가 존재하는지 확인한다.TrNctj}|}|stjdtdzdt j vstj trtjtndtj|tj|dz}ttj|dx}}tjd|_ y)uODIRECT-WORKFLOW.md 파일 내용을 읽어 인스턴스 변수에 저장한다.u%DIRECT-WORKFLOW.md 파일이 없다: rHDIRECT_WORKFLOW_PATHrJNr%r&) rr+rQrWrSrTrUrVrXrYr-_content)r[r^rarbs r_read_workflow_contentz7TestDirectWorkflowThreeDocsSteps._read_workflow_contents$** *, , 44H3I J   6  $  $  +  -     -666H rcd}|j}||v}|stjd|fd||ftj|dt j vstj |rtj|ndtj|dz}tjddzd|iz}ttj|d x}x}}y ) uDIRECT-WORKFLOW.md에 Step 1.2 '3문서 확인' 텍스트가 존재한다. 워크플로우 1.2단계에 '3문서 확인' 지시가 명시되어 있어야 팀장이 작업 시작 시 3문서를 확인한다는 것을 알 수 있다. u3문서 확인rjz0%(py1)s in %(py5)s {%(py5)s = %(py3)s._content }r[rDr@rBuCDIRECT-WORKFLOW.md에 'Step 1.2 3문서 확인' 텍스트가 없다 >assert %(py7)spy7N rrQrRrVrSrTrUrWrXrYr[r|rr]r` @py_format8s r%test_step_1_2_three_docs_check_existszFTestDirectWorkflowThreeDocsSteps.test_step_1_2_three_docs_check_existss   4== =0  =      6  $(  $(  $1   R      rcd}|j}||v}|stjd|fd||ftj|dt j vstj |rtj|ndtj|dz}tjddzd|iz}ttj|d x}x}}y ) uDIRECT-WORKFLOW.md에 Step 5.2 '3문서 업데이트' 텍스트가 존재한다. 워크플로우 5.2단계에 '3문서 업데이트' 지시가 명시되어 있어야 작업 완료 전 3문서를 갱신하는 절차가 강제된다. u3문서 업데이트rjrr[ruIDIRECT-WORKFLOW.md에 'Step 5.2 3문서 업데이트' 텍스트가 없다rrNrrs r&test_step_5_2_three_docs_update_existszGTestDirectWorkflowThreeDocsSteps.test_step_5_2_three_docs_update_existss &  %6  %  &   6  *.  *.  *7   X      rcd}|j}||v}|stjd|fd||ftj|dt j vstj |rtj|ndtj|dz}tjddzd|iz}ttj|d x}x}}y ) uDIRECT-WORKFLOW.md에 Step 5.3 '3문서 검증 강제' 텍스트가 존재한다. 워크플로우 5.3단계에 '3문서 검증 강제' 지시가 명시되어 있어야 .done 생성 전 QC verifier 검증이 강제됨을 명확히 한다. u3문서 검증 강제rjrr[ruJDIRECT-WORKFLOW.md에 'Step 5.3 3문서 검증 강제' 텍스트가 없다rrNrrs r-test_step_5_3_three_docs_verify_forced_existszNTestDirectWorkflowThreeDocsSteps.test_step_5_3_three_docs_verify_forced_existss ' $-- &-7  &-  '   6  +/  +/  +8   Y      rr) rrrrrrrrrrrrrrrs3`V^^D!I"I   rr)r)F)r9r)(rbuiltinsrS_pytest.assertion.rewrite assertionrewriterQr rrpathlibrrrurrREAL_WORKSPACEr*r)rrrr4r6rrrthree_docs_checkrrrrboolrrrrrrrrrrrs   bjjnn%57LMN"Y.<{JDU5E5E4545E$4$455>\ \ H, , h@A93&Cds$C.           i i `& 14HH' ' r