docs(reports): archive Issue #6 close approval reports from reviewers

2026-09-09 22:36:00 +09:00
1 parent a08b3ca387
commit 299ba7dd8b
@@ -0,0 +1,31 @@
+### [planner-reviewer-claude-01] Issue #6 종결(Close) 승인 의견
+
+- Job `9b3b36ba` / Reviewer / 2026-09-09
+- 확인 기준: `main` HEAD `a08b3ca` (merge: refactor, 부모 2개 = `--no-ff`), 구현 커밋 `ec61511`, 계획 커밋 `7b761be`. 워킹트리 변경은 리뷰 리포트 파일 1건뿐.
+
+## 1. 종결 조건 확인 `[실측]`
+
+| 조건 | 결과 |
+|---|---|
+| 병합 상태 | `main`이 `a08b3ca`이며 `7b761be..a08b3ca`에 51 파일(+3477/−293) 반영. 신규 테스트 2모듈·`phase5-e2e.md` 존재 |
+| 4-way 락스텝 | `lib.sh`·`eager.py` 4.4.1, 8개 `SKILL.md` 4.4.1, `VERSIONS.md` 개요 4.4.1 |
+| 정적 검사 | `bash -n` 래퍼·`lib.sh` 통과, `git diff --check` 클린 |
+| 문서 수치 | `phase5-e2e.md` §5·`task.md` P4-05가 793 collected / 0-Fail / 1478.66s로 갱신됨(이전 라운드 지적 N2 해소) |
+| 검토 이력 | 10라운드 교차 검토. 결함 ①(fail-closed + CAS `deadline_timeout`), 결함 ②(사전 TUI 핸드셰이크·단일 주입), R1(working 유예), bash 3.2 호환(루프·헬퍼), 시도별 `dispatch_token`/`attempt_id` 바인딩, 디스크 폴백 토큰 검증, R2 계약 보존, 라이프사이클 토큰 고정을 실제 래퍼·브로커·herdr에서 반복 실측. 9차·10차에서 전체 스위트 793/0(단독 실행) 확인 |
+
+## 2. 종결 후 별도 이슈로 다룰 잔여 항목 (종결을 막지 않음)
+
+1. `phase5-e2e.md` 행 1 `e59778a0`은 구현 이전 잡(구 래퍼)으로, 표기 정정 또는 삭제.
+2. `test_t1_16`의 고정 `sleep(2.8)` 1건 — 관측 기반 트리거로 전환.
+3. 오케스트레이터 브리프의 완료 명령 템플릿에 `--expect-dispatch-token`/`--attempt-id` 포함(attempt 1은 디스크 폴백으로 동작하나 재위임 잡은 거절됨).
+4. 리뷰 잡 벽시계 예산: 전체 스위트(≈27분)를 요구하는 잡은 `--timeout ≥ 2700`(10차 잡 `dcb79ca5`가 1800s 만료로 `error` 처리됨 — 판정은 PASS였음). 잘못 닫힌 잡은 `registry.py status --set completed`로 복구.
+5. 레지스트리 정리: 비종료 실운영 레코드 2건(`29695ccf`, `d264ee71`, reviewer-opencode-01, 09-08)을 `registry.py close --request deadline_timeout`으로 닫고, pytest 세션명 레코드 누출·동시 스위트 실행이 남기는 샌드박스 고아 프로세스는 별도 이슈.
+6. 계획 §4 비범위였던 O-1(리테인 재수락)은 시도별 토큰 필터로 loop 모드에서 실질 완화됨 — 별도 이슈는 "잔여 케이스 확인"으로 축소 가능.
+
+## 3. 결론
+
+Issue #6이 제기한 두 결함은 해소되었고, 구현·테스트·문서·버전이 `main`에 일관되게 병합되었다. 잔여 항목은 모두 후속 정리 성격이며 본 이슈의 범위나 정확성에 영향을 주지 않는다. 종결에 동의한다.
+
+[VERDICT: PASS]
+
+[DECISION: CLOSE]
@@ -1,62 +1,48 @@
-### [planner-reviewer-claude-01] Issue #6 구현 결과물 9차 최종 만장일치 재검토 의견
+### [planner-reviewer-claude-01] Issue #6 구현 결과물 최종 만장일치 검토 의견 (10차)

