결과캐시 메모이제이션 엔진

개요

집사 세션이 동일 요청을 반복 위임하지 않도록, 작업결과를 PSV 파일에 캐싱하는 한선씨 엔진. 목표: 2× 효율(캐시 히트 = 토큰 0으로 재사용).

무엇을 했는지

• ~/.claude/butler/결과캐시.한선 작성 및 컴파일
• 4개 자가 테스트 전체 통과 (영문 저장/조회, 한글+개행, 미스, 최신우선)
• ~/.claude/butler/캐시-사용법.md 사용 가이드 작성
• 크라우니코드 학습: 결과캐시메모이제이션
• knowledge 등록: 집사효율/결과캐시-규약 (#8649)

관련 파일

• /Users/ef/.claude/butler/결과캐시.한선 — 소스
• /Users/ef/.claude/butler/결과캐시.toau — 컴파일 바이너리
• /Users/ef/.claude/butler/결과캐시.dat — PSV 저장소
• /Users/ef/.claude/butler/캐시-사용법.md — 사용 가이드

발견한 새 한선씨 함정

부분(내용, 오프셋, 길이)는 한글이 포함된 문자열의 중간 오프셋 추출 실패

• 부분("ABC점검XYZ", 5, 3) → 빈 문자열 반환
• 해결: 글자(s, i) 순회로 문자 하나씩 조립
• 영향 범위: 행 파싱, PSV 필드 추출 전반

잔여 이슈

• 조회는 현재 파일(결과캐시.dat)만 — p1.dat 콜드(회전 후 접근 안 됨)
• 세션간 공유는 파일 기반 — 동시 덧쓰기 시 행 순서 뒤섞임 가능(append는 원자적이므로 실용상 무해)