Project Cleaner

배포 전 프로젝트를 정리합니다. 백업 파일, 임시 파일, 사용하지 않는 패키지를 스마트하게 탐지하고 제거합니다.

Steps to follow:

1. 백업 및 임시 파일 탐지

다음 패턴의 파일들을 프로젝트 전체에서 찾으세요:

백업 파일:

• *.bak
• *.backup
• *.old
• *~ (vim 백업)
• *.swp, *.swo (vim swap)

OS 임시 파일:

• .DS_Store (macOS)
• Thumbs.db, desktop.ini (Windows)

개발 임시 파일:

• *.tmp
• *.temp
• *.log (선택적 - 사용자에게 물어보기)

제외할 폴더:

• node_modules/
• .git/
• dist/, build/, out/
• .next/, .nuxt/
• coverage/

Glob 또는 Grep 도구를 사용하여 파일 목록을 수집하세요.

2. 의존성 분석 (핵심 로직)

찾은 각 백업/임시 파일에 대해 다음을 수행:

A. 파일 참조 검색

각 백업 파일이 어디서 import/require 되는지 Grep으로 검색:

검색 패턴 (JavaScript/TypeScript):

import.*from.*['"].*파일명.*['"]
require\(['"].*파일명.*['"]\)

검색 패턴 (Python):

import.*파일명
from.*파일명.*import

검색 패턴 (일반):

• 파일명을 그대로 검색 (확장자 포함)

예시:

• utils.js.bak 찾았다면
• 프로젝트 전체에서 utils.js.bak를 검색
• import 또는 require 하는 파일이 있는지 확인

B. 참조 파일 분류

검색 결과를 분석하여:

1. 실제 코드에서 참조 (.bak/.old 없는 일반 파일에서 import)

   • → 삭제 불가 (경고 표시)
   • 예: main.js가 api.js.bak를 import

2. 백업 파일끼리만 참조 (.bak → .bak)

   • → 삭제 가능 (미사용 그룹)
   • 예: a.js.bak ← b.js.bak ← c.js.bak (순환)

3. 아무도 참조 안 함

   • → 삭제 가능 (안전)

C. 그룹화

백업 파일끼리만 참조하는 경우 그룹으로 묶어서 표시:

미사용 백업 파일 그룹:
  - old/utils.js.bak
  - old/api.js.bak
  - old/helpers.js.bak
  (서로만 참조하고 실제 코드와 무관)

3. 사용하지 않는 패키지 분석

package.json 파일이 있는지 확인:

A. package.json 읽기

• dependencies와 devDependencies 목록 추출

B. 각 패키지 사용 여부 검색

각 패키지에 대해 Grep으로 검색:

검색 패턴:

import.*from.*['"]패키지명['"]
require\(['"]패키지명['"]\)

주의사항:

• @types/ 패키지는 TypeScript에서 자동 사용 (스킵)
• eslint-, prettier- 등 설정 패키지는 config 파일에서 사용 확인
• peer dependencies는 체크하지 않음

C. 미사용 패키지 목록 생성

실제 코드에서 import/require 되지 않는 패키지를 리스트업

선택적: depcheck 도구 설치 및 실행

npx depcheck

4. 삭제 목록 표시

사용자에게 한국어로 보기 좋게 정리된 목록을 보여주세요:

# 🗑️ 프로젝트 정리 결과

## ✅ 안전하게 삭제 가능한 파일

### 백업 파일 (12개)
- src/utils.js.bak (어디서도 사용 안 됨)
- src/api/old.js~ (어디서도 사용 안 됨)
- components/Button.jsx.old (어디서도 사용 안 됨)
...

### 미사용 백업 파일 그룹 (3개 파일)
- old/legacy-api.js.bak
- old/legacy-utils.js.bak
- old/legacy-helpers.js.bak
(서로만 참조, 실제 코드와 무관)

### OS 임시 파일 (5개)
- .DS_Store
- src/.DS_Store
- public/Thumbs.db
...

### 개발 임시 파일 (3개)
- debug.log
- test.tmp
- .swp
...

## 📦 사용하지 않는 패키지

### npm 패키지 (4개)
- lodash (코드에서 import 없음)
- moment (코드에서 import 없음)
- axios (코드에서 import 없음)
- chalk (코드에서 import 없음)

예상 절약 용량: ~2.3MB (파일) + ~15MB (패키지)

---

## ⚠️ 주의 필요

### 여전히 사용 중인 백업 파일
- config/database.js.bak (src/main.js에서 참조 중!)
  → 삭제하면 안 됩니다. 실제 코드를 먼저 수정하세요.

---

계속 진행하시겠습니까?

5. 사용자 확인

다음 옵션을 제공:

1. 모두 삭제 - 안전한 항목 전부 삭제
2. 파일만 삭제 - 백업/임시 파일만 삭제 (패키지 유지)
3. 패키지만 제거 - npm 패키지만 제거
4. 취소 - 아무것도 안 함

사용자의 선택을 기다리세요.

6. 삭제 실행

사용자가 승인하면:

A. 파일 삭제

rm -f [파일 목록]

각 파일을 삭제하면서 진행 상황 표시:

🗑️ 삭제 중...
✓ src/utils.js.bak 삭제됨
✓ .DS_Store 삭제됨
...

B. 패키지 제거

npm uninstall [패키지1] [패키지2] ...

C. 최종 정리 (선택적)

npm prune

7. 완료 메시지

작업 완료 후 요약:

✅ 프로젝트 정리 완료!

🗑️ 삭제된 항목:
   - 백업 파일: 12개
   - 임시 파일: 8개
   - npm 패키지: 4개

💾 절약된 용량: ~17.3MB

📦 다음 단계:
   1. git status로 변경사항 확인
   2. 프로젝트가 정상 작동하는지 테스트
   3. 문제없으면 커밋

깔끔하게 정리되었습니다! 🎉

Important Notes:

안전 장치

• 절대 삭제하면 안 되는 것:
  • node_modules/ 내부 파일 (전체 폴더는 괜찮음)
  • .git/ 관련 파일
  • 실제 코드에서 참조 중인 파일
  • package.json, package-lock.json

검색 최적화

• Grep 도구로 빠르게 검색
• 파일 확장자별로 적절한 패턴 사용
• 대소문자 구분 주의 (운영체제별)

사용자 경험

• 삭제 전 반드시 목록을 보여주고 확인
• 위험한 작업은 경고 표시
• 한국어로 친절하게 안내
• 각 단계마다 진행 상황 표시

에러 처리

• 파일 삭제 실패 시 계속 진행하고 마지막에 실패 목록 표시
• npm 패키지 제거 실패 시 원인 설명
• 권한 문제 등 예상 가능한 에러 안내