PT
Docs / Usando pacotes

Usando pacotes

add

genpm add @core/billing            # última versão
genpm add @core/auth@^1.2          # intervalo semver
genpm add @core/db --dest packages/db
genpm add @core/billing --dry-run  # mostra o plano sem escrever nada

O GenPM faz três perguntas separadas: injetar o código, adicionar servidores MCP (mostrando o comando completo) e rodar o comando do gerenciador de pacotes para as dependências npm. --yes só responde à primeira; use --mcp e --install-deps para as outras.

Se o destino existe e não está vazio, add falha com E_DEST_CONFLICT. --force move antes o conteúdo antigo para .genpm/backup/<timestamp>/.

search e info

genpm search stripe
genpm info @core/billing          # manifesto, dependências, MCP, variáveis de ambiente e as regras de IA completas
genpm info @core/billing --rules  # só as regras

list e remove

genpm list
genpm remove @core/auth

list compara cada arquivo injetado com o SHA-256 registrado (mudanças locais). remove se recusa a apagar código que você modificou (E_DRIFT): use --keep-code para mantê-lo ou --force para apagar mesmo assim. Um pacote do qual outro depende não pode ser removido primeiro (E_REQUIRED_BY). Remover um pacote também remove seus servidores MCP e os arquivos que o GenPM criou e ficaram vazios.

outdated e audit

genpm outdated
genpm audit   # adicione ao seu CI como: npx @genpm-net/cli audit

audit verifica a integridade dos arquivos, a assinatura do registry em cada entrada do lock, avisos de segurança, versões retiradas e quarentenas. Sai com código 6 se houver achados altos ou críticos.

update e diff

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

diff mostra o que mudou upstream desde a sua versão instalada, com os caminhos já apontando para a sua pasta (aplique com git apply --3way). update faz um merge de três vias: arquivos que você não tocou recebem a versão nova, as linhas que você mudou são mantidas e, se os dois lados mudaram as mesmas linhas, o arquivo fica com os marcadores padrão <<<<<<< e o comando sai com código 4. Um arquivo removido upstream que você modificou é mantido.

genpm diff --local também lista as suas mudanças locais; genpm update --dry-run mostra o plano sem escrever nada.

Saída JSON

Todos os comandos aceitam --json (uma linha, em inglês, sem perguntas). Sem terminal interativo, qualquer pergunta sem resposta falha com E_CONFIRM_REQUIRED (código de saída 2) e nada é escrito.

Receitas: vários pacotes de uma vez

Uma receita instala com um comando vários pacotes que funcionam juntos, com o mesmo plano e as mesmas perguntas do genpm add. As receitas curadas pelo GenPM estão em /recipes; seu time também pode manter a sua como arquivo JSON no repositório.

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

Registries privados

Times podem manter pacotes de repositórios privados em um registry privado (genpm registry create acme --owner minha-org, ou Configurações › Registries privados). Ele não existe para quem não é membro. Aponte seu scope para ele no .genpmrc e entre nele; o genpm add funciona igual. Membros leem pacotes internal; os private precisam de permissão (genpm access grant @acme/api team:minha-org/backend read). A GitHub App do GenPM precisa estar instalada na organização para o registry ler os repositórios privados.

# .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