@pathbit/agentdevkit 0.0.9 → 0.0.11

package/docs/product/prd.md

@@ -1,7 +1,7 @@
 ---
 description: Requisitos da distribuição portátil AgentDevKit.
 status: aprovado
-version: 0.0.9
+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

@@ -20,6 +20,8 @@ status: vigente
 | Compatibilidade real v0.0.7 | Testes em clones existentes | [Spec][oss]. |
 | 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
@@ -42,3 +44,5 @@ comportamento existente, sem alterar a versão de uma release já publicada.
 [oss]: ../specs/v0.0.7/SPEC.md
 [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

@@ -14,6 +14,9 @@ description: Incrementos verificáveis do AgentDevKit.
 - [v0.0.7](v0.0.7/SPEC.md): projetos reais e proteção local de artefatos.
 - [v0.0.8](v0.0.8/SPEC.md): preservação, transações e validação aprofundada.
 - [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/dual-registry/SPEC.md

@@ -0,0 +1,43 @@
+---
+description: Mesma versão pública no npm e GitHub Packages e limpeza do histórico falho.
+status: aprovado
+---
+
+# Publicação sincronizada
+
+## Objetivo
+
+Remover as execuções antigas com erro, preservando execuções aprovadas e
+releases publicadas. Publicar o mesmo AgentDevKit no npm e GitHub Packages,
+sem mudar o número ou o conteúdo de uma versão já publicada.
+
+## Contrato
+
+- Excluir somente execuções concluídas com falha confirmada.
+- Preservar tags, releases, assets e execuções aprovadas.
+- Usar o TGZ original aprovado pelo CI nos dois registries.
+- Manter `npx` pelo npm público sem autenticação como opção padrão.
+- Autenticar o GitHub com token próprio, sem compartilhar credenciais.
+- Confirmar visibilidade pública, versão e integridade nos dois destinos.
+- Publicar ambos nas próximas tags; permitir completar só um destino.
+- Recusar uma versão existente com bytes diferentes; nunca reempacotar a tag.
+
+## Critérios de aceite
+
+| ID | Prova |
+| --- | --- |
+| AC-001 | Execuções falhas removidas; aprovadas e releases preservadas. |
+| AC-002 | Mesma versão e mesmo checksum nos dois registries. |
+| AC-003 | GitHub público e associado ao repositório correto. |
+| AC-004 | Tokens isolados e acesso anônimo ao npm preservado. |
+| AC-005 | Automação publica ambos e permite retomar um destino. |
+| AC-006 | Testes e revisão aprovados; consumo dos dois destinos verificado. |
+
+## Validação
+
+Comparar inventários remotos antes/depois da limpeza. Testar perfis de registry,
+erros de autenticação, integridade divergente, repetição e seleção do workflow.
+Completar a versão `0.0.9` no GitHub com seu artefato original, comparar os
+registries e provar instalação, diagnóstico e sincronização.
+
+Provas ficam em `tmp/` ou `.agent-tests/`, ignoradas pelo Git.

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/docs/specs/v0.0.10/README.md

@@ -0,0 +1,9 @@
+---
+description: Distribuição pelos dois registries e preparo dos pré-requisitos.
+---
+
+# Versão 0.0.10
+
+[Spec](SPEC.md): publicar e verificar os dois caminhos de instalação.
+
+[Specs](../README.md) · [Changelog](../../../CHANGELOG.md)

package/docs/specs/v0.0.10/SPEC.md

@@ -0,0 +1,42 @@
+---
+description: Publicação da documentação de instalação e da distribuição nos dois registries.
+status: aprovado
+version: 0.0.10
+---
+
+# Publicar e verificar os dois caminhos de instalação
+
+## Objetivo
+
+Publicar a versão 0.0.10 com os guias de pré-requisitos e instalação já
+aprovados. Disponibilizar os mesmos bytes no npm e GitHub Packages e provar
+o consumo da versão publicada nos dois destinos.
+
+## Contrato
+
+- Manter npm público sem login e GitHub Packages com autenticação própria.
+- Usar somente o artefato aprovado pelo CI do commit da tag.
+- Conferir versão, integridade, visibilidade pública e associação ao repositório.
+- Incluir os dois comandos de instalação no README, guias e notas da release.
+- Preservar versões anteriores, arquivos humanos e configurações existentes.
+- Guardar downloads e evidências em diretórios ignorados.
+
+## Critérios de aceite
+
+| ID | Resultado observável |
+| --- | --- |
+| AC-001 | Versão, lockfile, changelog, guias e notas coerentes com 0.0.10. |
+| AC-002 | CI aprovado nos quatro perfis e tag no commit verificado. |
+| AC-003 | Versão 0.0.10 pública nos dois registries, com bytes iguais ao CI. |
+| AC-004 | Versão, init, doctor e sync --check passam nos dois registries. |
+| AC-005 | Licença e guias incluídos, sem artefatos locais ou credenciais. |
+
+## Validação
+
+Testar geração das notas e distribuição local. Após o CI, publicar a tag,
+baixar o artefato original e comparar os checksums da release e dos registries.
+Usar caches e projetos novos: npm sem credenciais; GitHub com token exclusivo.
+Conferir `latest`, README público, licença e os quatro comandos da CLI.
+
+Os instaladores nativos dos sistemas são documentados com fontes oficiais;
+esta release não afirma reinstalá-los em máquinas que já têm os pré-requisitos.

package/package.json

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