@pathbit/agentdevkit 0.0.10 → 0.0.11

package/docs/guides/security-references.md

@@ -0,0 +1,97 @@
+---
+description: Ferramentas e skills de segurança locais e open source.
+---
+
+# Referências de segurança
+
+As verificações do kit executam no computador do projeto. Não exigem conta,
+assinatura ou envio de código a um serviço. Downloads de ferramentas e bases
+públicas são etapas explícitas; a análise usa os arquivos locais.
+
+## Ferramentas selecionadas
+
+| Ferramenta | Origem e licença | Função |
+| --- | --- | --- |
+| [Gitleaks][gitleaks] | Comunidade, MIT | Segredos em arquivos e Git. |
+| [OSV-Scanner][osv] | Google, Apache-2.0 | Dependências, com base OSV local. |
+| [Opengrep][opengrep] | Consórcio, LGPL-2.1 | Código, com regras locais. |
+
+O catálogo fixa versões e hashes revisados. `install` verifica o download;
+`check` confere o binário local; `update` aplica o pin revisado no catálogo.
+Nenhum dos três exige Python instalado. O upstream do Gitleaks está focado
+em manutenção e correções; isso deve ser considerado nas próximas revisões.
+
+OSV deve usar `--offline`, não somente `--offline-vulnerabilities`.
+A base precisa ser preparada antes: ausência de dados não é resultado limpo.
+Opengrep usa configuração local e checagem de versão desativada; não use
+`--config auto`. O comando de auditoria normaliza os resultados e remove
+segredos e trechos de código dos relatórios.
+
+## Complementos por necessidade
+
+| Ferramenta | Licença | Quando considerar |
+| --- | --- | --- |
+| [Trivy][trivy] | Apache-2.0 | Imagens, IaC e SBOM. |
+| [ZAP][zap] | Apache-2.0 | Aplicação em execução; exige Java. |
+| [DevSkim][devskim] | MIT | Projetos .NET; exige runtime local. |
+
+Esses complementos não são instalados pelo grupo `security`. Uma adoção exige
+testar seu modo local, dependências, versão e licença. No ZAP, instalação não
+inicia proxy, daemon ou ataque; configure identidades de teste e alvo local.
+No Trivy, `--offline-scan` sozinho não bloqueia toda atualização de base.
+
+Serviços de análise que exigem conta ficam fora desse fluxo. CodeQL CLI não
+atende ao requisito de código aberto; Bandit e rotinas Python ficam fora do
+runtime adotado. Uma opção gratuita não é automaticamente open source.
+
+## Skills de mercado
+
+| Fonte | Recurso | Tratamento |
+| --- | --- | --- |
+| [OpenAI][openai] | Práticas e ameaças | Apache-2.0 por pasta. |
+| [GitHub][copilot] | Revisão de segurança | MIT. |
+| [Trail of Bits][tob] | Contexto e diffs | CC-BY-SA-4.0; candidata. |
+
+Os [pins e licenças do catálogo][catalog] evitam importar uma origem móvel.
+As quatro skills próprias de segurança já acompanham o kit; referências
+externas são opcionais e lidas por tarefa, sem copiar texto para os clientes.
+Preserve atribuição e share-alike dos recursos da Trail of Bits.
+Uma lista estática de CVEs em uma skill não substitui uma base atualizada.
+
+## O artigo como ponto de partida
+
+O [artigo compartilhado][article] orientou cinco temas: acesso aos dados,
+autorização no servidor, acesso por ID, segredos e entradas não confiáveis.
+O kit trata essas perguntas com verificações específicas:
+
+- PostgreSQL/Supabase usa RLS e políticas; Firebase usa Security Rules.
+  Papéis privilegiados e SDKs de servidor precisam de controles próprios.
+- Ocultar um botão não autoriza uma operação. Teste sem sessão e com dois
+  usuários ou tenants, incluindo acesso ao objeto de outra identidade.
+- Variáveis enviadas ao bundle são públicas; variáveis do servidor não são
+  automaticamente expostas. Um segredo confirmado exige remoção e rotação.
+- Validação de entrada, consultas parametrizadas, codificação de saída,
+  controles de upload e limites de uso resolvem riscos diferentes.
+
+As referências técnicas são [RLS][rls], [Firebase Rules][firebase],
+[autorização][authz], [segredos][secrets] e [uploads][uploads]. O kit não usa as
+estatísticas do artigo como comprovação de segurança do projeto.
+
+[Segurança no fluxo](security.md) · [Recursos](resources.md)
+
+[gitleaks]: https://github.com/gitleaks/gitleaks/tree/v8.30.1
+[osv]: https://github.com/google/osv-scanner/tree/v2.7.1
+[opengrep]: https://github.com/opengrep/opengrep/tree/v1.33.1
+[trivy]: https://github.com/aquasecurity/trivy
+[zap]: https://www.zaproxy.org/docs/desktop/start/features/
+[devskim]: https://github.com/microsoft/DevSkim
+[openai]: https://github.com/openai/skills
+[copilot]: https://github.com/github/awesome-copilot
+[tob]: https://github.com/trailofbits/skills
+[catalog]: ../../.pbai4devs/external-skills/CATALOG.json
+[article]: https://manodeyvin.com.br/p/5-vacilacoes-de-seguranca-que-a-ia
+[rls]: https://supabase.com/docs/guides/database/postgres/row-level-security
+[firebase]: https://firebase.google.com/docs/rules
+[authz]: https://cheatsheetseries.owasp.org/cheatsheets/Authorization_Cheat_Sheet.html
+[secrets]: https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html
+[uploads]: https://cheatsheetseries.owasp.org/cheatsheets/File_Upload_Cheat_Sheet.html