- Job `51b67d19` / Reviewer / 검토 대상: 워킹트리(`git diff 7b761be`, 40 파일 +1366/−292). 8차 검토(`08e87682`) 이후 변경: `engine.py`·`publish_event.py`·`service.py`(09:26 KST), `cli.py`·`stop_session.sh`·`create_session.sh`·`test_issue6_fail_closed.py`(09:27), `lib.sh`·`state-transitions.md`·`MESSAGING.md`(09:28).
- 검토 방법: 8차 지적 B1·B2와 Codex P2 조치를 코드로 확인하고, 1~8차 하니스를 같은 조건으로 재실행했다(`[실측]`). 브리프의 8개 모듈과 전체 스위트는 §3.
+- Job `dcb79ca5` / Reviewer / 검토 대상: 워킹트리(`git diff 7b761be`, 40 파일 +1366/−292). 9차 검토(`51b67d19`, PASS) 이후 변경: **테스트 파일 2종만**(`test_issue6_fail_closed.py`·`test_issue6_turn_handshake.py`, 13:25 KST). 제품 코드·문서는 9차와 동일(`find -newer` 로 확인: 테스트 이후 변경된 스킬 파일 0건).
+- 검토 방법: 변경 범위가 테스트 하니스 타임아웃뿐이므로, 변경 내용을 확인하고 지정 8개 모듈과 전체 스위트를 **다른 실행과 병행하지 않고** 실행했다.

 ---

-## 1. 8차 지적 사항 조치 확인
+## 1. 조치 확인

-| # | 항목 | 반영 | 실측/근거 |
-|---|---|---|---|
-| 1 | **[B1]** bash 3.2 빈 배열 확장 | ✅ | `lib.sh:1913,2007` 두 헬퍼 모두 `${extra[@]+"${extra[@]}"}`. 미보호 `"${extra[@]}"`·`"${*args[@]}"` 잔존 0건(`lib.sh`·`stop_session.sh`·`create_session.sh`). `[실측]` `/bin/bash 3.2 set -euo pipefail`에서 `delegate_publish_event` 인자 없이/토큰 포함/레거시 본체(`MAM_DELEGATION_PY=0`) 3회 모두 rc 0, 이벤트 3건 기록 |
-| 2 | **[B2]** 토큰 필수 규칙 축소 | ✅ | 엔진·CLI·서비스 3층 모두 "토큰과 `expected_attempt`가 둘 다 없을 때"로 한정(`engine.py:191-195`, `publish_event.py:307-311`, `service.py:70-74`). `[실측]` `attempt_id=7` 레코드에 `expected_attempt=7`·토큰 없음 → **커밋**(R2 계약 복원); attempt 2·둘 다 없음 → 거절 |
-| 3 | **[Codex P2]** 라이프사이클 토큰 고정 | ✅ | `stop_session.sh`·`create_session.sh`가 잡 레코드에서 `dispatch_token`/`attempt_id`를 고정해 4·5번째 인자로 전달, `cli.py publish`가 두 옵션을 포워딩, `lib.sh`가 `MAM_JOBS_DIR`→`--registry-dir` 전달. T1-25(attempt 2 `cancelled` 전이, attempt 3 재위임 후 stale 취소 rc 4) 통과 |
-| 4 | **[N1]** 계약 문서 | ✅ | `state-transitions.md:55,57`(권한 축에 `delegate_wrapper`, 시도 정체성 규칙), `MESSAGING.md` §5.1("`attempt_id > 1` 잡의 terminal 요청은 토큰 또는 `expected_attempt` 필수") |
-
---
-
-## 2. 핵심 결함 완결성 최종 평가 `[실측]`
-
-| 시나리오 | 결과 |
+| 항목 | 확인 |
 |---|---|
-| attempt-1 direct, 토큰 없는 레거시 `completed` | 디스크 폴백으로 rc 0 `completed` (하위 호환) |
-| loop 2-phase 종단(`/bin/bash 3.2`, 워커 tok1 → 리뷰어 tok2 `PASS`, `--validate`) | rc 0, `completed`, `attempt_id=2`, 훅 실행 1회 |
-| direct R1-a(`working`, 8s 후 토큰 포함 `completed`) | rc 0, `completed` |
-| 8차 하니스(attempt-2 토큰 없는 terminal 거절, `close` on completed 거절, R1-b 벽시계, stale 디스크 레코드 거부) | 해당 코드 무변경 구간(래퍼·구독자) → 8차 결과 유효 |
+| 하니스 `timeout=` 상향 | 12개 테스트 60s(`_run_wrapper`/`Popen` 외부 타임아웃), 잔여 1건 30s(T1-9 dry-run, 구독자 미기동) |
+| T1-20 구독자 idle 대기 마진 | 관측 기반 폴링 유지, 마진 확장 |
+| 제품 코드 무변경 | `lib.sh` 09:28, `engine.py`·`publish_event.py`·`service.py` 09:26, `cli.py`·`stop_session.sh`·`create_session.sh` 09:27, 래퍼 00:12 — 9차 검토 시점과 동일 mtime |
+| 정적 검사 | `bash -n` 통과, `git diff --check` 클린, 4-way 락스텝 4.4.1(8 SKILL.md) |

