Skip to content

fix(issue#3): cwd-first ROOT resolution + seeded benchmark + miss 지표 보정 - #5

Merged
tak2-08 merged 1 commit into
mainfrom
fix/issue-3-cwd-root-seed
Aug 26, 2026
Merged

fix(issue#3): cwd-first ROOT resolution + seeded benchmark + miss 지표 보정#5
tak2-08 merged 1 commit into
mainfrom
fix/issue-3-cwd-root-seed

Conversation

@tak2-08

@tak2-08 tak2-08 commented Aug 26, 2026

Copy link
Copy Markdown
Owner

Closes #3

재현 → 패치 → 재검증

1. init이 스크립트 위치에 파일을 쓰는 버그 (재현 완료 후 수정)

  • 재현: 외부 디렉터리에서 node <clone>/tools/agent-context-init.mjs --yes 실행 → 사용자 프로젝트 빈 채로 원본 저장소 오염 (제보와 동일)
  • 수정:
    • init.mjs: ROOT = process.cwd() (또는 --target), 절대경로 로그
    • index/validate/search-lite/sessions/radio/handoff: cwd-first ROOT 결정 — cwd에 config/contextRoot 있으면 그곳, 없으면 스크립트 상대 폴백(소스 저장소 자기검사·CI용)
  • 재검증: 외부 프로젝트에서 init/sessions/handoff 실행 → 사용자 프로젝트에만 생성, 원본 무오염. npx 캐시 오염도 동일하게 해소(cwd 기준)

2. 벤치마크 재현성

  • mulberry32 시드 RNG + --seed 옵션 (기본 42)
  • 동일 시드 2회 실행 결과 diff 일치 확인 (REPRODUCIBLE)
  • BENCHMARK.md 헤더에 시드 명시

3. miss 쿼리 'saving 100%' 착시

  • hit=false → saving을 n/a (miss)로 표기, avg saving은 히트 기준 집계

4. 동시 쓰기 충돌 전략 문서화 (관찰 메모 반영)

  • docs/sessions.md: inbox/threads 경로 분리 · md는 1 PR=1 파일 · index.json은 충돌 시 재생성

검증

  • node --check 전체 tools 통과
  • 외부 디렉터리 init/sessions/handoff 실측 (사용자 프로젝트 생성 확인, 원본 무오염)
  • 시드 재현성 diff 일치

Issue #3 (by tak2-08 / Claude web 테스트) 참고하여 재현 → 패치:

1. init/index가 process.cwd() 대신 스크립트 위치에 파일을 쓰는 버그
   - 재현 확인: 외부 디렉터리에서 init 실행 시 사용자 프로젝트는 빈 채로
     원본 저장소의 agent-context/*.json이 덮어씌워짐
   - 수정: 모든 도구(index/init/validate/search-lite/sessions/radio/handoff)가
     cwd-first로 ROOT 결정 — cwd에 config 또는 contextRoot가 있으면 그곳,
     없으면 스크립트 상대경로 폴백(소스 저장소 자기검사/CI용)
   - init은 항상 process.cwd()(또는 --target)에 스캐폴드, 절대경로 로그 추가
   - 재검증: 외부 프로젝트에서 init/sessions/handoff 실행 → 사용자 프로젝트에만 생성, 원본 무오염

2. 벤치마크 재현성
   - mulberry32 시드 RNG 도입, --seed 옵션(기본 42)
   - 동일 시드 2회 실행 diff = 일치 확인 (REPRODUCIBLE)
   - BENCHMARK.md 헤더에 시드 고정 명시

3. miss 쿼리 'saving 100%' 착시 수정
   - hit=false인 경우 saving을 'n/a (miss)'로 표기 — 실패 검색을 절약으로 과장 제거
   - avg saving은 히트 기준으로만 집계

4. 동시 쓰기 충돌 전략 문서화 (docs/sessions.md): inbox/threads는 경로 분리,
   md는 1 PR = 1 파일, index.json은 충돌 시 재생성 원칙 명시
@tak2-08
tak2-08 merged commit 2bb248d into main Aug 26, 2026
1 check passed
@tak2-08
tak2-08 deleted the fix/issue-3-cwd-root-seed branch August 26, 2026 10:29
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.

init 커맨드가 process.cwd() 대신 스크립트 위치 기준으로 파일을 씀 + 벤치마크 재현성 개선 제안

1 participant