scan_dependencies
Parses dependency manifests and lockfiles to audit packages for existence, vulnerabilities, malware, and release cooldown, covering transitive dependencies.
Instructions
의존성 매니페스트를 파싱해 각 패키지의 실재·취약점·악성·쿨다운을 일괄 검사합니다.
scan_path 결과에서 requirements.txt·package.json 이 '검사 제외'로 표시되면 이 도구로 이어서 검사하세요.
네트워크: 온라인이면 공식 저장소와 OSV.dev에 패키지명·버전만 전송합니다 (소스 코드 미전송). GVSKB_MODE=offline(망분리)이면 외부 호출 없이 로컬 인텔 캐시로 대체하며, 실재·발행일은 '미확인'으로 표시됩니다.
락파일을 넣으면 전이 의존성까지 검사합니다. 실무 취약점은 대부분 매니페스트에 적히지 않은 전이 의존성에 있으므로, 락파일이 있으면 그쪽을 넣는 편이 정확합니다 (버전도 범위가 아니라 고정값이라 판정이 확실해집니다).
결과를 scan_path 결과 JSON의 dependency_audit 필드에 넣어 render_report를
호출하면 사람용 보고서에 '의존성 취약점' 섹션이 함께 렌더됩니다.
truncated_count > 0 이면 limit 로 잘려 검사되지 않은 패키지가 있다는
뜻입니다 — '이상 없음'이 아니므로 limit 를 올려 재검사하세요.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 검사할 최대 패키지 수. 미지정 시 형식에 맞춰 자동(매니페스트 20 · 락파일 500). 초과분은 truncated_count 로 표시 | |
| caller | No | 호출 주체 자율 신고 (예: 'harness:auto'). 감사 구분용 | |
| ecosystem | No | pypi | npm. 락파일이면 형식이 생태계를 확정하므로 이 값은 무시됩니다 | pypi |
| env_grade | No | 실행환경 등급 — 신규 버전 쿨다운 기준일만 정합니다(취약점·악성 판정에는 영향 없음): E0(개인PC 일회성, 3일) | E1(개인PC 반복도구, 7일, 기본) | E2(내부서버 공용, 14일). **사용자가 배포 환경을 명시하지 않으면 비워 두세요** — 도구가 자동 판별하지 않으며, 넘긴 값이 보고서에 '검사 실행 시 지정'으로 그대로 기록됩니다. | |
| manifest_text | Yes | 의존성 매니페스트 또는 **락파일**의 원문 텍스트. 매니페스트: requirements.txt·package.json / 락파일: package-lock.json·uv.lock·poetry.lock·pnpm-lock.yaml·yarn.lock |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||