labforce-dementor 4.2.0__tar.gz

labforce_dementor-4.2.0/LICENSE

@@ -0,0 +1,65 @@
+Labforce Dementor — Licença Gratuita Proprietária v1.0
+
+Copyright (c) 2026 Labforce. Todos os direitos reservados.
+
+1. CONCESSÃO DE USO
+
+A Labforce concede ao usuário uma licença gratuita, não exclusiva, revogável e
+intransferível para instalar e executar o Labforce Dementor com a finalidade de
+realizar assessments e análises de organizações Salesforce próprias ou de
+terceiros que tenham autorizado expressamente esse acesso.
+
+O uso em serviços profissionais de consultoria é permitido, desde que o
+usuário tenha autorização da organização analisada e que o software não seja
+revendido, sublicenciado ou apresentado como produto próprio.
+
+2. RESTRIÇÕES
+
+Sem autorização prévia e escrita da Labforce, não é permitido:
+
+- redistribuir, sublicenciar, vender, alugar ou transferir o software;
+- remover ou alterar marcas, avisos de propriedade ou identidade da Labforce;
+- rebrandear o software ou seus relatórios como produto de outra empresa;
+- oferecer o software, ou uma modificação dele, como serviço hospedado,
+  gerenciado ou concorrente;
+- modificar, adaptar ou criar obras derivadas para distribuição a terceiros;
+- contornar controles de segurança, consentimento, licença ou autorização.
+
+Esta licença não restringe direitos irrenunciáveis previstos em lei para fins
+de segurança, auditoria ou interoperabilidade.
+
+3. PROPRIEDADE
+
+O software, seu código, sua arquitetura, seus ativos, suas marcas e sua
+documentação permanecem de propriedade exclusiva da Labforce. A disponibilização
+do pacote não transfere propriedade intelectual ao usuário.
+
+4. USO AUTORIZADO E DADOS
+
+O usuário é responsável por obter autorização para acessar cada organização
+Salesforce analisada, proteger credenciais e cumprir as regras de privacidade,
+segurança e retenção aplicáveis. Esta licença não autoriza acesso a sistemas ou
+dados de terceiros sem permissão.
+
+5. AUSÊNCIA DE GARANTIA
+
+O software é fornecido no estado em que se encontra, sem garantias expressas
+ou implícitas. Achados, scores e recomendações devem ser revisados por pessoas
+qualificadas antes de decisões ou alterações em ambientes Salesforce.
+
+6. LIMITAÇÃO DE RESPONSABILIDADE
+
+Na máxima extensão permitida pela legislação aplicável, a Labforce não será
+responsável por danos indiretos, perda de dados, perda de receita ou decisões
+tomadas exclusivamente com base nos resultados do software.
+
+7. ENCERRAMENTO
+
+O descumprimento destes termos encerra automaticamente a licença. Após o
+encerramento, o usuário deverá interromper o uso e remover as cópias sob seu
+controle, sem prejuízo dos direitos legalmente preservados.
+
+8. CONTATO
+
+Autorizações de redistribuição, integração comercial, OEM ou uso hospedado
+devem ser solicitadas a contato@labforce.com.br.

labforce_dementor-4.2.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: labforce-dementor
+Version: 4.2.0
+Summary: Assessment read-only e inteligência de arquitetura para organizações Salesforce
+Author-email: Labforce <contato@labforce.com.br>
+License-Expression: LicenseRef-Labforce-Free-Proprietary-1.0
+Project-URL: Homepage, https://labforce.com.br/dementor/
+Project-URL: Documentation, https://labforce.com.br/dementor/documentacao/
+Keywords: salesforce,assessment,architecture,governance,security
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Information Technology
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0.2
+Requires-Dist: Jinja2>=3.1.4
+Requires-Dist: matplotlib>=3.9.0
+Requires-Dist: networkx>=3.3
+Requires-Dist: WeasyPrint>=66.0
+Dynamic: license-file
+
+# 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:
+
+```bash
+uv tool install labforce-dementor
+dementor --version
+dementor doctor
+```
+
+Também é possível usar:
+
+```bash
+pipx install labforce-dementor
+```
+
+Com pip, use um ambiente virtual:
+
+```bash
+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.
+
+```bash
+sf org login web --alias MINHA_ORG
+sf org display --target-org MINHA_ORG
+```
+
+## Primeiro assessment
+
+```bash
+dementor run --target-org MINHA_ORG
+```
+
+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
+
+Primeiro, gere a prévia sanitizada. Essa etapa não chama o provedor:
+
+```bash
+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:
+
+```bash
+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](https://labforce.com.br/dementor/)
+- [Documentação de instalação e uso](https://labforce.com.br/dementor/documentacao/)
+
+## 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.

labforce_dementor-4.2.0/PYPI_README.md

@@ -0,0 +1,99 @@
+# 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:
+
+```bash
+uv tool install labforce-dementor
+dementor --version
+dementor doctor
+```
+
+Também é possível usar:
+
+```bash
+pipx install labforce-dementor
+```
+
+Com pip, use um ambiente virtual:
+
+```bash
+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.
+
+```bash
+sf org login web --alias MINHA_ORG
+sf org display --target-org MINHA_ORG
+```
+
+## Primeiro assessment
+
+```bash
+dementor run --target-org MINHA_ORG
+```
+
+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
+
+Primeiro, gere a prévia sanitizada. Essa etapa não chama o provedor:
+
+```bash
+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:
+
+```bash
+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](https://labforce.com.br/dementor/)
+- [Documentação de instalação e uso](https://labforce.com.br/dementor/documentacao/)
+
+## 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.