Skip to content

feat(pilot): prepare DL-001 agent trial and strengthen static QA - #35

Merged
Hugo-JC merged 50 commits into
mainfrom
feat/dl001-pilot-and-design-qa-v2
Nov 12, 2026
Merged

Hugo-JC merged 50 commits into
mainfrom
feat/dl001-pilot-and-design-qa-v2

Conversation

@Hugo-JC

@Hugo-JC Hugo-JC commented Nov 12, 2026 •

Copy link
Copy Markdown
Owner

Objetivo

Preparar o primeiro teste real do Integra e corrigir uma lacuna de confiança na camada de QA. Esta branch parte do main atualizado em 12/11/2026 e não altera main.

O que foi implementado

1. DL-001 First Agent Pilot Pack

  • Novo comando npm run pilot:prepare.
  • Gera 10 ficheiros em .integra/runs/pilots/DL-001/: brief JSON/Markdown, prompt idêntico para ambas as condições, Direction Artifact 1.1.0, Visual Intelligence Bundle 1.1.0, contrato/instruções do agente, acceptance criteria e manifest com SHA-256.
  • Protocolo paired baseline vs Integra-guided em workspaces limpos, mantendo variáveis controladas.
  • Protege inputs e mantém outputs dentro de .integra/runs/.
  • O comando prepara o piloto; não executa o agente nem browser automation.

2. Direction Consumption Report Validator

  • Novo comando npm run direction:consumption:validate -- --artifact ... --report ....
  • Valida schema, correspondência do artifactId, IDs duplicados/desconhecidos e cobertura exata de todas as decisões e recomendações.
  • Um relatório válido continua a ser autorrelato, não prova independente da implementação.

3. Design QA estático v1

  • design:qa emite JSON 1.0.0 com severidade P1–P3, confiança, localização, excerpto, critério e limitações.
  • Analisa TSX/JSX e CSS: alt de imagens, nomes acessíveis quando determináveis, labels, semântica teclado, foco, reduced motion, cores utilitárias hardcoded e diagnostics de sintaxe.
  • Expressões dinâmicas desconhecidas não são automaticamente tratadas como nomes ausentes.
  • --strict termina com código 2 perante sinais P1.
  • Todos os findings são heuristic; o relatório lista verificações que não executa. Não é browser QA nem certificação WCAG.

4. Contexto de produto e preservação de identidade

  • Contrato para PRODUCT.md, DESIGN.md e brief por superfície, além de templates reutilizáveis.
  • Refinement preserva a identidade existente por defeito; uma mudança de mundo visual exige pedido ou aprovação explícita.
  • Skills de orquestração, direção e QA e o exemplo de agente foram alinhados.

5. Consistência da distribuição npm

  • O manifesto bundle.json agora lê a versão de packages/cli/package.json, em vez de manter um número hardcoded.
  • Teste de distribuição confirma que a versão embutida acompanha a versão do pacote.

6. Referência ao Impeccable

Inspecionei o ZIP fornecido e adaptei estratégias de documentação de produto/sistema visual, workflow de refinamento, QA com confidence/evidence ledger e avaliação baseline/guided. Não importei CLI, runtime browser, binários ou dependências do Impeccable; esta branch não introduz código copiado do seu motor.

Testes e verificação CI

CI 7/7 verde no HEAD 693bf617a1237d40c631b978695d4a1ea520d624:

  • Typecheck, testes e fixtures: success.
  • CLI distribution: Node 20 e 24 × Ubuntu, Windows e macOS: 6/6 success.
  • Vitest: 40 test files, 213 tests passed.
  • Validação de 16 Agent Skills.
  • Validação dos 9 context profiles, 15 reference IDs e visual library (72 sources, 10 asset providers, 61 niche mappings, 8 token recipes, 20 layout patterns, 32 rules, 21 anti-patterns, 7 examples e 2 observations).
  • 23 comandos validados.
  • Smoke test do pacote CLI e validação de distribuição passaram.

Limites assumidos

  • A execução do agente continua manual.
  • A verificação independente exige browser/screenshots, keyboard e testes do projeto gerado.
  • O static audit não inspeciona DOM renderizado, screen readers, contraste compositado, interações runtime ou performance medida.
  • O primeiro piloto cobre apenas DL-001.
  • A atualização npm é um release separado; os comandos repository-only pilot:prepare e design:qa não fazem parte do pacote instalador integra-cli.

Estado

  • Base: main em 130dd75dce71ff0ab6da939dfd91294bd80ff895.
  • HEAD: 693bf617a1237d40c631b978695d4a1ea520d624.
  • 28 ficheiros alterados.
  • PR não faz merge automaticamente; main permanece intacto.

Sugestão de integração: Squash and merge, para evitar trazer os commits pequenos para o histórico principal.

@Hugo-JC
Hugo-JC marked this pull request as ready for review November 12, 2026 07:10
@Hugo-JC
Hugo-JC merged commit e8ab0ae into main Nov 12, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant