0 Fork 0

Files

T

GodopuandClaude Opus 5.5 44999ff2fb release(v4.8.3): bump framework and eight skills to 4.8.3 in lockstep; archive PR #46 reviews (two rounds)

Issue #42 stages 1-2: the SKILL.md code-block inventory as test data and
the removal of blocks the entry scripts already do. Merge-workspace review:
round 1 (@8d26106) claude agy grok PASS, codex NOT PASS (R1-R3); fixed in
17eba09 (docs, inventory data and the guard test only); round 2 4/4 PASS.
Full suite at 8d26106 1408 passed / 0 failed. Reports and the round-2
identity sidecars go to .agents/reports/<session>/.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VCgu9Fa9iT7TbJUSzdq4Ff

2026-10-04 08:36:15 +09:00

6.3 KiB

Raw Blame History

리뷰 리포트 — Job 95b63371 (PR #46 2회차 델타, 8d26106..17eba09)

리뷰어: planner-reviewer-claude-01 (claude)
리뷰 identity: loop-20261003T230658Z-e7866a / base 8d26106 / head 17eba09 / tree a0f1ffe — 검증 경로에서 git rev-parse HEAD 'HEAD^{tree}' 일치, 미커밋 변경 없음
범위: 커밋 17eba09 한 개. git diff --stat 8d26106 17eba09 -- . ':!*.md' ':!tests' 결과가 비어 있음 → 제품 코드·버전 변경 없음(항목 4 ✓)

결론 요약

codex R1~R3, claude O1·O4 가 모두 닫혔다. 차단 결함 없음. 비차단 관찰 2건(§5).

1. 지적 사항 종결 여부

지적	수정	확인
codex R1 (attach 대상 서버)	resume SKILL.md Case 3·Workflow 설명·When NOT 이 `herdr --session <server> agent attach <name>` 로 서버를 명시, Verification 이 행에서 SERVER 를 읽어 `--session "$SERVER"` 사용	✓ 아래 §2
codex R2 (--dry-run 문구)	create·resume 옵션 표: "no spawn and no registry (YAML/DB) update; 앞선 검사는 돌고 macOS 에서 quarantine 속성을 지운다"	✓ create_session.sh:196 xattr → :280 dry-run 종료, spawn() 은 :264-274 정의만, YAML 쓰기 :305·:491 은 그 뒤. resume_session.sh:169 xattr → :225 dry-run 종료, spawn :237
codex R3 (삭제 본문 복귀 가드)	test_no_deleted_body_came_back 이 DATA["blocks"] 를 읽지 않고 현재 모든 블록을 removed+superseded 의 base_sha / base_fingerprint 와 비교	✓ §3 탐침
claude O1 (create:263-266 누락)	superseded 에 class c / invocation, base_sha ceb96a8c1293 으로 기록	✓ base `45d1621` 에서 parse_blocks 로 다시 계산한 sha·fingerprint 일치 (removed 5 + superseded 1 모두 True/True)
claude O4 (표 문구)	create 42 에 `MAM_KILL_ON_READY_TIMEOUT=1` 경우, stop 0 에 "--purge-conversation 에서는 no-op 아님"	✓ create_session.sh:388-398, stop_session.sh:185 와 일치

2. R1 — 안내 명령이 실제로 격리 서버로 가는가

herdr 서버를 건드리지 않도록 --help 의 Logs 경로(세션 해석 결과)만으로 확인했다(env -i 로 상속 변수 제거):

호출	해석된 세션 디렉터리
`herdr --help`	~/.config/herdr/ (기본 서버)
`herdr --session zz-probe --help`	~/.config/herdr/sessions/zz-probe/
`herdr --session default --help`	~/.config/herdr/ (기본 서버와 동일)
`HERDR_SESSION=zz-probe herdr --help`	sessions/zz-probe/
`HERDR_SESSION_NAME=zz-probe herdr --help`	~/.config/herdr/ (무시됨)
`herdr --session "" --help`	`error: session name cannot be empty`
(탐침 뒤 ~/.config/herdr/sessions 에 zz-probe·default 디렉터리 생성 없음 확인.)

따라서 herdr --session <row.herdr_session> agent attach 는 그 격리 서버로 간다. 행이 herdr_session: default 여도 --session default 가 기본 서버로 해석되므로 맞다. lib.sh shim(_real_herdr, lib.sh:255-268)이 default 일 때 --session 을 빼는 것과 결과가 같다.
resume_session.sh 가 export 하는 것은 HERDR_SESSION_NAME 이고 native herdr 는 이를 읽지 않으므로(위 표), 서버 명시가 필요하다는 수정 근거가 맞다.
Verification SERVER 계산: 행에 herdr_session 없음 → 'default' → 기본 서버(올바름). 행 자체가 없음 → python IndexError, SERVER="" → herdr 가 "session name cannot be empty" 로 즉시 실패. 검증 블록으로서는 조용히 엉뚱한 서버를 보는 것보다 낫다. 행 기록자는 create_session.sh:524-525, update_yaml_resumed.sh:140-141·155-156 에서 herdr_session 과 herdr_server 를 항상 같이 쓰므로 herdr_session 만 읽어도 된다.

3. R3 가드 — 견고성과 엄격성(스크래치 사본 변이 시험)

변이	새 테스트(`17eba09`)	이전 테스트(`8d26106`)
기준	31 passed / 1 skipped	—
codex 탐침: base resume Workflow 본문(`45d1621` :59-118)을 목록 항목 안에 2칸 들여 다시 넣고 인벤토리에 class c 로 등록	1 failed (test_no_deleted_body_came_back)	28 passed (못 잡음)
정상 편집: create 에 새로운(다른) 호출 예시 추가	R3 가드 통과, 인벤토리 테스트만 실패(의도된 동작)	—
삭제 본문 + 주석 한 줄을 앞에 붙여 다시 넣음	R3 가드 통과(인벤토리 테스트만 실패)	—

fingerprint(공백 접기 후 sha256 12자)는 재들여쓰기·줄 바꿈 변화에 강하고, 정확 일치만 보므로 다른 예시를 막지 않는다. 정상 편집을 막을 정도로 엄격하지 않다.
test_a_returned_body_is_caught_reindented_and_with_the_inventory_updated 는 가드 함수 자체를 현재 stop 블록으로 검사한다(정확 sha + 재들여쓰기 fingerprint) — 유효.

4. 인벤토리 재생성

8d26106 과 17eba09 의 skill_code_blocks.json 비교: blocks 33개의 (skill, class, kind) 순서가 동일. 바뀐 값은 resume Verification 블록(start 103)의 sha·end(124→128) 뿐이고, removed 5개는 base_fingerprint 추가만, entry_points 동일, superseded 신설. 분류 변경 없음(항목 3 ✓).

5. 비차단 관찰

N1 가드의 한계: R3 가드는 블록 본문 전체 일치만 본다. 삭제된 본문 앞에 한 줄만 붙여도(§3 셋째 행) 인벤토리를 갱신하면 통과한다. 이번 지적(R3)의 범위인 "인벤토리 재등록으로 숨기기"는 막았으므로 차단은 아니며, 필요하면 후속에서 줄 단위 포함 비율로 넓힐 수 있다.
N2 문구 정밀도: resume SKILL.md Workflow 설명의 "the native herdr binary does not route on environment variables" 는 정확히는 "HERDR_SESSION_NAME 으로는 라우팅하지 않는다"이다 — native herdr 는 HERDR_SESSION 을 읽는다(§2 표). 특히 herdr 패널 안에서는 HERDR_SESSION 이 호출자 서버로 설정되어 있어, 서버를 빼면 호출자 서버로 간다. 결론(--session 명시)은 그대로 옳다.
미반영으로 명시된 codex C2, claude O2·O3 는 후속 범위로 동의한다.

6. 테스트

검증 경로에서 지정 6개 파일: 132 passed / 0 failed / 1 skipped (300 s, rc 0). skip 은 test_claude_skills_link_resolves_to_agents_skills(워크트리, 정상). test_issue42_skill_blocks.py 단독 31 passed / 1 skipped. MQTT_* unset, .mam.env 미export. 실제 .mam/jobs 항목 수 변화 +0.

[VERDICT: PASS]

6.3 KiB Raw Blame History