rsync trash 무한 누적: 자동 purge 미작동 + vm_bundles 동기화로 17일간 13GB 적재

[ComBba]

요약

rsync --backup-dir 기반 trash(~/.claudesync/trash/)가 자동 purge 없이 무한 누적되어, 한 대(MacBook Air)에서 17일간 13GB / 5,154개 폴더까지 증가했습니다. 체감 디스크 증가량은 주당 30GB 수준으로, 디스크 압박의 주요 원인입니다.

증거 (현장 데이터)

• ~/.claudesync/trash 총량: 13GB, 하위 폴더 5,154개
• 누적 기간: 2026-05-20 ~ 2026-06-05 (약 17일)
• 일자별 생성 폴더 수 예시:
  • 2026-05-29: 194개
  • 2026-05-31: 445개
  • 2026-06-04: 1,379개 (하루 만에)
• trash 내용물 상당수가 대용량 이미지의 이전 버전:
  • trash/<UUID>/vm_bundles/claudevm.bundle/*.rootfs.img* (수백 MB ~ 1.3GB 다수)
  • trash/<UUID>/.../logs_2.sqlite (107MB, 다수 복제)
  • trash/<UUID>/claudevm.bundle/sessiondata.img (수백 MB)

근본 원인

1. trash 자동 purge 미작동

• docs/prd/PRD.md:558 — "Automatic purge: conflicts after 30 days, trash after 7 days. Configurable retention."
• docs/prd/PRD.md:557 — "trash before delete ... 7-day retention."
• docs/specs/TECHNICAL_SPEC.md:2281 — func pruneOlderThan(_ date: Date) 가 명세에 존재
• 그러나 실제 환경에는 17일 전(5/20) 항목이 그대로 잔존 → purge가 스케줄/실행되지 않음.

2. 고변동 대용량 디렉터리(vm_bundles)가 동기화 대상에 포함

• Claude Desktop 로컬 에이전트 모드의 ~/Library/Application Support/Claude/vm_bundles/(라이브 약 37GB)는 세션마다 GB급 rootfs 이미지를 재생성합니다(COW 스냅샷 다수).
• 매 동기화 시 갱신된 멀티-GB 이미지의 이전 버전 전체가 backup-dir(trash)로 적재 → 폭증.
• 현재 기본 exclude에는 Cache/, GPUCache/, blob_storage/ 등은 있으나 vm_bundles/는 없음.

제안 수정

1. trash 자동 purge 활성화/스케줄링 — pruneOlderThan(now - 7d)를 동기화 주기 또는 별도 타이머(예: 기존 com.user.claude.prepush-cleanup LaunchAgent와 유사)로 실제 호출. conflicts(30일)도 동일.
2. 기본 exclude에 고변동·재생성 가능 대용량 경로 추가:
   • vm_bundles/ (Claude Desktop 로컬 에이전트 VM 이미지 — 동기화 가치 낮고 변동 극심)
   • 필요 시 *.img, *.raw, Code Cache/, DawnWebGPUCache/
3. trash 용량 상한(cap) 옵션 — retention과 별개로, 총량 또는 폴더 수 상한 초과 시 오래된 항목부터 제거.
4. (선택) preferences.json의 extraExcludes로 사용자가 즉시 회피 가능하도록 문서화.

적용한 임시 조치(워크어라운드)

# 활성 rsync backup-dir(당일 UUID)는 보존, 1일 이상 경과분만 제거
find ~/.claudesync/trash -maxdepth 1 -mindepth 1 -type d -mtime +1 -print0 | xargs -0 rm -rf

→ 12.62GB 회수 (실데이터/실행 중 동기화 무영향). 단, 근본 수정(자동 purge + exclude) 없이는 재발합니다.

환경

• macOS (Apple Silicon), 시스템 rsync(openrsync) + Homebrew rsync 혼용 환경
• 피어: MacBook Air ↔ MacBook Pro 양방향 동기화

[ComBba]

추가 현장 확인 (2026-06-08 KST)

디스크 정리 중 동일 증상을 재확인했습니다.

현재 설치/소스 버전

• 설치 앱: ClaudeSync 1.3.4 (CFBundleVersion 26)
• 로컬 repo HEAD: v1.3.4 (5c79300)
• 즉, 현재 설치 앱과 로컬 소스 버전은 일치하는 것으로 보입니다.

관찰된 누적 상태

• ~/.claudesync: 12G
• ~/.claudesync/trash: 12G
• ~/Documents/GitHub/ClaudeSync: 730M
• ~/Library/Caches/claude-cli-nodejs/-Users-kimsejun-Documents-GitHub-ClaudeSync: 88K

~/.claudesync 용량의 거의 전부가 trash였습니다.

큰 trash 항목 예시

• vm_bundles/claudevm.bundle/rootfs.img: 3.9G
• claudevm.bundle/rootfs.img.zst: 2.0G
• vm_bundles/claudevm.bundle/...rootfs...: 600M
• logs_2.sqlite: 107M 복제본 다수

프로세스/동작 확인

ClaudeSync 실행 중 rsync --backup --backup-dir=~/.claudesync/trash/<UUID>/ 형태의 작업이 반복적으로 생성되는 것을 확인했습니다.

즉, trash bucket 자체는 의도된 quarantine 동작이지만, sync job마다 UUID bucket이 새로 생기며 빈도/용량 제어가 부족합니다.

코드 확인

• RsyncCommandBuilder.trashDir는 job UUID 기반으로 ~/.claudesync/trash/<job-id>/를 생성합니다.
• TrashJanitor는 존재하며 UUID-named bucket을 retentionDays 기준으로 daily sweep합니다.
• AppEnvironment에서 Preferences.trashRetentionDays가 TrashJanitor로 전달되는 것도 확인했습니다.
• 현재 ~/.claudesync/preferences.json에는 trashRetentionDays가 없어서 기본값 30일이 적용됩니다.

판단

현재 구현은 “오래된 trash 제거”에 대한 부분 방어는 있지만, 빠른 folder churn에 대한 하드 가드는 없습니다.

부족한 방어:

• trash 총 용량 cap 없음
• bucket 개수 cap 없음
• sync cycle당 bucket 재사용 없음
• empty/near-empty bucket 즉시 삭제 없음
• vm_bundles/ 같은 고변동 대용량 경로 기본 exclude 없음
• 기본 retention이 30일이라 high-frequency job 환경에서는 디스크 압박을 막기 어렵습니다.

오늘 적용한 임시 조치

ClaudeSync를 정상 종료한 뒤, rsync 프로세스가 없는 것을 확인하고, 2일보다 오래된 trash bucket만 삭제했습니다. 이후 ClaudeSync를 재실행했습니다.

결과:

• ~/.claudesync: 12G -> 16M
• ~/.claudesync/trash: 12G -> 0B
• 디스크 여유 공간: 171Gi -> 183Gi
• ClaudeSync 재실행 후 새 rsync job이 정상적으로 뜨는 것까지 확인했습니다.

이슈의 근본 수정 방향은 여전히 유효합니다: vm_bundles/ 기본 exclude + trash retention 기본값 단축 또는 cap 기반 janitor + empty bucket cleanup이 필요합니다.