FR
Traduction bêta
Docs / Utiliser des paquets

Utiliser des paquets

add

genpm add @core/billing            # dernière version
genpm add @core/auth@^1.2          # plage semver
genpm add @core/db --dest packages/db
genpm add @core/billing --dry-run  # affiche le plan sans rien écrire

GenPM pose trois questions séparées : injecter le code, ajouter des serveurs MCP (en affichant la commande complète) et lancer la commande du gestionnaire de paquets pour les dépendances npm. --yes ne répond qu’à la première ; utilisez --mcp et --install-deps pour les autres.

Si la destination existe et n’est pas vide, add échoue avec E_DEST_CONFLICT. --force déplace d’abord l’ancien contenu dans .genpm/backup/<timestamp>/.

search et info

genpm search stripe
genpm info @core/billing          # manifeste, dépendances, MCP, variables d’environnement et règles IA complètes
genpm info @core/billing --rules  # seulement les règles

list et remove

genpm list
genpm remove @core/auth

list compare chaque fichier injecté avec son SHA-256 enregistré (modifications locales). remove refuse de supprimer du code que vous avez modifié (E_DRIFT) : utilisez --keep-code pour le garder ou --force pour le supprimer quand même. Un paquet dont un autre dépend ne peut pas être retiré en premier (E_REQUIRED_BY). Retirer un paquet retire aussi ses serveurs MCP et les fichiers créés par GenPM qui se retrouvent vides.

outdated et audit

genpm outdated
genpm audit   # à ajouter à votre CI : npx @genpm-net/cli audit

audit vérifie l’intégrité des fichiers, la signature du registry de chaque entrée du lock, les avis de sécurité, les versions retirées et les quarantaines. Il sort avec le code 6 en cas de problème élevé ou critique.

update et diff

genpm diff @core/auth
genpm update @core/auth

diff affiche ce qui a changé en amont depuis votre version installée, avec des chemins qui pointent déjà vers votre dossier (appliquez-le avec git apply --3way). update fait une fusion à trois voies : les fichiers que vous n’avez pas touchés reçoivent la nouvelle version, vos lignes modifiées sont conservées et, si les deux côtés ont changé les mêmes lignes, le fichier garde les marqueurs standard <<<<<<< et la commande sort avec le code 4. Un fichier supprimé en amont que vous avez modifié est conservé.

genpm diff --local liste aussi vos changements locaux ; genpm update --dry-run affiche le plan sans rien écrire.

Sortie JSON

Toutes les commandes acceptent --json (une ligne, en anglais, sans questions). Sans terminal interactif, toute question sans réponse échoue avec E_CONFIRM_REQUIRED (code de sortie 2) et rien n’est écrit.

Recettes : plusieurs paquets d’un coup

Une recette installe en une commande plusieurs paquets qui fonctionnent ensemble, avec le même plan et les mêmes questions que genpm add. Les recettes sélectionnées par GenPM sont sur /recipes ; votre équipe peut aussi garder la sienne dans un fichier JSON du dépôt.

genpm compose --list
genpm compose saas-starter --dry-run
genpm compose ./stack.json
{ "name": "my-stack", "p": ["@core/db", "@core/auth@^1.2"] }

Registres privés

Les équipes peuvent garder les paquets de dépôts privés dans un registre privé (genpm registry create acme --owner mon-org, ou Paramètres › Registres privés). Il n’existe pas pour qui n’est pas membre. Faites pointer votre scope vers lui dans .genpmrc et connectez-vous à lui ; genpm add fonctionne de la même façon. Les membres lisent les paquets internal ; les private exigent un droit (genpm access grant @acme/api team:mon-org/backend read). L’application GitHub de GenPM doit être installée sur l’organisation pour que le registre lise ses dépôts privés.

# .genpmrc
@acme:registry=https://api.genpm.net/r/acme
# ENT-03: policy
policy=https://api.genpm.net/r/acme
genpm login --registry https://api.genpm.net/r/acme
genpm add @acme/payments