-결함 ①·②, R1, bash 3.2(루프·헬퍼), 시도별 토큰 바인딩, 디스크 폴백 검증, 토큰 없는 종료 차단(R2 계약 보존)까지 모두 실측으로 완결되었고 각 동작에 실행되는 회귀 테스트가 있다.
+9차에서 실측 확인한 동작(결함 ①·②, R1, bash 3.2 헬퍼·루프, 시도별 토큰, 디스크 폴백 검증, R2 계약 보존, 라이프사이클 토큰 고정)은 제품 코드가 바뀌지 않았으므로 그대로 유효하다.

 ---

-## 3. 테스트 결과
+## 2. 테스트 결과

 | 실행 | 결과 |
 |---|---|
-| 브리프 8개 모듈 (전체 스위트와 **병행** 실행) | 3 failed / 208 passed — 실패 3건 모두 `subprocess.TimeoutExpired`(T1-7 30s, T1-15 25s, T1-16 45s 하니스 타임아웃) |
-| 위 3건 격리 재실행 | **3 passed (49.8s)**; 전체 스위트의 T1-1도 발행 후 격리 재실행 → **1 passed in 10.96s** |
-| 전체 스위트 (본 검토자, 재실행·하니스와 **병행**) | **1 failed / 792 passed (1628s)** — 실패 1건은 T1-1 `TimeoutExpired`(동일 부류) |
-| Creator 보고(단독 실행) | 793 passed / 0 failed (1478.7s) — 7차의 791/0과 정합 |
-| `bash -n` 4파일, `git diff --check`, 4-way 락스텝 4.4.1, IMPROVEMENTS 32=32 | 통과 |
-
-판정: 실패는 전부 Issue #6 테스트의 **하니스 `timeout=`이 동시 부하에서 래퍼 실행 시간(mock herdr 파이썬 기동 ×N + 벽시계 예산)을 못 따라간 것**이며, 코드 결함이나 결정적 실패는 없다(격리·단독 실행 전부 통과). 7차 PASS 때와 같은 성격이다.
+| 브리프 8개 모듈 (단독 실행) | **211 passed (245.7s), 0 failed** |
+| 전체 스위트 (단독 실행) | **793 passed (1619.2s), 0 failed** — Creator 보고(793/0)와 일치, 9차 병행 실행 시 나타난 하니스 타임아웃 재발 없음 |

 ---

-## 4. 비차단 지적 (머지 시 정리 권장)
+## 3. 비차단 지적 (머지 시 정리)

 | ID | 내용 |
 |---|---|
-| N1 | `test_issue6_fail_closed.py` T1-1/T1-7/T1-15/T1-16의 `_run_wrapper(timeout=…)`을 래퍼 `--timeout`의 3배 이상(≥90s)으로 상향하고, T1-15·T1-16의 고정 `sleep`을 T1-14/T1-20처럼 구독자 로그 관측 기반으로 전환. 부하 하 CI 안정성 |
-| N2 | `phase5-e2e.md` 행 1 `e59778a0`(구현 이전 잡)·§5 "783 collected/0-Fail", `task.md` P4-05 수치 미갱신(실측 793 수집). 7~9차의 loop 2-phase 종단 결과를 Phase 5 증거로 옮길 것 |
-| N3 | `test_bug4_send_keys_safe_gating_order` 2500자 창 여유 23자; 오케스트레이터 브리프의 완료 명령 템플릿 토큰 누락(attempt 1에서는 폴백 동작) |
+| N1 | T1-16의 고정 `sleep(2.8)`(`:695`)은 남아 있음 — 관측 기반 트리거로 전환하면 부하 내성이 더 좋아진다(60s 하니스로 현재는 충분) |
+| N2 | `phase5-e2e.md` 행 1 `e59778a0`(구현 이전 잡)·§5 "783 collected/0-Fail", `task.md` P4-05 수치 미갱신 — 실측 수치로 갱신하고 7~9차 loop 2-phase 종단 결과를 Phase 5 증거로 기재 |
+| N3 | `test_bug4_send_keys_safe_gating_order` 2500자 창 여유 23자; 오케스트레이터 브리프 완료 명령 템플릿 토큰 누락(attempt 1 폴백 동작) |
 | N4 | 이전 라운드 잔여(러너 첫 rc=5 잡 id, T1-1/T1-2 `events.log` 경로, T2-8 순서, `MAM_ENGINE_CAS=0` `close`, `MQTT_HOST` 문서) — 동작 영향 없음 |
 | N5 | 범위 밖 인계: 레지스트리 pytest 누출, 동시 스위트 실행이 남기는 샌드박스 고아 프로세스 |

 ---

-## 5. 최종 판정
+## 4. 최종 판정

