npm パッケージヘルスチェック(Lite版) は何をしますか?
ネットワークアクセス(宣言済み)
registry.npmjs.org/<package> への1回の GET リクエスト — 公開レジストリのメタデータのみ。他のホストへのアクセスなし、データ送信なし、パッケージのインストールなし、コード実行なし。
制約
- 「Stale」は公開の新しさに基づくヒューリスティックです — 静かなパッケージが必ずしも放棄されているわけではありません。
- このLite版では週間ダウンロード統計は取得しません(フルバージョンで2回目のAPI呼び出しを行います)。
1. 実行
Node 18+ 必須、依存関係ゼロ。
node <skill-dir>/scripts/health.mjs <package-name>
JSON が stdout に出力されます。フェッチ失敗時は終了コード 1、引数欠落時は 2 を返します。
2. レポートを読む
latest,lastPublish,ageDays,deprecated,license,health- フラグ:
deprecated文字列が存在する、ageDays > 730、license: null
3. レポート
<package>@<latest>: <health>
last publish Y days ago · license <spdx|none> · deprecated <yes/no>
<one-line recommendation: safe to add / pin version / consider alternative>
Lite版とフル版の比較
フル版 npm-package-health は、追加で週間ダウンロード数(api.npmjs.org)、メンテナー数、依存関係数を報告します。