Labforce Dementor

Assessment read-only para organizações Salesforce, com diagnóstico determinístico de arquitetura, automações, Apex, segurança, permissões, integrações, governança e riscos.

O diagnóstico principal funciona sem IA. Quando habilitado, o complemento de IA exige que o usuário escolha o provedor, o modelo e os dados autorizados antes de qualquer chamada externa.

Instalação

O método recomendado mantém o executável isolado do Python do sistema:

uv tool install labforce-dementor
dementor --version
dementor doctor

Também é possível usar:

pipx install labforce-dementor

Com pip, use um ambiente virtual:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install labforce-dementor

O nome de distribuição é labforce-dementor. O pacote chamado apenas dementor no PyPI pertence a outro projeto.

Pré-requisitos

• Python 3.11 ou superior;
• Salesforce CLI (sf);
• uma organização autorizada na Salesforce CLI.

sf org login web --alias MINHA_ORG
sf org display --target-org MINHA_ORG

Primeiro assessment

dementor run --target-org MINHA_ORG

Durante a execução, o terminal mostra em tempo real a fase atual, a atividade em andamento e o tempo decorrido. Em logs e CI, o progresso é emitido em linhas estáveis. Use --no-progress quando quiser ocultá-lo.

Os dados humanos do assessment e os relatórios JSON, Markdown, HTML e PDF são gerados em português (pt-BR). Identificadores técnicos, nomes de componentes e enums estáveis são preservados para manter a compatibilidade com integrações.

Por padrão, os resultados são gravados em ./assessments/<org>/<data-hora> e incluem JSON, Markdown, HTML, PDF e manifestos de execução e integridade.

Contrato de segurança

• allowlist de comandos read-only;
• REST somente com GET;
• bloqueio de deploy, DML e Apex Anonymous;
• profiling de dados somente com --profile-data;
• valores brutos do profiling não são persistidos;
• API budget e deployment guard;
• evidências e manifestos locais.

IA opcional com autorização explícita

Ao terminar dementor run em um terminal interativo, responda à pergunta sobre gerar o complemento. Você escolhe provedor, modelo, dados e credencial, revisa a prévia e digita a frase de autorização antes do envio. Use --no-ai-prompt para pular essa etapa; sessões sem terminal não chamam IA.

Para usar um JSON já gerado sem refazer a coleta:

dementor ai-report --assessment assessments/MINHA_ORG/EXECUCAO/assessment.json

O assistente lê a chave da variável de ambiente do provedor (OPENAI_API_KEY, ANTHROPIC_API_KEY ou GEMINI_API_KEY) ou do cofre Labforce, conforme sua escolha. Ollama local não exige chave. Cancelar ou falhar na etapa preserva o assessment.

Os comandos manuais continuam disponíveis. Primeiro, gere a prévia sanitizada. Essa etapa não chama o provedor:

dementor ai-preview \
  --assessment assessment.json \
  --provider openai \
  --model MODELO_EXATO \
  --scope findings_with_evidence \
  --output ai-consent-preview.json

Depois de revisar o payload e a frase de autorização, execute o complemento:

dementor ai-complement \
  --preview ai-consent-preview.json \
  --authorize AUTORIZAR-XXXXXXXX \
  --authorized-by usuario@example.com \
  --credential-source environment \
  --output-dir ai-complement-report

O consentimento expira, é de uso único e fica vinculado ao diagnóstico, provedor, modelo, escopos, prompt e payload. O relatório consultivo da IA não altera o score, as severidades ou os achados determinísticos.

Documentação

• Labforce Dementor
• Documentação de instalação e uso

Suporte

Entre em contato pelo endereço contato@labforce.com.br.

Licença

O Labforce Dementor é gratuito e proprietário. O uso em assessments próprios ou em serviços de consultoria autorizados é permitido. Redistribuição, revenda, rebranding e oferta hospedada exigem autorização escrita da Labforce. Consulte o arquivo LICENSE incluído na distribuição.