multi-agent-mux/.agents/reports/planner-reviewer-codex-01/report-b8dbd280.md

# PR #48 — 3회차 Codex 델타 리뷰

## 판정: PASS

이전 R1–R3이 해결됐다. 고정 MINIMAL 설정을 검사 실행 불가 시 경고와 함께 사용하는 R1의 대안도 이번 지원 범위에서 수용한다. 차단 결함은 발견하지 않았다. 문서 표현 정리 1건은 비차단 의견이다.

## 검증 identity / 범위

- job: `b8dbd280`
- loop: `loop-20261005T085016Z-c0f6eb`
- base: `e8d9151226d8139c7b5688e83d035a3a747aeb2d`
- head: `ab93776d6d1b8ca534c14b6be53f61dc3a0fa2a9`
- tree: `f49ffdc8e95dc316f752fd81b2d55a0efddf1a12`
- 검증 경로: `/var/folders/q_/68sxgw3j073dgjg8wl9s08vw0000gn/T/mam-review/loop-20261005T085016Z-c0f6eb/1`
- `git diff e8d9151..HEAD`의 제품 모듈 2개와 테스트 파일 2개만 델타 리뷰했다. 검증 전후 HEAD/tree 일치, 작업 트리 clean.
- 소스 수정·커밋·브랜치 변경 없음. 실행 중 사용자 herdr 서버·설정·소켓, .mam.env를 사용하거나 변경하지 않았다.

## 이전 지적 종료 표

| 지적 | 현재 근거 | 검증 및 판단 |
| --- | --- | --- |
| R1: 검사 timeout/OSError에도 스키마 오류 병합 파일 반환 | `.agents/skills/lib_py/herdr_config.py:247–258` | 검사 불가한 병합 파일은 폐기하고 MINIMAL로 전환한다. timeout/OSError 회귀 검사와 이전 독립 탐침 통과. **해결**, 아래 대안 판단 참조. |
| R2: 0/False/빈 문자열/음수의 동등 비교로 pane 닫기 | `.agents/skills/lib_py/herdr_restore.py:44–53` | 양쪽 값이 bool이 아닌 양의 정수일 때만 비교한다. 비정상·누락 응답에서 닫기 없음, 정상 셸은 닫고 busy pane은 유지한다. 이전 비정상 PID 탐침 4건도 통과. **해결**. |
| R3: NaN 때문에 무관한 정상 설정까지 유실 | `.agents/skills/lib_py/herdr_config.py:140–149,171` | 재귀 비교에서 NaN끼리 동등하게 처리한다. 중첩/배열 NaN 및 기존 UI 설정 유지 검사, 이전 독립 탐침 통과. **해결**. |

## R1: MINIMAL을 검사 실행 불가 시 사용하는 선택

이전 보고서에서는 MINIMAL 검사도 실패하면 경로를 반환하지 않는 방안을 제안했다. 이번 구현은 그 제안을 그대로 따르지는 않지만, 원래 결함의 핵심인 **검사되지 않은 사용자 병합 내용의 사용**을 막으며 #45의 복원 비활성화 목적을 더 잘 보존하므로 수용한다.

- MINIMAL은 사용자 스키마 값과 분리된 고정 `[session]\nresume_agents_on_restore = false\n` 본문이다.
- 실제 herdr 설정 검사와 실서버 복원 검사가 이 설정을 받아들이고 복원을 끄는 것을 검증했다.
- 첫 검사 timeout 뒤 두 번째 MINIMAL 검사가 성공하는 경로를 별도 주입 검사했다. 호출 2회, 반환 파일은 MINIMAL이었다.
- 두 번 모두 검사 실행이 불가능한 경우에도 병합 내용은 남지 않고, `using the fixed minimal config unchecked` 경고로 미검증 상태를 밝힌다.
- 검사기를 실행했고 파일을 명시적으로 거부한 경우는 예외와 다르다. 병합/MINIMAL 양쪽에 명시적 거부 응답을 주입하면 여전히 경로를 반환하지 않는다(`:259–263`). 이 흐름도 별도로 확인했다.
- 아무 파일도 넘기지 않는 기존 bootstrap 경로는 복원이 켜진 기본값으로 시작할 수 있으므로, 알려진 고정 설정을 넘기는 선택에는 구체적인 근거가 있다.

이 판단은 PR이 대상으로 삼은 herdr의 알려진 설정 스키마에 대한 것이다. “실행하지 못한 검사가 통과했다”는 의미는 아니다.

알 수 없는 nonzero 종료의 판정은 이번 커밋에서 바뀌지 않았다. herdr가 무해한 unknown-section 경고에도 nonzero를 반환하므로, 모든 nonzero를 파일 전체 거부로 취급하는 변경을 R1 종료의 조건으로 요구하지 않는다.

## _same_doc 의미 확인