package/docs/guides/security.md

@@ -0,0 +1,32 @@
+---
+description: Segurança com scanners locais, triagem e provas de controles.
+language: pt
+---
+
+# Segurança local
+
+O kit instala skills, regras, comandos e perfis para revisar segurança.
+Os scanners exigem preparo explícito; nenhuma auditoria ou aplicação começa
+em segundo plano apenas porque os arquivos de instrução foram instalados.
+
+O [guia operacional][guide] acompanha o hub no projeto consumidor. Ele explica
+preparo das ferramentas, bases offline, relatório e triagem, além dos testes
+manuais de autorização, isolamento de dados, entradas e abuso.
+
+- [Preparar segurança][prepare]: instalar e verificar os scanners locais.
+- [Auditar segurança][audit]: analisar o alvo autorizado e interpretar sinais.
+- [Revisar autorização][authorization]: testar identidade e acesso por recurso.
+- [Modelar ameaças][threats]: antecipar riscos das fronteiras de confiança.
+- [Curadoria](security-references.md): fontes, licenças e ferramentas avaliadas.
+
+Use o [mapa do ecossistema](resources.md) para entender como perfis, skills,
+comandos, regras e scripts se conectam. Resultados ficam em `.agent-tests/`;
+scanners sozinhos não aprovam a segurança de um produto.
+
+[Wiki](../README.md) · [Ferramentas e testes](tools-and-testing.md)
+
+[guide]: ../../.pbai4devs/skills/seguranca/REFERENCE.md
+[prepare]: ../../.pbai4devs/commands/preparar-seguranca/COMMAND.md
+[audit]: ../../.pbai4devs/commands/auditar-seguranca/COMMAND.md
+[authorization]: ../../.pbai4devs/skills/seguranca/revisar-autorizacao/SKILL.md
+[threats]: ../../.pbai4devs/skills/seguranca/modelar-ameacas/SKILL.md

package/docs/maintainers/maintenance.md

@@ -32,6 +32,12 @@ A distribuição real é testada uma vez no perfil completo. Os outros perfis
 validam seus riscos específicos. Execuções antigas da mesma referência podem
 ser canceladas quando substituídas, sem cancelar uma publicação em andamento.
 
