# エラーコード

すべてのエラーには、固定のコード、メッセージ、対処方法があります。コードは翻訳されません。

## E_INTERNAL

HTTP 500 · exit 1

GenPM の内部でエラーが発生しました。

**対処:** --verbose を付けて再実行し、解決しない場合は requestId を添えて報告してください。

## E_BAD_REQUEST

HTTP 400 · exit 2

リクエストが不正です: …

**対処:** パラメーターを確認して再試行してください。

## E_USAGE

HTTP 400 · exit 2

使い方が正しくありません: …

**対処:** genpm --help で利用可能なオプションを確認してください。

## E_CONFIRM_REQUIRED

HTTP 400 · exit 2

確認が必要です: …

**対処:** 対話型ターミナルで実行するか、… を指定して確定してください。

## E_PAYLOAD_TOO_LARGE

HTTP 413 · exit 2

リクエスト本文が大きすぎます。

**対処:** 16 KB 以下にしてください。

## E_NOT_FOUND

HTTP 404 · exit 3

… が見つかりません。

**対処:** 綴りを確認するか、genpm search <検索語> で検索してください。

## E_NO_MATCHING_VERSION

HTTP 404 · exit 3

… に一致する … のバージョンがありません。

**対処:** genpm info … で公開済みのバージョンを確認してください。

## E_DEST_CONFLICT

HTTP 409 · exit 4

… は存在し、空ではありません。

**対処:** --dest <dir> または --force（先にバックアップを作成）を使用してください。

## E_RANGE_UNSATISFIED

HTTP 409 · exit 4

すべての範囲を満たすバージョンがありません: …

**対処:** 競合するパッケージの互換バージョンを先にインストールするか、別のバージョンに固定してください。

## E_ALREADY_INSTALLED

HTTP 409 · exit 4

… … はすでにインストールされています。

**対処:** 対応は不要です。genpm list でインストール済みパッケージを確認できます。

## E_VERSION_EXISTS

HTTP 409 · exit 4

…@… はすでに公開されています。

**対処:** バージョンは不変です。genpm.json のバージョンを上げて新しいタグを作成してください。

## E_DRIFT

HTTP 409 · exit 4

… には …にローカル変更があります。

**対処:** コードを残すには --keep-code、それでも削除するには --force を使用してください。

## E_REQUIRED_BY

HTTP 409 · exit 4

… は … に必要とされています。

**対処:** 先に依存しているパッケージを削除してください。

## E_BUSY

HTTP 409 · exit 4

別の GenPM プロセスがこのプロジェクトを変更中です。

**対処:** 完了するまでお待ちください。実行中のものがなければ .genpm/.lock を削除してください。

## E_PLAN_STALE

HTTP 409 · exit 4

プランの計算後にプロジェクトが変更されました。

**対処:** プランを再計算（ドライラン）して確認してください。

## E_NETWORK

HTTP 502 · exit 5

… に接続できません。

**対処:** 接続、プロキシ、または GENPM_REGISTRY を確認して再試行してください。

## E_UPSTREAM_GIT

HTTP 502 · exit 5

Git ホストでエラーが発生しました: …

**対処:** お使いの Git 認証情報でリポジトリにアクセスできることを確認して再試行してください。

## E_RATE_LIMITED

HTTP 429 · exit 5

リクエストが多すぎます。

**対処:** …待ってから再試行してください。

## E_READ_ONLY

HTTP 503 · exit 5

メンテナンス中のため、レジストリは読み取り専用です。

**対処:** インストールは引き続き利用できます。公開は後でもう一度お試しください。状況は genpm.net でお知らせします。

## E_INTEGRITY

HTTP 422 · exit 6

… の整合性チェックに失敗しました: …

**対処:** このパッケージは使用しないでください。解決しない場合は genpm.net/report から報告してください。

## E_SIGNATURE

HTTP 422 · exit 6

… のレジストリ署名が無効です。

**対処:** インストールしないでください。GenPM を更新（新しい署名鍵）し、解決しない場合は報告してください。

## E_PATH_UNSAFE

HTTP 422 · exit 6

安全でないパス …（…）。

**対処:** プロジェクト内の相対パスを使用してください。..、絶対パス、予約済みフォルダーは使えません。

## E_AUTORUN_FILE

HTTP 422 · exit 6

… に自動実行されるファイルが含まれています: …。

**対処:** これらのファイルはインストールされません。作者に削除を依頼するか、認証済みの公開者に限り --allow-autorun を使用してください。

## E_SCAN_FAILED

HTTP 422 · exit 6

セキュリティスキャンが … を拒否しました: …

**対処:** genpm validate が示す指摘を修正して新しいバージョンを公開してください。

## E_INSECURE_PERMS

HTTP 400 · exit 6

… は他のユーザーから読み取り可能です。

**対処:** chmod 600 … を実行してください。

## E_QUARANTINED

