Files
EJClaw/CHANGELOG.md
Codex 7f54c47e64 feat: let the owner skip review for change-free explanation answers
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>
2026-10-01 20:36:53 +09:00

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 증거 조회, IPC assign_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_settings SSOT 정착
  • 역할별 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 기반 정착