Skip to content

feat: peerDependencies 호환성 검증 단계 추가 #17

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
yujeong-jeon merged 2 commits into from
Mar 18, 2026
Merged

feat: peerDependencies 호환성 검증 단계 추가 #17

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
35fa204
feat: update peerDependencies compatibility check in package evaluati…
yujeong-jeon Mar 13, 2026
044db10
feat: enhance peerDependencies compatibility check with optional meta…
yujeong-jeon Mar 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 37 additions & 3 deletions plugins/package-evaluator/commands/evaluate-package.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,35 @@ node <스크립트경로>/scrape-npmx.mjs $ARGUMENTS
- 동일 패키지가 이미 설치되어 있는 경우 → 중복 설치 경고
- 유사 기능의 패키지가 이미 있는 경우 → 기존 패키지 활용 권장

### 3. GitHub 이슈 분석 (가능한 경우)
### 3. peerDependencies 호환성 확인

평가 대상 패키지의 `peerDependencies`가 현재 프로젝트와 호환되는지 확인합니다.

```bash
# 대상 패키지의 peerDependencies 및 optional 여부 조회
npm view <패키지명> peerDependencies peerDependenciesMeta --json
```

프로젝트의 실제 설치 버전을 확인합니다 (`package.json`의 semver 범위가 아닌 resolved 버전 기준):

```bash
# 실제 설치된 버전 확인 (lockfile 기반)
npm ls <peer-패키지명> --json 2>/dev/null | node -e "const d=require('/dev/stdin'); console.log(JSON.stringify(d?.dependencies))"
```

패키지 매니저 감지:

- `package.json` (npm/yarn/pnpm)
- `bun.lockb` 또는 `bun.lock` 존재 시 Bun 환경
- `deno.json` 또는 `deno.jsonc` 존재 시 Deno 환경 (`imports` 필드 확인)

확인 항목:

- **미충족 peer**: peerDependencies에 명시된 패키지가 프로젝트에 없는 경우 → ⚠️ 경고 (설치 필요)
- **버전 불일치**: peerDependencies 범위와 프로젝트의 설치 버전이 호환되지 않는 경우 → ❌ 거부
- **선택적 peer**: `peerDependenciesMeta`에서 `optional: true`인 경우 → 미설치여도 무시

### 4. GitHub 이슈 분석 (가능한 경우)

`npm view <패키지명> repository.url --json`으로 GitHub 저장소 URL을 가져옵니다.
GitHub 저장소가 확인되면 아래 정보를 추가 수집합니다:
Expand All @@ -78,7 +106,7 @@ gh api "repos/{owner}/{repo}/issues?state=all&per_page=20&sort=created&direction
- **방치된 이슈**: 코멘트 0개이고 30일 이상 열려있는 이슈 수
- GitHub 저장소가 없거나 접근 불가한 경우 이 단계를 건너뜁니다

### 4. 평가 기준 적용
### 5. 평가 기준 적용

수집된 메트릭을 기준에 대입하여 판정합니다:

Expand All @@ -88,6 +116,7 @@ gh api "repos/{owner}/{repo}/issues?state=all&per_page=20&sort=created&direction
- License가 GPL 계열 (소스 공개 의무)
- Deprecated 상태
- High 이상 심각도의 취약점(Vulnerabilities)이 1건 이상 존재
- peerDependencies 버전이 프로젝트의 설치 버전과 호환되지 않음

#### 경고 조건 (⚠️ 주의 필요)

Expand All @@ -97,6 +126,7 @@ gh api "repos/{owner}/{repo}/issues?state=all&per_page=20&sort=created&direction
- CJS 전용 (ESM 미지원) — 도입은 가능하나 ESM 지원 대안이 있으면 대안 우선
- GitHub 이슈 중 버그 비율 50% 이상
- 이슈 평균 응답 기간 30일 초과
- 필수 peerDependencies가 프로젝트에 미설치 (추가 설치 필요)

#### 양호 조건 (✅)

Expand All @@ -105,7 +135,7 @@ gh api "repos/{owner}/{repo}/issues?state=all&per_page=20&sort=created&direction
- ESM 지원 (ESM + CJS 듀얼 포함)
- TypeScript 타입 지원

### 5. 결과 출력
### 6. 결과 출력

## 출력 형식

Expand Down Expand Up @@ -133,6 +163,10 @@ gh api "repos/{owner}/{repo}/issues?state=all&per_page=20&sort=created&direction
🔍 기존 설치 패키지 확인
- 동일/유사 패키지: 해당 없음

🔗 peerDependencies 호환성
- react: ^18.0.0 → 프로젝트 설치: 18.3.1 ✅
- react-dom: ^18.0.0 → 미설치 ⚠️

⚖️ 판정: ✅ 도입 가능
━━━━━━━━━━━━━━━━━━━━━━━━
```
Expand Down
Loading