Repository navigation
fix(cmux-delegate): make decision_gate write atomic - #1073
Conversation
_write()는 open(path, "w")로 써서 truncate 후 기록이라 원자적이지 않았다. 동시에 읽는 쪽이 잘린 바이트를 보면 json.load가 ValueError를 던지고 _read가 None을 반환, resolve()는 이를 "결정 파일 없음"으로 오독해 verdict 키 없는 dict를 반환했다(#1031). 같은 디렉터리에 임시 파일로 쓰고 os.replace로 교체하도록 변경 — session-intent의 write_state와 동일한 컨벤션(#647 H7). 누락된 디렉터리에서는 기존과 동일하게 실패한다(makedirs 추가 안 함). resolve()의 state=none/state=pending 계약 질문은 이슈가 명시한 대로 범위 밖으로 남긴다. Confidence: high Not-tested: 실제 다중 프로세스(threading 아닌 multiprocessing) 하의 os.replace 원자성 — 같은 파일시스템 내 rename atomicity는 POSIX 보장이므로 재현 불필요 판단
앞 커밋의 원자적 쓰기를 고정하는 테스트가 없었다. 기존 26개 중 어느 것도 잘린 파일을 관측하지 않아, `_write` 를 `open(path, "w")` 로 되돌려도 스위트는 그대로 초록이다 (수정 전 코드에 이 테스트만 돌려 확인: `JSONDecodeError: Unterminated string`). 동시성 대신 쓰기 실패를 쓴다 — truncate 후 실패와 truncate 후 경쟁은 같은 반쪽 파일을 남기고, 스케줄링이 가능한 쪽은 전자뿐이다. 임시 파일 잔류도 함께 확인한다. Confidence: high Not-tested: 없음 — 수정 전 실패 / 수정 후 통과 양방향 확인 Session-Id: 986b3ff6-861d-4339-9c8a-4442f03ed2df
|
Warning Review limit reached
Next review available in: 29 minutes Limit details: You’ve used the included review currently available. You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository. How can I continue?Wait for the limit to reset, then comment An organization admin can change what happens after included review limits in Billing. How do review limits work?CodeRabbit enforces per-developer PR review limits within each organization. For paid Pro and Pro+ reviews, CodeRabbit uses a developer's included PR review attempts over the past 7 days to set the current hourly allowance. At typical activity levels, the full plan allowance applies. Higher sustained activity can lower the allowance until earlier attempts leave the 7-day window. Please refer docs for additional details. Review details⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (2)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
무엇이 바뀌나
기록된 판정이 조용히 "묻지 않은 질문" 으로 둔갑하던 경로를 막습니다.
원인
decision_gate._write()가open(path, "w")로 썼습니다 — truncate 후 기록이라 원자적이지 않습니다. 동시에 읽는 쪽이 잘린 바이트를 보면json.load가ValueError를 던지고,_read는 이걸None으로 돌려줍니다._read는 "파일이 없다" 와 "파일이 반쯤 쓰였다" 를 구분할 수단이 없으므로,resolve()는 이를 결정 파일 부재로 읽고{"state": "none"}을 반환합니다.승인/거부가 이미 기록돼 있는데도 아무도 묻지 않은 것처럼 보이는 상태입니다.
어떻게 고쳤나
같은 디렉터리에 임시 파일로 쓰고
os.replace로 교체합니다. 임시 파일을path자신의 디렉터리에 만드는 것은 선택이 아닙니다 —os.replace는 양쪽이 같은 파일시스템일 것을 요구하고, 디렉터리가 없을 때는 기존open(path, "w")와 똑같이 여기서 실패해야지 다른 곳에 조용히 쓰면 안 되기 때문입니다.이 리포의 기존 컨벤션을 그대로 미러링했습니다 —
hooks/preflight-gate/session-intent/impl.py:285의write_state()가 같은 truncate-vs-crash 해저드(#647 H7)에 대해 이미tempfile.mkstemp(dir=parent, ...)+os.fdopen+os.replace+ 실패 시 unlink 를 씁니다.hooks/_lib/_state_lock.py는 쓰지 않았습니다. 그건 read-modify-write 직렬화용이라 단일 write 의 원자성과는 다른 문제입니다. 애초에decision_gate.py는skills/아래라hooks/_lib를 import 할 수 없다는 제약이 모듈 docstring 에 적혀 있습니다.session-intent와 달리os.makedirs는 넣지 않았습니다 — 기존 테스트test_unwritable_file_is_unavailable이 "없는 디렉터리 → 쓰기 실패" 를 요구합니다.커밋 2개 — 수정과, 그 수정을 고정하는 테스트
닫히는 조건이 달라 나눴습니다. 두 번째가 필요했던 이유는 기존 탐지가 비결정적이기 때문입니다.
기존
test_concurrent_resolvers_produce_one_verdict_and_one_signal은 이 결함을 잡긴 잡습니다 — 다만 레이스 창이 열릴 때만 잡습니다. 로컬에서 5회 재실행하면 5회 다 통과하므로, 회귀를 넣고도 초록으로 통과할 수 있습니다.그 비결정성이 오늘 실제로 드러났습니다. 이 결함과 무관한 PR #1069 (
git_commit_titles.py만 변경) 의 CI 가 바로 이것으로 죽었습니다.resolve()가verdict키 없는 dict 를 반환한 것 — 이 PR 이 고치는 바로 그 경로입니다 (run 32547485070). 이론적 레이스가 아니라 오늘 CI 를 무너뜨렸고, 무관한 PR 의 작성자가 자기 변경의 회귀 여부를 가릴 수 없게 만듭니다.그래서 결정적 탐지기를 추가했습니다.
수정 전 코드에 새 테스트만 돌려 확인했습니다.
이슈가 말한 바로 그 증상입니다. 동시성 대신 쓰기 실패를 쓰는 이유는, truncate 후 실패와 truncate 후 경쟁이 같은 반쪽 파일을 남기는데 마음대로 스케줄할 수 있는 쪽은 전자뿐이기 때문입니다. 임시 파일 잔류 여부도 함께 단언합니다.
검증
양방향이 잠겼습니다 — 수정 전 실패, 수정 후 통과.
범위 밖으로 남긴 것
resolve()는state=none과state=pending양쪽에서verdict키 없는 dict 를 반환하고,pending은 정당한 상태입니다. 즉 "모든 반환에 verdict 가 있다" 고 가정하는 쪽이 코드가 아니라 테스트일 수 있습니다. 원자적 쓰기는 관측된 실패 경로를 없애지만 그 계약 질문에는 답하지 않으며, 이슈가 명시적으로 여기서 다루지 말라고 그은 경계입니다.Pre-commit verified:
python3 -m pytest tests/test_decision_gate.py -q→ 26 passed,bash tests/test_decision_gate_protocol.sh→ Passed 13 / Failed 0,python3 -m ruff check→All checks passed!,python3 scripts/check-plugin-manifests.py→plugin-manifest check OKCaller chain verified:
_write는decision_gate.py모듈 내부 심볼이고 호출부는 같은 파일의 2곳(:198,:258)뿐입니다. 시그니처(path: str, record: _Record) -> bool와 실패 시False반환 계약은 무변경이라 두 호출부 모두 무접촉입니다.tests/test_check_memory_frontmatter.py의 동명_write는 무관한 로컬 헬퍼입니다. 훅 매니페스트와는 무관한skills/파일입니다.Closes #1031