-8차의 두 결정적 회귀(bash 3.2 세션 생성 롤백, R2 계약 파괴)는 실측으로 해소되었고, Codex P2의 라이프사이클 토큰 고정과 계약 문서까지 반영되었다. 코드 동작은 1~9차 하니스 전부에서 일치하며, 결정적 실패는 없다. 남은 것은 부하 하에서만 드러나는 테스트 하니스 타임아웃(N1)과 문서 수치(N2)로, 머지 커밋에서 정리하면 된다.
+이번 라운드의 변경은 테스트 하니스 타임아웃뿐이며 제품 코드·문서는 9차 PASS 시점과 동일하다. 지정 8개 모듈 211건과 전체 스위트 793건이 단독 실행에서 0 실패로 통과했고, 9차에서 부하 시 발생하던 `TimeoutExpired`는 재현되지 않았다. 1차부터 이어진 차단 항목은 남아 있지 않다. 잔여 항목(§3)은 문서 수치와 테스트 견고성 정리로, 머지 커밋에서 함께 처리하면 된다.
+
+> **레지스트리 상태 주석**: 본 잡(`dcb79ca5`)은 전체 스위트(27분) 실행 중 `--timeout 1800` 벽시계가 먼저 만료되어(05:01:12Z `deadline_timeout`) 래퍼가 `error`로 닫았고, 05:03:53Z의 `completed`는 CAS에 의해 거부되었다. 검토 판정은 위와 같이 PASS이며, 운영자는 이 파일을 확인한 뒤 `registry.py status --job dcb79ca5 --set completed`로 복구할 수 있다. 전체 스위트를 요구하는 리뷰 잡에는 `--timeout ≥ 2700`이 필요하다(2차 리뷰 R1 관찰과 동일).

 [VERDICT: PASS]
@@ -0,0 +1,25 @@
+### [planner-reviewer-codex-01] Gitea Issue #6 종결 승인 의견
+
+**기술적 종결을 승인합니다. 다만 실제 Close는 병합 커밋을 원격 main에 반영한 뒤 진행해야 합니다.** 확인 시점의 원격 main에는 수정 사항이 아직 반영되지 않았습니다.
+
+검토 작업: `a7ff14cb`.
+
+## 승인 근거
+
+- 로컬 현재 브랜치는 main, HEAD는 `a08b3ca387671925a8cc356ffa273fed55024314`입니다. 부모가 `f98b958`과 `ec61511`인 두 부모 병합 커밋으로, refactor 구현 커밋이 main에 포함됐습니다.
+- `a08b3ca`와 구현 커밋 `ec61511`의 Git tree가 모두 `081d7e574aa6b47134390daa4000236cb7c65d4b`로 동일합니다. 병합 과정에서 추가 코드 변경은 없습니다.
+- 본 검토자의 직전 job e2bebd26에서 지정 211개 테스트가 **211 passed in 236.56s**로 통과했습니다. fail-closed, TUI 핸드셰이크, CAS 시도 보호, 취소 토큰 전달 및 timeout 보강을 확인했습니다.
+- Codex·Claude·Grok의 최종 보고서와 OpenCode의 최신 통합 보고서 `report-5d0327b7.md`에서 PASS를 확인했습니다. OpenCode의 오래된 report-final.md만으로 최신 합의를 판단하지 않았습니다.
+- 전체 793개 통과는 제출자 보고 외에 Claude의 최신 보고서에도 **793 passed, 1619.2s**로 기록돼 있습니다. 이번 승인 검토에서 전체 스위트를 새로 실행한 것은 아닙니다.
+- [Issue #6 최종 종합 보고서 댓글](https://git.godopu.com/tmpl/multi-agent-mux/issues/6#issuecomment-56)이 실제 등록돼 있으며, API 조회 당시 이슈 상태는 open이었습니다.
+- 병합 diff의 공백 검사가 통과했습니다. 현재 미커밋 변경은 Claude 검토 보고서 한 파일이며 제품 코드 변경은 없습니다.
+
+## 실제 종결 전 남은 운영 단계
+
+`git ls-remote origin refs/heads/main`으로 재확인한 원격 main은 아직 `f98b9582c7090c061ecda46257a550235beba380`입니다. 로컬 병합 완료와 원격 반영 완료는 구분해야 합니다.
+
+운영자는 `a08b3ca`를 origin/main에 반영하고 원격에서 해당 커밋을 확인한 뒤 Issue #6을 Close하면 됩니다. 구현 재작업이나 추가 코드 리뷰를 요구하는 조건은 아닙니다. 문서 수치 정리, 공개 브로커 의존 및 명시적으로 범위 밖인 후속 과제는 기존 보고서에 따라 별도 추적할 수 있습니다.
+
+이번 요청은 승인 의견 작성이므로 원격 push, 이슈 상태 변경 또는 댓글 추가는 수행하지 않았습니다.
+
+[VERDICT: PASS]