The owner may end a TASK_DONE answer with "리뷰 불필요: <reason>". The host treats it as a request and honors it only when every guard holds: - workspace content equals the task base (hasCodeChangesSinceRef), the working tree is clean, and HEAD did not move during the owner run - the run used no file-mutating tool (Edit/Write/MultiEdit/NotebookEdit), no subagent (Agent/Task) and no state-changing or unknown MCP tool - every Bash command is classified read-only by a conservative quote-aware classifier (src/bash-command-classifier.ts); anything unknown counts as mutating - tool usage was reported and not truncated (agent-runner now reports tool names and Bash commands as toolUsage on its terminal output) - the user did not ask for a review in this task When honored the task completes as review_skipped with no reviewer or finalize turn; the answer is delivered with the marker line removed and a small "-# 검토 생략 …" note. Otherwise the marker is stripped and the normal review runs. A bare "검토해줘"-style message right after a review-skipped answer reopens that task for the reviewer. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
12 KiB
12 KiB
Changelog
이 문서는 EJClaw의 주요 변경 사항을 기록합니다.
[Unreleased]
Added
- owner가 "리뷰 불필요" 표시: 설명·조사만 하고 아무것도 바꾸지 않은 TASK_DONE 답변 끝에 owner가
리뷰 불필요: <이유>한 줄을 붙이면, 시스템이 다시 확인해 리뷰어·마무리 턴 없이 그 답변을 최종 답변으로 보내고 task를review_skipped로 닫음. 표시 줄은 사용자에게 보이지 않고, 답변 끝에-# 검토 생략(변경 없는 설명형 답변) · "검토해줘"라고 하면 검토합니다가 붙음. 다음 중 하나라도 해당하면 표시를 무시하고 평소처럼 리뷰: task 기준 이후 작업 폴더 내용 변경, 커밋되지 않은 변경, owner 실행 중 HEAD 이동, 파일 수정 도구(Edit/Write/MultiEdit/NotebookEdit)·서브에이전트(Agent/Task)·상태를 바꾸는 MCP 도구(schedule_task 등)·알 수 없는 도구 사용, 읽기 전용으로 확실히 분류되지 않는 셸 명령(src/bash-command-classifier.ts), 도구 사용 기록이 없거나 잘림(Codex owner 포함), 이번 task에서 사용자가 검토를 요청함. agent-runner는 실행 중 호출한 도구 이름과 Bash 명령을 최종 출력의toolUsage로 보고함. 검토가 생략된 직후 사용자가 "검토해줘" 같은 짧은 검토 요청만 보내면 그 task를 다시 열어 리뷰어가 그 답변을 검토함 - 자연어 작업 중단: 작업이 실행 중이거나 대기 중인 방에 "그만", "멈춰", "중단해", "취소", "stop" 같은 중단 의도만 담긴 짧은 메시지를 보내면 실행 중인 에이전트를 종료하고, 열린 paired task를
user_stopped로 닫고(남은 turn 취소·lease 해제), 중단 메시지까지 처리된 것으로 넘긴 뒤 "진행 중이던 작업을 중단했습니다."라고 답함. 다른 지시가 섞인 메시지는 중단으로 보지 않음
Changed
- paired 방의 owner·리뷰어 세션을 paired task 단위로 새로 시작. 같은 task 안의 후속 턴(리뷰 반영, 같은 task에 들어온 사용자 후속 메시지)은 그 세션을 이어 쓰고, 새 task의 첫 턴은 이전 세션을 resume하지 않음. 세션이 어느 task 것인지는
router_state의paired_session_task:<세션 폴더>에 기록. 이전 task의 마지막 최종 답변은 새 task의 turn 0(carry-forward)으로 계속 전달되며, 이를 위해PAIRED_CARRY_FORWARD_LATEST_OWNER_FINAL기본값을true로 변경. single 방은 그대로 - Claude가 사용 한도에 도달하면 Codex로 넘기는 대신 방에 "Claude 사용 한도에 도달했습니다. 21:40에 재개할 수 있습니다."처럼 재개 시각(KST)을 바로 알리고, 열린 paired task를
claude_usage_limit으로 닫음. 재개 시각은 오류 문구(resets 9:40pm (Asia/Seoul)등)에서 읽고, 없으면 사용량 API 캐시에서, 그것도 없으면 "잠시 후 다시 시도해 주세요"로 안내. 조용한 자동 재시도는 하지 않음 - 기본 Claude 모델을 Claude Opus 5.5(
claude-opus-5-5)로 상향. Opus 5.5는 Claude Code CLI 2.1.280 이상이 필요해@anthropic-ai/claude-agent-sdk를 0.3.153 → 0.3.286(번들 CLI 2.1.286)으로 올림 (8b68885) @openai/codex를 0.133.0 → 0.159.3으로 상향. 구버전이 매 실행마다 내던failed to decode models response: unknown variant max오류와 로그 폭주가 사라지고, 단순 리뷰 턴이 49초 → 5초로 단축됨 (a7f2e02)
Removed
- 웹 대시보드(
src/web-dashboard-*,apps/dashboard), Android 앱(apps/android), Glasses UI와 이를 위해서만 있던 설정 저장소(settings-store,settings-store-moa,room-skill-settings,runtime-inventory,codex-live-status,settings-effort),WEB_DASHBOARD_*설정,dashboard:*/android:*스크립트, react·vite·playwright 의존성. 잘못된 계정(~/.codex)을 갱신하던 Codex 계정 새로고침 루프도 함께 제거. 호스트 증거 도구의dashboard_dist/android_debug_apk항목 제거. Discord 상태 대시보드는 그대로 유지 - Mixture of Agents(MoA) arbiter 프롬프트 보강, Kimi 사용량 조회/대시보드 행,
MOA_*설정, 코드에서 읽지 않던FALLBACK_*provider 설정 예시 - 런타임에 연결되지 않았던 auto-paired-mode(
src/auto-paired-mode.ts)와 그것만 쓰던 Claude/Codex 사용량 소진 판정 함수 - 쓰이지 않던 export·고아 모듈(
src/dashboard.ts,src/dashboard-status-content.ts,src/restart-context-cli.ts)과DELTA_HANDOFF_*설정 - macOS launchd·nohup(WSL) 설치 경로와
launchd/, 쓰이지 않던repo-tokens/GitHub Action. 서비스 설치는 Linux systemd만 지원 - 루트에서 import하지 않던
yaml,zod,@modelcontextprotocol/sdk의존성 (agent-runner는 자체 의존성 유지) /compact·/clear·/stop세션 명령(main 방·관리자 전용이라 실제로 쓰이지 않음)과SESSION_COMMAND_ALLOWED_SENDERS설정, agent-runner의/compact처리..env에 남아 있는SESSION_COMMAND_*값은 더 이상 시작을 막지 않고 무시됨- main(관리) 방 개념과 그것이 열어 주던 방 간 기능. 모든 방의
is_main이 0이라 실제로 쓰이지 않았음. 이제 각 방의 에이전트는 자기 방만 다룸: 다른 방 예약 작업 생성/수정/일시정지/취소(target_group_jid), 다른 방으로 메시지 전송·inbound 주입, 전체 방 범위의 DB 증거 조회, IPCassign_room/refresh_groups와 에이전트용assign_room도구,available_groups.json스냅샷, main 방 전용 global memory 제외,EJCLAW_IS_MAIN환경 변수, main 방으로 보내던 추론 재시작 알림,setup --step register의--is-main,scripts/deregister-room.ts의 main 방 보호(--force),groups/main/템플릿 제거.room_settings.is_main컬럼은 스키마에 남아 있으나 더 이상 읽거나 쓰지 않음 - 기본 비활성이던 주기적 Codex warm-up 루프와
CODEX_WARMUP_ENABLED/CODEX_WARMUP_INTERVAL_MS. 고정 슬롯 usage primer는 그대로 동작 - 다중 계정 로테이션. Claude·Codex 모두 계정 1개 고정으로 동작: 한도·인증 오류 시 다음 계정으로 넘어가기, 계정별 쿨다운·상태 파일(
token-rotation-state.json,codex-rotation-state.json), Codex 1시간 전체 계정 사용량 스캔,CLAUDE_ACCOUNTS_DIR(~/.claude-accounts/<n>) 제거. Codex는~/.codex-accounts/0/auth.json(없으면~/.codex/auth.json)을 매 실행마다 확인하므로 재로그인 후 재시작이 필요 없음. 계정 잠금(동시 실행 1개, 최대 15분 대기)과 세션 토큰 write-back, Claude 토큰 자동 갱신(만료 시 1회 강제 갱신 후 재시도)은 유지.CLAUDE_CODE_OAUTH_TOKENS는 첫 번째 값만 사용 - Claude→Codex failover/handoff 체인: 한도·인증 오류 시
service_handoffs에 작업을 넘기던 생성 경로, 핸드오프 폴링·claim 워커, 전역 owner failover(codex-review가 owner 대행)와 그 프롬프트(prompts/codex-review-failover-platform.md), 대시보드 failover 표시,ROOM_ROLE헤더의failover=필드,OWNER_/REVIEWER_/ARBITER_FALLBACK_ENABLED설정. 이 배포에는 받을 Codex 서비스가 없어 넘긴 작업이pending으로 남기만 했음.service_handoffs테이블과 마이그레이션은 그대로 두며(다음 마이그레이션 정리 때 처리), 런타임은 더 이상 읽거나 쓰지 않음(방 등록 해제 스크립트의 행 정리만 남김)..env에 남은*_FALLBACK_ENABLED는 무시됨
Fixed
scripts/deregister-room.ts의 타입 오류(bun run typecheck:all에서만 보이던unknown[]바인딩) 수정- 메시지 처리 커서가 뒤로 감기지 않도록 함. 더 새로운 메시지를 이미 처리한 뒤 끝난 이전 실행이 커서를 되돌려 같은 메시지가 다시 실행되던 경로를 막음
- Codex 계정이 1개일 때 두 방이 동시에 Codex를 쓰면 두 번째 실행이 "Codex rotation pool unavailable"로 즉시 실패하고 리뷰가 조용히 생략되던 문제 수정. 잠금이 다른 실행에 잡혀 있으면 최대 15분 기다림 (
30ba510) - 이미 턴 소유권을 잃은 실행의 5초 진행 표시 타이머가 멈추지 않아, 실제로 작업 중인 방의 진행 메시지가 멈춘 것처럼 보이던 문제 수정 (
69ae334) work_dir가 비어 있는 tribunal 방에서 실행 컨텍스트가 만들어지지 않아 작업 리비전이 얼고 10분 안의 후속 메시지가 버려지던 문제 수정. 자동 복구 경로가 동작하도록 함 (c7a8a43)
Docs
- README /
docs/configuration.md/docs/architecture.md/ setup·debug 스킬을 현재 동작에 맞게 정리: 현재 SDK·모델 버전, room별 reviewer/arbiter override, 제거된registered_groups, 더 이상 지원되지 않는DISCORD_BOT_TOKEN, Codex OAuth 로그인, journald 로그 위치,bun run test
[0.2.3] - 2026-04-22
Added
- room-level reviewer / arbiter agent 선택 지원
Changed
- 최신 owner final carry-forward를 기본적으로 비활성화
- superseded task에서 직전 owner / reviewer final을 얇은 breadcrumb로 이어줘 reviewer가 task 경계 맥락을 덜 놓치도록 조정
unsafe host mode와 Claude reviewer fresh-session 강제를 분리해, reviewer가 기본적으로 세션을 이어가도록 변경
Fixed
- Claude Code bundled binary 경로 문제를 수정해 runner 실행 안정성 개선
- paired owner compaction / failure recovery 흐름 보강
[0.2.2] - 2026-04-15
Fixed
- CI watcher 완료 뒤 reviewer가 끝난 상태에서 owner 후속 흐름이 이어지지 않던 문제 수정
merge_ready상태에서 새 human message가 오면 이전 task를 supersede 처리해, 직전 owner final이나 turn output이 다음 질문으로 누출되며 한 턴 늦게 보이던 문제 수정
[0.2.1] - 2026-04-13
Changed
- Claude / Codex SDK를 최신 patch/minor 수준으로 갱신하고 runner 의존성을 정리
- reviewer 검증 기준과 continuation/checklist mode 계획 문서를 현재 구조에 맞게 정리
Fixed
- stale reviewer workspace 레코드가 남아 있을 때 reviewer가 현재 owner worktree 대신 옛 경로를 보는 문제 수정
- reviewer 프롬프트를
EJCLAW_WORK_DIR기준 검증으로 고정해 canonical clone을 단독 근거로 오판하는 문제 완화 - stale owner run이 buffered progress flush, tracked progress send/edit를 외부로 새는 문제 수정
- Claude SDK
task_*이벤트가 nested/internal task까지 별도 subagent처럼 표시되던 progress 렌더링 문제 수정
[0.2.0] - 2026-04-11
Added
- owner / reviewer / arbiter 기반 Tribunal 3-에이전트 흐름 정비
- MoA(Mixture of Agents) 기반 외부 모델 의견 수집
assign_room기반 room assignment 모델과room_settingsSSOT 정착- 역할별 model / effort / fallback 설정
- reviewer host runtime read-only guard 및 host verification 경로
- Claude OAuth 멀티 토큰 로테이션
Changed
- reviewer는 owner workspace를 direct mount로 읽는 현재 모델로 정리
- final delivery 경로를 단일화해 duplicate final 배달 문제를 줄임
- startup precondition을 전용 오류 / exit code 체계로 정리해 crash loop를 막음
- deploy 과정에
migrate-room-registrations를 포함해 startup strictness와 운영 절차를 맞춤 - Bun 기준 단일 quality gate(
bun run check)로 format / typecheck / test / build를 통합
Fixed
- stale paired finalize retry가 이전 attempt의 side effect를 밖으로 새는 문제 수정
- reviewer / arbiter intermediate progress가 final 직전에 외부 채팅으로 flush되는 문제 수정
- owner final이 progress edit + 새 work item 메시지로 이중 배달되는 문제 수정
- owner workspace branch mismatch 시 안전한 auto-repair 또는 visible blocked 처리 추가
- stale reviewer workspace 레코드가 옛 경로를 유지해 reviewer가 다른 worktree를 보는 문제 수정
- legacy room migration 미실행 상태에서 서비스가 restart loop에 빠지는 문제 완화
[0.1.0] - 2026-04-09
Added
- Discord 기반 EJClaw 초기 공개 버전
- owner / reviewer / arbiter 역할 고정 봇 구조
- auto user notify, loop protection, Discord-independent paired communication 기반 정착