elastic/supply-chain-monitorPyPIとnpmレジストリをポーリングし、新しいリリースをその前のバージョンと比較し、LLM分析を使用して悪意のあるコード変更を検出し、Slackアラートを送信する自動化されたサプライチェーンセキュリティモニター。
上位のPyPIおよびnpmパッケージのサプライチェーン侵害を自動監視します。両方のレジストリをポーリングして新しいリリースを取得し、各リリースを以前のバージョンと差分比較し、LLM（Cursor Agent CLI経由）を使用して差分を良性または悪意に分類します。悪意のある結果はSlackアラートをトリガーします。
両エコシステムはデフォルトで監視されます。一方を無効にするには--no-pypiまたは--no-npmを使用します。
各エコシステムは独自のポーリングスレッドで実行されますが、分析とアラートのパイプラインを共有します。
┌─── PyPI ──────────────────────┐ ┌─── npm ───────────────────────┐
│ │ │ │
│ changelog_since_serial() │ │ CouchDB _changes feed │
│ │ │ │ │ │
│ ▼ │ │ ▼ │
│ ┌────────────┐ │ │ ┌────────────┐ │
│ │ All PyPI │─┐ │ │ │ All npm │─┐ │
│ │ events │ │ │ │ │ changes │ │ │
│ └────────────┘ ▼ │ │ └────────────┘ ▼ │
│ hugovk ──► Watchlist │ │ download-counts ─► Watchlist │
│ │ │ │ │ │
│ "new release" events only │ │ new versions since last epoch │
└───────────────┬───────────────┘ └───────────────┬───────────────┘
│ │
▼ ▼
┌───────────────────┐ ┌───────────────────┐
│ Download old + new│ │ Download old + new│
│ (sdist + wheel) │ │ (tarball) │
└───────────────────┘ └───────────────────┘
│ │
└─────────────────┬─────────────────┘
▼
┌───────────────┐
│ Unified diff │
│ report (.md) │
└───────┬───────┘
▼
┌───────────────┐ ◄── LLM analysis
│ Cursor Agent │ (read-only)
│ CLI (ask mode)│
└───────┬───────┘
│
verdict?
│
malicious │
▼
┌───────────────┐
│ Slack alert │
└───────────────┘
LLM分析は以下を探すように指示されています。
pip install -r requirements.txtでインストールします（標準ライブラリがツールの大半をカバーしており、requestsはSlackアップロードに使用されます）agentバイナリ（IDEではありません）Windows (PowerShell):
irm 'https://cursor.com/install?win32=true' | iex
macOS / Linux:
curl https://cursor.com/install -fsS | bash
Verify with:
agent --version
Cursorで認証されている必要があります（agent loginまたはCURSOR_API_KEYの設定）。
Slackボットトークンをetc/slack.jsonに配置します：
{
"url": "https://hooks.slack.com/services/...",
"bot_token": "xoxb-...",
"channel": "C01XXXXXXXX"
}
ボットにはターゲットチャンネルに対するchat:writeスコープが必要です。channelフィールドはアラートが投稿されるSlackチャンネルIDです。
# One-shot: analyze releases from the last ~10 minutes
python monitor.py --once
# Continuous: monitor top 1000 packages (both ecosystems), poll every 5 min
python monitor.py --top 1000 --interval 300
# Production: monitor top 15000, alert to Slack
python monitor.py --top 15000 --interval 300 --slack
# npm only, top 5000
python monitor.py --no-pypi --npm-top 5000
# PyPI only
python monitor.py --no-npm
| ファイル | 目的 |
|---|---|
monitor.py | メインオーケストレーター — PyPI + npmをポーリング、差分、分析、アラート（並列スレッド） |
pypi_monitor.py | スタンドアロンPyPI変更ログポーラー（探索用） |
package_diff.py | 任意のPyPIまたはnpmパッケージの2つのバージョンをダウンロードして差分比較 |
analyze_diff.py | 差分をCursor Agent CLIに送信し、判定を解析 |
top_pypi_packages.py | ダウンロード数で上位N個のPyPIパッケージを取得してリスト表示 |
slack.py | Slack APIクライアント（SendMessage, PostFile） |
etc/slack.json | Slackボットの認証情報 |
last_serial.yaml | 永続化されたポーリング状態（PyPIシリアル + npmシーケンス/エポック） |
logs/ | 日次ログファイル（monitor_YYYYMMDD.log） |
python monitor.py [OPTIONS]
Options:
--top N Number of top packages to watch per ecosystem (default: 15000)
--interval SECS Poll interval in seconds (default: 300)
--once Single pass over recent events, then exit
--slack Enable Slack alerts for malicious findings
--model MODEL Override LLM model (default: composer-2-fast)
--debug Enable DEBUG logging (includes agent raw output)
PyPI options:
--no-pypi Disable PyPI monitoring
--serial N PyPI changelog serial to start from
npm options:
--no-npm Disable npm monitoring
--npm-top N Top N npm packages to watch (default: same as --top)
--npm-seq N npm replication sequence to start from
PyPIとnpmはそれぞれ独自のポーリングスレッドで実行されます。ポーリング状態（PyPIシリアル、npmシーケンス+エポック）はlast_serial.yamlに永続化されるため、再起動後もモニターは中断したところから再開します。
PyPIパイプライン：
--interval秒ごとにchangelog_since_serial()を呼び出します — 前回のチェック以降のすべてのイベントを返す単一のAPI呼び出しです"new release"イベントをフィルタリングしますnpmパイプライン：
replicate.npmjs.comから現在のCouchDBレプリケーションシーケンスを読み取ります--interval秒ごとに、最後のシーケンス以降のすべてのレジストリ変更の_changesフィードを取得しますすべての出力はコンソールとlogs/monitor_YYYYMMDD.logの両方に記録されます。
# Compare two versions from PyPI
python package_diff.py requests 2.31.0 2.32.0
# Compare two versions from npm
python package_diff.py --npm express 4.18.2 4.19.0
# Save to file
python package_diff.py telnyx 2.0.0 2.1.0 -o telnyx_diff.md
# Compare local archives
python package_diff.py --local old.tar.gz new.tar.gz -n mypackage
ダウンロードはpipやnpmではなく、レジストリAPI（PyPI JSON API / npmレジストリ）を介して直接行われます。つまり：
# Analyze a diff file
python analyze_diff.py telnyx_diff.md
# JSON output
python analyze_diff.py telnyx_diff.md --json
# Use a specific model
python analyze_diff.py telnyx_diff.md --model claude-4-opus
Cursor Agent CLIを--mode ask（読み取り専用）で--trust付きで実行します。エージェントは差分ファイルを読み取り、構造化された判定を返します。
終了コード：0 = 良性、1 = 悪意、2 = 不明/エラー。
# See what's being released right now (last ~10 min)
python pypi_monitor.py --once --top 15000
# Continuous monitoring (console output only, no analysis)
python pypi_monitor.py --top 1000 --interval 120
完全な分析パイプラインを実行せずにPyPIのリリース速度を調査したり、変更ログAPIをデバッグしたりするのに便利です。