TestingQA

TestingQA analisa evidências, gera BDD rastreável, planeja regressão local e organiza conhecimento funcional para Codex, Claude Code e Gemini CLI.

Instalação pelo terminal

Para instalar as skills, abra o terminal na raiz do projeto e execute:

npx @testing-company-qa/testingqa install

Esse comando usa a versão apontada por latest. O comando npm i @testing-company-qa/testingqa destacado pelo site npm baixa o pacote como dependência; sozinho, não instala as skills nos provedores. npx executa o CLI do pacote e install inicia a configuração do TestingQA. No PowerShell, use npx.cmd quando npx.ps1 estiver bloqueado.

Versões e comandos

O canal latest aponta para a release pública atual. Para uma instalação reproduzível, consulte a versão desse canal e use o número exato no lugar de latest nos comandos de instalação e manutenção.

npm view @testing-company-qa/testingqa versions --json
npm view @testing-company-qa/testingqa dist-tags --json
npm view @testing-company-qa/testingqa@latest version

Após a instalação, confira a versão do CLI executado e o estado da instalação na mesma pasta do projeto:

npx @testing-company-qa/testingqa@latest --version
npx @testing-company-qa/testingqa@latest check
npx @testing-company-qa/testingqa@latest doctor

--version mostra a versão do CLI chamado pelo npx; não comprova qual versão está instalada no projeto. Use check e doctor para conferir essa instalação.

Requisitos e escolhas

• Node.js 20 ou superior para instalar; preferir uma linha suportada.
• Cliente de IA instalado e autenticado para usar as skills.
• Python 3.10 ou superior para validadores de artefatos e auxiliares de regressão; não é requisito do instalador Node.js.

O escopo pode ser project ou global. O Knowledge Home é a pasta que armazena os documentos e a base de conhecimento. O instalador oferece: local padrão; diretório informado; reutilização de local anterior válido; opção 4, subpasta <projeto>/qa-knowledge/, que agrupa knowledge-bases/, docs/ e curation-inbox/. O alvo é --project, quando informado, ou o diretório em que o CLI foi iniciado; não há consulta à janela ativa da IDE. Em uma instalação antiga vinculada à raiz do projeto, update apresenta e confirma a migração dos dados para essa subpasta. Raízes externas personalizadas permanecem vinculadas ao local escolhido.

O vínculo fica em <projeto>/.testingqa/config.json no escopo project, ou ~/.testingqa/config.json no global. O Knowledge Home contém knowledge-bases/, docs/ e curation-inbox/. Atualização, reinstalação e desinstalação preservam esses dados. Instalar prepara pastas e vínculo, não cria conhecimento funcional automaticamente.

Para instalar a fonte local, execute na raiz deste repositório:

node installer/bin/testingqa.mjs install --source . --project "CAMINHO_DO_PROJETO"

Guias: instalação rápida, instalação completa e offline Windows. A opção offline exige um ZIP autorizado fornecido separadamente.

Capacidades atuais

• Architect: analisa evidências e contexto canônico seletivo, gera BDD e pacote de atualização; documentação funcional é opcional. Planeja regressão local com proposta aprovada e seleção de casos elegíveis marcados @regressao.
• Curator: consulta conhecimento canônico em somente leitura, preservando escopo e limitações.
• Maintainer: revisa propostas, apresenta prévia e aplica ou descarta conforme confirmações do contrato.

As skills preservam aplicações e responsabilidades. Tags, smoke e prioridades são contextualizados pelo software e pelas evidências; heurísticas não viram regras de negócio. Documentos históricos inventariam cobertura, sem confirmar resultados esperados.

A regressão organiza plano, casos por módulo/jornada, manifesto e aprovação em docs/<application-id>/Regressão/. Diagnóstico e recuperação preservam tentativas interrompidas e bloqueiam atividade incerta ou integridade/propriedade não comprovadas. O fluxo não executa testes da aplicação. Azure/MCP permanecem integração futura.

Estrutura e manutenção

skills/ contém as três skills; contracts/, os contratos; installer/ e distribution/, instalador e adaptadores. runtime-files.txt delimita o pacote offline. Bases e evidências reais do usuário não fazem parte da distribuição.

O pacote npm inclui somente as entradas de runtime declaradas em package.json, além de README e licença. Caches Python, logs, temporários, backups, arquivos .env e pastas de desenvolvimento são excluídos; o mesmo filtro de resíduos se aplica à construção dos provedores e do pacote offline. scripts/release.mjs e installer/offline-bootstrap.mjs permanecem no repositório, mas ficam fora do npm; o bootstrap continua incluído no ZIP offline.

check e doctor são somente leitura. update, reinstall e uninstall atuam nos arquivos gerenciados e preservam dados; conflitos com personalizações interrompem a operação. Fixar a mesma versão/fonte em cada ciclo.

Atualização com migração de dados

Na raiz do projeto, executar npx @testing-company-qa/testingqa@latest update após a publicação da nova versão. Para instalações antigas que usam a raiz como Knowledge Home, a prévia informa origem, destino, pastas e quantidade de arquivos. Após confirmação, o instalador move knowledge-bases/, docs/, curation-inbox/ e .regression-staging/ quando presente para qa-knowledge/, confere caminhos, inventário e SHA-256 e atualiza o vínculo na mesma operação controlada dos arquivos do plugin. Documentos, pacotes, logs e aprovações permanecem com conteúdo idêntico; pastas vazias também são preservadas. Não há fusão, sobrescrita ou exclusão de dados para resolver conflitos.

Destino ocupado, dados alterados depois da prévia, links ou entrega regressiva pendente bloqueiam a migração. Falha capturada restaura arquivos gerenciados, vínculo e pastas originais. Interrupção do processo preserva .testingqa-migration.json e o backup: doctor diagnostica, e uma nova chamada a update apresenta a recuperação antes de tentar novamente. Atividade incerta, alteração posterior ou conflito bloqueiam a retomada sem remover dados.

O arquivo .testingqa-migrations.json no novo Knowledge Home registra os caminhos antigos e atuais. As Skills usam esse mapa somente para localizar referências históricas dentro das pastas movidas, sem reescrever evidências ou recalcular aprovações. reinstall --knowledge-home continua sendo revinculação explícita e não substitui esse fluxo de migração.

Licença

Software proprietário para avaliação e testes internos por pessoas autorizadas. Redistribuição, publicação e uso externo/comercial dependem da autorização prevista em LICENSE.