+O workflow [Security tools smoke][security-ci] instala os três scanners com
+pins revisados em Linux, macOS e Windows. Depois analisa fixtures locais sem
+rede, com casos inseguros e corrigidos. Essa prova valida o funcionamento das
+ferramentas; não certifica a segurança de uma aplicação. Relatórios normalizados
+são guardados como artifacts, sem binários ou fontes das fixtures.
+
 `npm run verify` executa o perfil completo. `ci:portable` e `ci:smoke`
 executam os demais perfis localmente. `npm run test:examples` verifica os
 cenários em `examples/generated/` quando a mudança afeta a geração.
@@ -106,3 +112,4 @@ aprovado; uma aprovação de CI não substitui a instalação real pelo registro
 [ci]: https://github.com/pathbit/AgentDevKit/actions/workflows/ci.yml
 [release]: https://github.com/pathbit/AgentDevKit/actions/workflows/release.yml
 [package]: https://www.npmjs.com/package/@pathbit/agentdevkit
+[security-ci]: https://github.com/pathbit/AgentDevKit/actions/workflows/security-tools.yml

package/docs/maintainers/packages.md

@@ -42,7 +42,7 @@ npx --registry=https://npm.pkg.github.com @pathbit/agentdevkit init
 ```
 
 Para repetir uma instalação, fixe a versão após o nome, como
-`@pathbit/agentdevkit@0.0.10`, nos dois destinos.
+`@pathbit/agentdevkit@0.0.11`, nos dois destinos.
 
 Acrescente `--agents codex,claude` para selecionar clientes, `--dry-run` para
 simular ou use `update`, `doctor` e `sync --check` no lugar de `init`.
@@ -89,7 +89,7 @@ Por padrão, uma tag publica nos dois destinos. Para completar o GitHub
 Packages de uma tag existente, preservando a release e o npm:
 
 ```console
