Before, a Claude run that hit the account usage limit closed the open paired task as claude_usage_limit, posted the reset time and consumed the user's messages, so the work was lost and had to be re-requested. Now the room is paused instead: - The failed turn is released without touching the paired task (no failure count, no status change, no follow-up) and the queue keeps the human messages unconsumed, so the same turn can run again. - The room is recorded in router_state `claude_usage_pause` with the reset time (error text, else cached usage API reset, else a 10 min retry). A banner time that just passed is read as "now", not tomorrow. - While the limit lasts, paused rooms run nothing and any other room's Claude turn pauses that room without spawning a run (the limit is account-wide). A stop request still goes through and drops the room from the resume list. - The scheduler tick clears the pause 1 min after the reset, posts a resume notice and re-queues the rooms; the pending turn or the kept messages then run again. The state survives restarts. Safety refusals keep closing the task as before. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
14 KiB
14 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
- 마무리(finalize) 턴 비용 절감. (가) 리뷰어가 owner의 첫 TASK_DONE 답변을 첫 리뷰에서 바로 승인했고(리뷰 1회, owner 수정·중재 턴 없음) 승인 이후 작업 폴더가 그대로면 owner를 다시 실행하지 않고 그 답변(상태 줄 제외)을 최종 메시지로 올리고 task를 완료함. 검토 생략 답변에 "검토해줘"로 받은 리뷰가 바로 승인되면 답변을 반복하지 않고
-# 검토 완료: …한 줄만 올림. (나) 그 밖의 마무리 턴은 task의 긴 작업 세션을 resume하지 않는 새 세션에서, 이번 task의 사용자 요청과 최근 turn 출력(최대 6개)과 마무리 형식 안내만 담은 프롬프트로 실행하고 세션을 저장하지 않음(방 메모리 브리핑도 생략). owner 규칙에 첫 TASK_DONE 답변도 최종 답변 형식을 따라야 한다고 명시 - 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로 넘기지 않고 그 방의 작업을 일시정지했다가, 사용량이 초기화되면 자동으로 이어서 진행함. 한도에 걸린 turn은 실패로 세지 않고 paired task 상태를 그대로 두며, 처리하던 사용자 메시지도 처리 완료로 넘기지 않음. 방에는 "Claude 사용 한도에 도달해서 이 방의 작업을 일시정지했습니다. 21:40에 사용량이 초기화되면 자동으로 이어서 진행합니다."처럼 재개 시각(KST)을 알림. 한도는 계정 전체에 걸리므로 일시정지 중에는 다른 방의 Claude turn도 실행하지 않고 같은 방식으로 일시정지함(일시정지되지 않은 방의 Codex turn은 그대로 실행). 일시정지 상태는
router_state의claude_usage_pause에 저장되어 재시작 후에도 유지되고, 스케줄러 tick이 초기화 시각 1분 뒤에 "Claude 사용량이 초기화되어서 일시정지했던 작업을 이어서 진행합니다."를 보내고 방들을 다시 큐에 넣음. 재개 시각은 오류 문구(resets 9:40pm (Asia/Seoul)등)에서 읽고, 없으면 사용량 API 캐시에서, 그것도 없으면 10분 뒤에 다시 시도함. 일시정지 중 "중단"을 보내면 그 방의 작업을 버리고 재개 대상에서 뺌 - 기본 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 기반 정착