**이전 일반 `==`와 완전히 동일하지 않다.** `:149`가 동일한 타입을 요구하므로 NaN 처리 외에 int/float/bool 교차 동등성도 더 엄격해졌다. 이는 TOML 재직렬화의 타입 보존 검증에 적절하며, 현재 writer가 유지하는 유효 값의 정상 왕복을 깨뜨리는 사례는 찾지 못했다.

| 비교 | 이전 == | 현재 _same_doc | 판단 |
| --- | --- | --- | --- |
| `1` / `1.0` | true | false | int/float 타입 변경을 감지 |
| `True` / `1`, `False` / `0.0` | true | false | bool/숫자 혼동 방지 |
| 같은 타입의 int/bool/string | 기존 값 비교 | 동일 | 유지 |
| `nan` / `nan` | false | true | 의도한 수정 |
| `nan` / 일반 숫자 | false | false | 유지 |
| `0.0` / `-0.0`, 같은 infinity | true | true | 유지 |
| 같은 datetime, 같은 순간의 다른 UTC offset | true | true | 유지 |
| date / datetime | false | false | 유지 |
| 배열 순서·길이 차이 | false | false | 유지 |
| dict 키 차이 | false | false | 유지 |
| dict/list 안의 새로 생성한 NaN들 | false | true | 재귀 수정 |

datetime/time offset, 중첩 NaN, 배열 길이·순서 등을 포함한 독립 비교 18건을 실행해 기대 결과를 확인했다. 이 비교는 파서가 반환하는 TOML 자료형을 대상으로 하며 임의 사용자 정의 Python 객체를 위한 범용 동등 비교를 요구하지 않는다.

## 실행 결과

모든 실행 cwd는 위 검증 경로였다. Python bytecode 및 pytest cache를 끄고 basetemp는 검증 경로 밖에 두었다.

| 검사 | 결과 |
| --- | --- |
| 지정 Python 3.9: herdr_config, restore_unit, 실제 restore, issue9_server_env | **53 passed, 34 skipped**, 72.81초 |
| 브리프의 Python 3.11: herdr_config, restore_unit | **67 passed**, 0.40초 |
| 이전 리뷰의 독립 결함 탐침 파일 그대로 현재 head에서 실행 | **6 passed**, 0.02초 (이전 head에서는 6 failed) |
| _same_doc 독립 비교 | **18건 통과** |
| 검사 timeout→MINIMAL 성공 / 양쪽 명시적 거부 | **2개 흐름 통과** |
| git diff --check 및 변경 Python 모듈 AST parse | 통과 |

3.9의 34 skip은 tomllib이 필요한 검사다. 이를 보완해 3.11에서 해당 두 파일 전체 67건을 실행했다. 실제 herdr 복원 및 양성 대조 테스트도 3.9 실행에 포함되어 통과했다.

- 3.9 로그: `/tmp/b8dbd280-selected39.log`
- 3.11 로그: `/tmp/b8dbd280-selected311.log`
- 이전 탐침 파일: `/tmp/714c5189_extra_probes.py`
- 이전 탐침 재실행: `PYTHONDONTWRITEBYTECODE=1 /tmp/270e8aaa-py311/bin/python -m pytest -p no:cacheprovider -q --basetemp=/tmp/b8dbd280-prior-probes /tmp/714c5189_extra_probes.py`

실행 wrapper에서 상속된 HERDR_*를 제거하고 버리는 HOME/XDG_CONFIG_HOME을 사용했다. 실제 테스트 세션은 uuid4 기반 `mamt45-84511-*`였으며, 종료 후 해당 서버 프로세스 및 해당 세션을 담은 임시 루트가 남아 있지 않음을 확인했다.

## 비차단 의견 C1 — 문서의 검사 필수 표현을 예외와 맞추기

`.agents/skills/lib_py/herdr_config.py:23–26,239–240`과 `VERSIONS.md:49`에는 결과가 반드시 herdr 검사에서 승인된다는 표현이 남아 있다. 이번 `:247–258`의 고정 MINIMAL 예외는 코드 주석과 런타임 경고로 설명되지만 이 문서 표현에는 반영되지 않았다.

“사용자 설정을 병합한 파일은 검사 불가 시 사용하지 않으며, 검사기를 실행할 수 없는 경우 고정 최소 설정을 경고와 함께 사용한다”는 예외를 문서와 docstring에 추가하면 정확해진다. 제품의 실패 처리와 경고는 충분히 명시적이므로 이 문서 보완을 이번 PASS의 차단 조건으로 삼지 않는다.

## 범위

변경은 기존 세 지적의 설정 검사 실패 처리, PID 검증, NaN 재파싱 비교와 회귀 테스트에 한정된다. bash 정책 추가, 버전 변경, 인벤토리 분류 변경, 승인되지 않은 already-running 검사나 무명 에이전트 종료 기능은 없다. 재계획은 필요하지 않다.

[VERDICT: PASS]