v1.2.0 안전 복원과 잔재 탐지 강화

무엇을 위한 업데이트인가

Orca 앱을 정상 제거한 뒤에도 AI 에이전트와 시스템에 남아 있는 Orca 스킬·훅·CLI·설정·캐시를 찾아 복구 가능하게 격리하는 도구입니다. Orca 앱 본체는 제거하지 않습니다.

주요 변경사항

• restore 명령을 추가해 정리 전 상태로 복원할 수 있습니다.
• manifest의 SHA-256 무결성, 운영체제, 백업 루트와 대상·백업 매핑을 검증합니다.
• 복원 위치에 새 파일이 있으면 덮어쓰기 전에 restore-conflicts에 보존합니다.
• WSL, SSH 원격 홈, 사용자 전체 ~/.orca, 프로젝트별 .orca 잔재를 선택적으로 정리합니다.
• 최신 Orca 공식 설치·스킬 경로와 중단된 설치 트랜잭션 잔재를 탐지합니다.
• macOS 대소문자 비구분 경로의 중복 처리를 방지합니다.
• Windows 사용자 PATH 복원을 지원합니다.
• Windows, macOS, Ubuntu와 Node.js 18·22 조합의 CI를 통과했습니다.

안전한 사용 순서

1. 운영체제의 정상 제거 기능으로 Orca 앱을 먼저 제거합니다.
2. Claude, Codex 등 관련 에이전트를 종료합니다.
3. scan과 clean --dry-run으로 대상을 확인합니다.
4. 실제 정리 후 문제가 있으면 생성된 manifest.json으로 복원합니다.

node scripts/orca-agent-cleanup.mjs scan
node scripts/orca-agent-cleanup.mjs clean --dry-run --include-app-data --include-voice-data
node scripts/orca-agent-cleanup.mjs clean --include-app-data --include-voice-data
node scripts/orca-agent-cleanup.mjs restore --dry-run --manifest /path/to/manifest.json
node scripts/orca-agent-cleanup.mjs restore --manifest /path/to/manifest.json

주의

기본 정리는 확인된 Orca 잔재만 백업 폴더로 격리합니다. OpenAI 공식 computer-use, 다른 공급자의 스킬과 사용자 프로젝트 코드는 자동으로 제거하지 않습니다.