PT
Docs / Publicação

Referência do genpm.json

Um manifesto de origem completo (genpm.json na raiz do seu repo):

{
  "$": 1,
  "n": "@acme/billing",
  "v": "1.2.0",
  "s": { "en": "Stripe subscriptions with webhooks", "pt-BR": "Assinaturas Stripe com webhooks" },
  "d": "src/lib/billing",
  "k": ["stripe", "billing", "subscriptions"],
  "g": { "@core/db": "^1.0.0" },
  "p": { "stripe": "^17.0.0" },
  "e": ["STRIPE_SECRET_KEY", "STRIPE_WEBHOOK_SECRET"],
  "m": [{ "n": "stripe", "c": "npx", "a": ["-y", "@stripe/mcp"], "e": ["STRIPE_SECRET_KEY"] }]
}

As chaves têm um caractere para que os manifestos gastem poucos tokens. Tudo o que mostra manifestos a um LLM inclui esta legenda:

genpm keys: n=name v=version s=summary r=repo t=git-ref c=commit-sha d=install-dir i=repo-subdir x=ai-rules-file l=license k=keywords g=genpm-deps p=npm-deps e=env-vars m=mcp-servers(n=name c=command a=args u=url e=env)
Chave Nome Obrigatória Regras
n nome sim @escopo/nome, em minúsculas.
v versão sim SemVer estrito, sem prefixo v nem metadados de build.
d destino sim Caminho POSIX relativo no projeto de quem instala. Sem .. nem caminhos absolutos, nunca .git/, node_modules/ ou .genpm/, no máximo 8 segmentos.
s resumo recomendada ≤ 160 caracteres, uma linha. Texto ou { "en": "…", "pt-BR": "…" } (deve incluir en).
r repo não URL HTTPS do Git; por padrão, o remoto origin.
t ref não Uma tag ou um SHA de 40 caracteres hexadecimais; por padrão v{v}. Nunca uma branch.
i include não Subdiretório do repo a injetar (padrão .).
x contexto não Arquivo de regras de IA relativo a i (padrão AGENTS.md, ≤ 16 KB).
l licença não Expressão SPDX; vale a licença detectada pelo GitHub.
k palavras-chave não Até 10, ^[a-z0-9-]{2,32}$.
g dependências genpm não { "@core/db": "^1.0.0" }, até 10. Resolvidas pelo GenPM.
p dependências npm não Propostas ao usuário; nunca instaladas sem consentimento.
e ambiente não Nomes de variáveis (^[A-Z][A-Z0-9_]{1,63}$), nunca valores.
m mcp não Até 5 servidores: "@stripe/mcp" ou { "n", "c", "a", "u", "e" }.
_* extensões não Ignoradas pelas ferramentas oficiais. Qualquer outra chave é um erro.

O manifesto de origem não pode conter c (o próprio commit); o registry adiciona r, t, c, i, x e l ao resolvê-lo.

Exclua arquivos com .genpmignore (sintaxe do gitignore, relativa a i). .git/, .github/, node_modules/, genpm.json, .genpmignore e .env* são sempre excluídos.

Limites

O quê Limite
Arquivos por pacote 2.000
Tamanho do pacote 20 MB (amplie com --max-size ao instalar)
Um único arquivo 1 MB
Arquivo de regras de IA 16 KB; recomenda-se ~1.500 tokens, aviso acima de 4.000
Tamanho / profundidade do caminho 200 caracteres / 8 segmentos
Palavras-chave · deps genpm · deps npm · variáveis · servidores MCP 10 · 10 · 30 · 30 · 5

genpm validate verifica tudo isso localmente com o mesmo código que o registry roda.

JSON Schema: /schema/v1/genpm.json.