Skip to content

feat(memory): 기억을 기록으로 — 종류 · 버전 · 출처, 턴마다 예산 안에서 선택 (4.108.0) - #183

Merged
CocoRoF merged 1 commit into
mainfrom
feat/memory-records
Nov 13, 2026
Merged

CocoRoF merged 1 commit into
mainfrom
feat/memory-records

Conversation

@CocoRoF

@CocoRoF CocoRoF commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

왜

사실 원장(__facts__.md) · 에버그린(__evergreen__.md)은 통째로 다시 쓰고 통째로 매 턴 싣는 문서였다. 기억이 커지면 프롬프트가 커지고, 고정 층 예산에서 잘렸다(128k 창 3.8k자). 원장은 200개에서 멈춰 고침까지 버렸고, 에버그린은 상한이 없었고, 추출 커서는 다른 대화의 턴을 건너뛰었다.

무엇

기억의 단위를 기록(rule · fact · state · decision · procedure)으로 바꾼다. 저장은 상한이 없고 프롬프트에는 턴마다 고른 것만 들어간다. 자세한 내용은 CHANGELOG 4.108.0.

  • 쓰기: 대화별 커서 → 범위가 묶인 추출(추출 프롬프트가 기억 크기와 함께 자라지 않는다) → 이웃만 놓고 판정 → 권위 · 상태 불변식은 코드
  • 버전 · 이력 · 되돌리기, 낙관적 동시성. 이력은 검색 · 의미 색인 밖
  • 읽기: 규칙 · 상태 · 관련 · 색인을 예산 안에서(한 줄 먼저, 남는 몫으로 통째로, 자르지 않음). 규칙 · 상태 · 색인은 캐시되는 고정 층
  • 정리 · 이관(여러 pass, 재실행 안전, 잃지 않음) · 도구(memory_pin → 기록, memory_record 신설) · 주인 변경 API
  • XGEN_MEMORY_RECORDS=off 로 예전 동작

실측 (scripts/bench_memory_records.py)

기록 수 턴당 조립 예산 준수 추출 목록 pass 오버헤드(모델 제외)
300 8ms ✓ 9.7k자 0.14s
1,000 24ms ✓ 10.0k자 0.5s
3,000 66ms ✓ 11.0k자 1.9s
10,000 290ms ✓ 10.6k자 1.6s

옛 기억 42개(8.7만 자): 예전 고정 층은 4.9% · 7.4% · 35%(128k · 200k · 1M)를 싣고 나머지를 말없이 잘랐다. 기록 블록은 규칙을 10 · 17 · 74개(/74) 싣고 나머지는 색인에 남긴다.

검증

  • pytest tests/ 6,368 통과(실패 1건 test_old_stage_module_is_gone 은 로컬 잔여 __pycache__ 폴더 탓, 변경 전에도 실패)
  • 새 테스트 tests/unit/test_memory_records.py 32개
  • ruff check · ruff format --check · mypy(core, llm_client, memory/records) · gen_event_docs --check

🤖 Generated with Claude Code

사실 원장 · 에버그린은 통째로 다시 쓰고 통째로 싣는 문서라 기억이 커지면 프롬프트가 커지고 잘렸다.
기억의 단위를 기록(rule/fact/state/decision/procedure)으로 바꾼다.

- 쓰기: 대화별 커서 → 범위가 묶인 추출 → 이웃만 놓고 판정 → 권위 · 상태 불변식은 코드가 지킨다
- 버전 · 이력 · 되돌리기, 낙관적 동시성, 이력은 검색 · 의미 색인 밖
- 읽기: 규칙 · 상태 · 관련 · 색인을 예산 안에서 고른다(한 줄 먼저, 남는 몫으로 통째로, 자르지 않음)
- 정리: 묶음 합치기 · 거두기 · 결정 완료 · 충돌, 한 줄 요약
- 이관: 옛 원장 · 에버그린 · 고정 노트를 여러 pass 에 걸쳐 잃지 않고 옮긴다(재실행 안전)
- 도구: memory_pin → 기록, memory_record 신설, 주인 변경 API(owner)
- XGEN_MEMORY_RECORDS=off 로 예전 동작
- scripts/bench_memory_records.py 실측

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@CocoRoF
CocoRoF merged commit 4fde997 into main Nov 13, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant