[ictechgy]

왜

UsageReducer 는 한 어시스턴트 응답의 트랜스크립트 행들을 message id 로 묶고 그중 마지막 행을 고른다. 최종 usage 수치가 거기 있기 때문이다. 그런데 행 단위로 스냅샷을 찍으면서 "이 턴 직전에 컨텍스트로 무엇이 들어왔는가" 를 묻는 소비자는 그 선택을 쓸 수 없다. 마지막 행에 도달했을 때 그 답은 이미 여러 행 앞에서 관측되고 지워진 뒤다.

group_first_row_ordinal 이 그 앞 지점이다.

설계에서 확인한 것

• 필드는 마지막에 둔다. frozen dataclass 에서 기본값 있는 필드를 tokens 앞에 두면 import 시점에 TypeError 가 난다.
• min(candidate.row_ordinal for candidate in candidates) 로 채운다. :293 의 first_for_group 은 no_id_fallback 카운터용 bool 이라 쓸 수 없고, observe() 가 호출자가 준 순번을 그대로 받으므로 append 순서도 믿을 수 없다.
• REDUCER_SCHEMA 는 건드리지 않는다. statusline.sh:514 는 스키마가 어긋나면 오류 없이 조용히 캐시 지표를 끈다.

소비자는 아직 없다

이 필드를 읽는 코드는 이번 PR 에 없다. claude_transcript_cost_audit.py 가 Gate-B 동결 경로라 별도 세대로 가야 하므로, 리듀서 쪽만 먼저 올려 두 변경이 한 PR 에 섞이지 않게 한다. 지금 상태에서 audit 출력은 바뀌지 않는다 (리듀서 + audit 스위트 59건이 그대로 통과).

함께 고친 것

픽스처 message id 충돌. tests/test_tool_result_token_estimate.py 의 _corpus 가 id 를 msg_{index} 로 찍는데, test_small_results_and_cache_rewrites_are_not_samples 가 같은 범위를 두 번 이어 붙여 usage 행 80개가 id 40개로 접히고 있었다. 그 단언은 오랫동안 이 충돌 덕분에 통과해 왔다. id_offset 을 넣어 분리했고, 단언값 40 은 수정 전후 모두 유지된다.

선언 누락. 리듀서와 그 미러가 production surface 인벤토리에는 있는데 PROVIDER_FREE_SUPPORT_PATHS 에는 빠져 있었다.

변이 테스트

변이	결과
앵커를 선택된 행으로	잡힘
min → max	잡힘
REDUCER_SCHEMA 상향	잡힘
패키지 미러 미갱신	잡힘

검증

tests.test_context_guard_audit_turn_anchor + cli + stage2   Ran 21 OK, exit 0
tests.test_context_guard_usage_reducer_v2 + token_estimate  Ran 59 OK, exit 0
scripts/ci_test_gate.py fast                                Ran 76 OK, exit 0
실제 3.11 compileall                                        exit 0
scripts/sync_plugin_copies.py --check                       plugin copies synchronized
scripts/prepublish_check.py --skip-tests                    prepublish check: OK
scripts/release_preflight.py                                경고 없음

함정 하나

변이 테스트 중 __pycache__ 가 남아 파일을 복원한 뒤에도 낡은 바이트코드가 로드되는 현상을 겪었다. 리듀서를 반복 수정하며 테스트할 때는 캐시를 지우고 재실행할 것. 커밋 메시지에도 적어 두었다.

동결 경로를 건드리지 않으므로 squash 로 병합해도 된다.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DE3AupXcyv64SEuQeTckSh

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 1fa1de11-b2f9-475c-a046-bc5f6cc043d3

---

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.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}