HTTP 451 · exit 6

… はセキュリティレビュー中です。

**対処:** 後でもう一度試すか、別のパッケージを選んでください。レビューは 24 営業時間以内に完了します。

## E_REF_MUTABLE

HTTP 422 · exit 6

… は不変の参照ではありません。

**対処:** Git タグまたは 40 文字のコミット SHA を使用してください。ブランチは使えません。

## E_ADVISORY

HTTP 409 · exit 6

… … には深刻度 … のセキュリティアドバイザリがあります。

**対処:** … 以降に更新してください。

## E_TOO_LARGE

HTTP 422 · exit 6

… はサイズ上限を超えています: …

**対処:** .genpmignore でファイルを除外するか、正当なパッケージであれば --max-size で上限を引き上げてください。

## E_MANIFEST_INVALID

HTTP 422 · exit 6

genpm.json が無効です。

**対処:** 詳細に記載されたフィールドを修正してください。完全なレポートは genpm validate で確認できます。

## E_LOCK_INVALID

HTTP 422 · exit 6

genpm.lock が無効か破損しています。

**対処:** Git から復元してください。genpm.lock を手で編集しないでください。

## E_NAME_MISMATCH

HTTP 422 · exit 6

マニフェスト名 … が … と一致しません。

**対処:** genpm.json に宣言された名前で公開してください。

## E_REF_NOT_FOUND

HTTP 422 · exit 3

… は … に存在しません。

**対処:** タグを作成してプッシュしてください: git tag … && git push --tags。

## E_REF_NOT_PUSHED

HTTP 422 · exit 4

… がリモートにないか、別のコミットを指しています。

**対処:** git push origin … でタグをプッシュしてください。

## E_REPO_NOT_ALLOWED

HTTP 422 · exit 7

… はスコープ @… の所有ではありません。

**対処:** スコープに紐づく GitHub オーナーのリポジトリから公開してください。

## E_REPO_CHANGED

HTTP 422 · exit 6

… の背後にあるリポジトリが変わりました（リポジャッキングの可能性）。

**対処:** パッケージを移管するには、件名を [SECURITY] として hello@genpm.net にメールしてください。

## E_CONTEXT_MISSING

HTTP 422 · exit 6

AI ルールファイル … が存在しません。

**対処:** … を作成する（genpm init でテンプレートを生成）か、genpm.json で x を設定してください。

## E_CONTEXT_TOO_LARGE

HTTP 422 · exit 6

AI ルールファイル … が 16 KB を超えています。

**対処:** 短くしてください。ルールは目的、構成、統合、規約、禁止事項に絞りましょう。

## E_AUTH

HTTP 401 · exit 7

ログインしていないか、トークンが無効または期限切れです。

**対処:** genpm login を実行してください（CI では GENPM_TOKEN を設定）。

## E_FORBIDDEN_SCOPE

HTTP 403 · exit 7

@… には公開できません。

**対処:** @… のオーナーに公開権限を依頼するか、自分のスコープを使用してください。

## E_GIT_MISSING

HTTP 500 · exit 8

Git がインストールされていないか、2.25 より古いバージョンです。

**対処:** Git 2.25 以降をインストールして再試行してください。

## E_NODE_VERSION

HTTP 500 · exit 8

GenPM には Node.js 20.11 以降が必要です（検出: …）。

**対処:** Node.js を更新するか、Node.js 不要のスタンドアロン genpm バイナリをインストールしてください: genpm.net/docs/install

## E_UPGRADE_UNSUPPORTED

HTTP 400 · exit 8

この GenPM は … でインストールされています。genpm upgrade が更新できるのはスタンドアロンバイナリのみです。

**対処:** … で更新するか、genpm.net/docs/install からバイナリをインストールしてください。

## E_UPGRADE_PERMISSION

HTTP 500 · exit 8

… を置き換えられません: アクセスが拒否されました。

**対処:** そのファイルの所有ユーザーで genpm upgrade を実行するか、genpm.net/docs/install のスクリプトで再インストールしてください。

## E_UPGRADE_INTEGRITY

HTTP 422 · exit 6

ダウンロードした … が公開されている SHA-256 チェックサムと一致しません。

**対処:** 何も変更されていません。後で再試行し、再発する場合は件名 [SECURITY] で hello@genpm.net に報告してください。

## E_MCP_SERVE_UNAVAILABLE

HTTP 500 · exit 8

genpm mcp serve はスタンドアロンの genpm バイナリにのみ含まれています。

**対処:** MCP コマンドとして npx -y @genpm/mcp を使うか（genpm mcp setup が設定します）、genpm.net/docs/install からバイナリをインストールしてください。

## E_NOT_A_PROJECT

HTTP 400 · exit 8

… にプロジェクトが見つかりません。

**対処:** プロジェクト（package.json または .git があるもの）の中で実行するか、--cwd <dir> を指定してください。