Codes d’erreur
Chaque erreur a un code stable, un message et une solution. Les codes ne sont jamais traduits.
E_INTERNAL
HTTP 500 · exit 1
Une erreur interne s’est produite dans GenPM.
Solution: Réessayez avec --verbose et, si le problème persiste, signalez-le avec son requestId.
E_BAD_REQUEST
HTTP 400 · exit 2
La requête est invalide : …
Solution: Vérifiez les paramètres et réessayez.
E_USAGE
HTTP 400 · exit 2
Utilisation invalide : …
Solution: Exécutez genpm --help pour voir les options disponibles.
E_CONFIRM_REQUIRED
HTTP 400 · exit 2
Confirmation requise : …
Solution: Exécutez dans un terminal interactif, ou passez … pour confirmer.
E_PAYLOAD_TOO_LARGE
HTTP 413 · exit 2
Le corps de la requête est trop volumineux.
Solution: Envoyez 16 Ko au maximum.
E_NOT_FOUND
HTTP 404 · exit 3
… est introuvable.
Solution: Vérifiez l’orthographe ou recherchez avec genpm search <requête>.
E_NO_MATCHING_VERSION
HTTP 404 · exit 3
Aucune version de … ne correspond à ….
Solution: Exécutez genpm info … pour voir les versions publiées.
E_DEST_CONFLICT
HTTP 409 · exit 4
… existe et n’est pas vide.
Solution: Utilisez --dest
E_RANGE_UNSATISFIED
HTTP 409 · exit 4
Aucune version ne satisfait toutes les plages : …
Solution: Installez d’abord une version compatible du paquet en conflit, ou fixez une autre version.
E_ALREADY_INSTALLED
HTTP 409 · exit 4
… … est déjà installé.
Solution: Rien à faire. Utilisez genpm list pour voir les paquets installés.
E_VERSION_EXISTS
HTTP 409 · exit 4
…@… a déjà été publié.
Solution: Les versions sont immuables : incrémentez la version dans genpm.json et créez un nouveau tag.
E_DRIFT
HTTP 409 · exit 4
… a des modifications locales dans ….
Solution: Utilisez --keep-code pour conserver votre code, ou --force pour le supprimer quand même.
E_REQUIRED_BY
HTTP 409 · exit 4
… est requis par ….
Solution: Supprimez d’abord les paquets dépendants.
E_BUSY
HTTP 409 · exit 4
Un autre processus GenPM modifie ce projet.
Solution: Attendez qu’il se termine. Si aucun n’est en cours, supprimez .genpm/.lock.
E_PLAN_STALE
HTTP 409 · exit 4
Le projet a changé depuis le calcul du plan.
Solution: Recalculez le plan (simulation) et confirmez-le.
E_NETWORK
HTTP 502 · exit 5
Impossible de joindre ….
Solution: Vérifiez votre connexion, votre proxy ou GENPM_REGISTRY, puis réessayez.
E_UPSTREAM_GIT
HTTP 502 · exit 5
L’hôte Git a échoué : …
Solution: Vérifiez que le dépôt est accessible avec vos identifiants Git, puis réessayez.
E_RATE_LIMITED
HTTP 429 · exit 5
Trop de requêtes.
Solution: Attendez … et réessayez.
E_READ_ONLY
HTTP 503 · exit 5
Le registre est en lecture seule pendant une maintenance.
Solution: L’installation fonctionne toujours. Réessayez de publier plus tard ; suivi sur genpm.net.
E_INTEGRITY
HTTP 422 · exit 6
La vérification d’intégrité de … a échoué : …
Solution: N’utilisez pas ce paquet. Signalez-le via genpm.net/report si cela persiste.
E_SIGNATURE
HTTP 422 · exit 6
La signature du registre pour … est invalide.
Solution: Ne l’installez pas. Mettez à jour GenPM (nouvelles clés de signature) et signalez-le si cela persiste.
E_PATH_UNSAFE
HTTP 422 · exit 6
Chemin non sûr … (…).
Solution: Utilisez un chemin relatif dans le projet, sans .., chemin absolu ni dossier réservé.
E_AUTORUN_FILE
HTTP 422 · exit 6
… contient des fichiers exécutés automatiquement : ….
Solution: Ces fichiers ne sont jamais installés. Demandez à l’auteur de les retirer, ou utilisez --allow-autorun uniquement pour des éditeurs vérifiés.
E_SCAN_FAILED
HTTP 422 · exit 6
L’analyse de sécurité a rejeté … : …
Solution: Corrigez les problèmes listés par genpm validate et publiez une nouvelle version.
E_INSECURE_PERMS
HTTP 400 · exit 6
… est lisible par d’autres utilisateurs.
Solution: Exécutez chmod 600 ….
E_QUARANTINED
HTTP 451 · exit 6
… est en cours d’examen de sécurité.
Solution: Réessayez plus tard ou choisissez un autre paquet. Les examens prennent moins de 24 heures ouvrées.
E_REF_MUTABLE
HTTP 422 · exit 6
… n’est pas une référence immuable.
Solution: Utilisez un tag Git ou le SHA complet de 40 caractères d’un commit, jamais une branche.
E_ADVISORY
HTTP 409 · exit 6
… … fait l’objet d’une alerte de sécurité de gravité ….
Solution: Mettez à jour vers … ou ultérieur.
E_TOO_LARGE
HTTP 422 · exit 6
… dépasse la limite de taille : …
Solution: Excluez des fichiers avec .genpmignore, ou augmentez la limite avec --max-size si le paquet est légitime.
E_MANIFEST_INVALID
HTTP 422 · exit 6
genpm.json est invalide.
Solution: Corrigez les champs listés dans les détails. Exécutez genpm validate pour un rapport complet.
E_LOCK_INVALID
HTTP 422 · exit 6
genpm.lock est invalide ou corrompu.
Solution: Restaurez-le depuis Git ; ne modifiez jamais genpm.lock à la main.
E_NAME_MISMATCH
HTTP 422 · exit 6
Le nom du manifeste … ne correspond pas à ….
Solution: Publiez avec le nom déclaré dans genpm.json.
E_REF_NOT_FOUND
HTTP 422 · exit 3
… n’existe pas dans ….
Solution: Créez et poussez le tag : git tag … && git push --tags.
E_REF_NOT_PUSHED
HTTP 422 · exit 4
… n’est pas sur le dépôt distant ou pointe vers un autre commit.
Solution: Poussez le tag avec git push origin ….
E_REPO_NOT_ALLOWED
HTTP 422 · exit 7
… n’appartient pas au scope @….
Solution: Publiez depuis un dépôt du propriétaire GitHub lié au scope.
E_REPO_CHANGED
HTTP 422 · exit 6
Le dépôt derrière … a changé (possible repojacking).
Solution: Écrivez à hello@genpm.net avec l’objet [SECURITY] pour transférer le paquet.
E_CONTEXT_MISSING
HTTP 422 · exit 6
Le fichier de règles IA … n’existe pas.
Solution: Créez … (genpm init génère un modèle) ou définissez x dans genpm.json.
E_CONTEXT_TOO_LARGE
HTTP 422 · exit 6
Le fichier de règles IA … dépasse 16 Ko.
Solution: Raccourcissez-le : concentrez les règles sur l’objectif, la carte, l’intégration, les conventions et les interdits.
E_AUTH
HTTP 401 · exit 7
Vous n’êtes pas connecté, ou votre token est invalide ou expiré.
Solution: Exécutez genpm login (ou définissez GENPM_TOKEN en CI).
E_FORBIDDEN_SCOPE
HTTP 403 · exit 7
Vous ne pouvez pas publier dans @….
Solution: Demandez les droits de publication à un propriétaire de @…, ou utilisez votre propre scope.
E_GIT_MISSING
HTTP 500 · exit 8
Git n’est pas installé ou est antérieur à 2.25.
Solution: Installez Git 2.25 ou ultérieur, puis réessayez.
E_NODE_VERSION
HTTP 500 · exit 8
GenPM nécessite Node.js 20.11 ou ultérieur (… trouvé).
Solution: Mettez à jour Node.js ou installez le binaire autonome de genpm, qui n’en a pas besoin : genpm.net/docs/install
E_UPGRADE_UNSUPPORTED
HTTP 400 · exit 8
Cette copie de GenPM a été installée avec … : genpm upgrade ne met à jour que le binaire autonome.
Solution: Mettez-la à jour avec … ou installez le binaire depuis genpm.net/docs/install.
E_UPGRADE_PERMISSION
HTTP 500 · exit 8
Impossible de remplacer … : permission refusée.
Solution: Lancez genpm upgrade avec l’utilisateur propriétaire de ce fichier, ou réinstallez avec le script de genpm.net/docs/install.
E_UPGRADE_INTEGRITY
HTTP 422 · exit 6
Le fichier … téléchargé ne correspond pas à sa somme de contrôle SHA-256 publiée.
Solution: Rien n’a été modifié. Réessayez plus tard ; si cela se reproduit, signalez-le à hello@genpm.net avec l’objet [SECURITY].
E_MCP_SERVE_UNAVAILABLE
HTTP 500 · exit 8
genpm mcp serve n’est inclus que dans le binaire autonome de genpm.
Solution: Utilisez npx -y @genpm/mcp comme commande MCP (genpm mcp setup le fait pour vous) ou installez le binaire depuis genpm.net/docs/install.
E_NOT_A_PROJECT
HTTP 400 · exit 8
Aucun projet trouvé dans ….
Solution: Exécutez la commande dans un projet (avec package.json ou .git), ou passez --cwd