-gh workflow run Release -f tag=v0.0.10 -F package_only=true -f registry=github
+gh workflow run Release -f tag=v0.0.11 -F package_only=true -f registry=github
 ```
 
 Se o artefato expirou, reexecute o CI original da tag antes da publicação.

package/docs/product/prd.md

@@ -1,7 +1,7 @@
 ---
 description: Requisitos da distribuição portátil AgentDevKit.
 status: aprovado
-version: 0.0.10
+version: 0.0.11
 ---
 
 # PRD do AgentDevKit
@@ -43,6 +43,9 @@ extraído do projeto de origem como produto independente.
 | FR-021 | Inventariar documentos existentes antes de propor alterações. |
 | FR-022 | Complementar documentação sem substituir arquivos por templates. |
 | FR-023 | Provar o fluxo documental em projetos reais e em projeto vazio. |
+| FR-024 | Incluir procedimentos de segurança nas instalações do kit. |
+| FR-025 | Compor entregas com agentes, skills, comandos, scripts e regras. |
+| FR-026 | Auditar localmente com ferramentas OSS e relatórios sem segredos. |
 
 Execuções repetidas devem ser idempotentes; a CLI oferece simulação e JSON.
 As instruções permanecem concisas, com detalhes opcionais em referências.

package/docs/product/roadmap.md

@@ -21,6 +21,7 @@ status: vigente
 | Preservação v0.0.8 | Auditoria e regressões | [Spec][robustness]. |
 | Coexistência v0.0.9 | Agentes, documentos e projetos reais | [Spec][coexistence]. |
 | Instalação nos dois registries v0.0.10 | Pacote e guias de pré-requisitos | [Spec][dual-install]. |
+| Segurança local v0.0.11 | Ferramentas e papéis especializados | [Spec][security]. |
 
 A primeira entrega segue a [spec v0.0.1](../specs/v0.0.1/SPEC.md), disponível
 na [release v0.0.1][release]. Os detalhes de mudanças estão no
@@ -44,3 +45,4 @@ comportamento existente, sem alterar a versão de uma release já publicada.
 [robustness]: ../specs/v0.0.8/SPEC.md
 [coexistence]: ../specs/v0.0.9/SPEC.md
 [dual-install]: ../specs/v0.0.10/SPEC.md
+[security]: ../specs/security-ecosystem/SPEC.md

package/docs/specs/README.md

@@ -16,6 +16,7 @@ description: Incrementos verificáveis do AgentDevKit.
 - [v0.0.9](v0.0.9/SPEC.md): coexistência e evolução documental sem perdas.
 - [Dois registries](dual-registry/SPEC.md): versão e bytes iguais no npm e GitHub.
 - [v0.0.10](v0.0.10/SPEC.md): release com instalação pelos dois registries e pré-requisitos.
+- [Ecossistema de segurança](security-ecosystem/SPEC.md): fluxos e scanners locais.
 
 Cada incremento vincula requisitos, critérios, testes e evidências locais.
 

package/docs/specs/security-ecosystem/README.md

@@ -0,0 +1,9 @@
+---
+description: Fluxos agênticos e segurança local do AgentDevKit.
+---
+
+# Ecossistema de segurança
+
+[Spec](SPEC.md): integrar recursos e scanners locais com provas de funcionamento.
+
+[Specs](../README.md) · [Segurança](../../guides/security.md)

package/docs/specs/security-ecosystem/SPEC.md

@@ -0,0 +1,53 @@
+---
+description: Recursos agênticos integrados e verificações locais de segurança.
+status: aprovado
+version: 0.0.11
+---
+
+# Ecossistema de segurança local
+
+## Objetivo
+
+Instalar procedimentos de segurança com o kit e conectar skills, comandos,
+agentes, regras, scripts e ferramentas em fluxos completos. Documentar a
+responsabilidade de cada recurso e usar análise local open source, sem conta
+ou pagamento obrigatório. Atualizar o talquee-ai-router pelo npm para 0.0.10
+preservando seu conteúdo e configuração.
+
+## Contrato
+
+- Skills explicam procedimentos; agentes assumem uma tarefa e sua entrega.
+- Comandos organizam entradas e etapas; scripts executam ações determinísticas.
+- Regras orientam contextos; ferramentas fornecem capacidades locais.
+- A instalação inclui fontes de segurança e apontamentos dos clientes escolhidos.
+- Scanners são instalados explicitamente, sem iniciar serviços.
+- Downloads públicos são separados da análise offline, com pins e integridade.
+- Ausência de ferramenta, base ou prova nunca equivale a uma auditoria aprovada.
+- Segredos, código e relatórios permanecem locais.
+- Scanners não substituem testes de autorização, isolamento e regras de negócio.
+- Preservar histórico e personalizações nos dois repositórios.
+- Distribuir os novos recursos em 0.0.11, mantendo o router fixado em 0.0.10.
+
+## Critérios de aceite
+
+| ID | Resultado observável |
+| --- | --- |
+| AC-001 | Instalação inclui skills, regras, comandos e perfis de segurança. |
+| AC-002 | Docs explicam componentes e fluxos conectados, com casos de uso. |
+| AC-003 | Três scanners OSS instalam, atualizam e verificam os pins locais. |
+| AC-004 | Auditoria offline detecta fixtures inseguras e diferencia falhas. |
+| AC-005 | Relatórios não expõem segredos e permanecem ignorados pelo Git. |
+| AC-006 | Curadoria registra fontes, licenças, limites e correções do artigo. |
+| AC-007 | Router em 0.0.10 preserva arquivos, índice, idioma e clientes. |
+| AC-008 | Regressões, pacote real, espelhos e revisão independente passam. |
+
+## Validação
+
+Verificar criação e descoberta de recursos em instalações novas e existentes.
+Executar scanners reais contra casos seguros e inseguros locais, com bases
+controladas e sem chamadas a serviços de análise. Testar downloads, hashes,
+links, rollback, dados ausentes, erros de scanner e saídas redigidas.
+Comparar snapshots do router antes e depois da atualização pelo npm.
+
+Código de testes é versionado; bases, binários, relatórios e snapshots ficam
+em `.agent-tests/`, `.local/` ou `tmp/`, ignorados pelo Git.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pathbit/agentdevkit",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Shared skills, specifications and workflows for AI coding agents.",
   "type": "module",
   "license": "MIT",