Skip to content

docs(release): Release Candidate Documentation — Maturity Status, Gated Governance, and Verification Parity - #3

Merged
pedrohpsantos merged 5 commits into
mainfrom
codex/go-phase-01-hardening
Oct 7, 2026
Merged

pedrohpsantos merged 5 commits into
mainfrom
codex/go-phase-01-hardening

Conversation

@pedrohpsantos

@pedrohpsantos pedrohpsantos commented Oct 7, 2026 •

Copy link
Copy Markdown
Member

Pull Request: Documentation (codex/go-phase-01-hardening → main)

Título: docs(release): Release Candidate Documentation — Maturity Status, Gated Governance, and Verification Parity
Base: main
Head: codex/go-phase-01-hardening
Status: PRÉ-RELEASE CANDIDATA (PRERELEASE_CANDIDATE)
PR Pareado de Código: evidencia-grupo/EvidencIA#60


1. Resumo Executivo

Este PR sincroniza a documentação oficial com o estado da base de código do EvidencIA, garantindo rastreabilidade total, eliminação de menções desatualizadas a componentes legados, conformidade com as diretrizes de governança (zero emojis no corpo técnico e ausência de links quebrados) e registro transparente das decisões humanas isoladas.


2. Principais Alterações

  • Matriz de Prontidão Central (RELEASE-READINESS.md): Documento detalhado atestando o estado de Release Candidate com 17 Technical Gates aprovados.
  • Registro de Decisões Humanas (HUMAN-DECISIONS.md): Catalogação formal dos 6 portões exclusivos de julgamento humano (H1 a H6) com recomendações técnicas fundamentadas.
  • Guias de Anotação Manual: Inclusão de EVAL-ANNOTATION-GUIDE.md e evaluation/annotation-guide.md para suportar o protocolo duplo-cego da validação de Information Retrieval.
  • README Atualizado: Declaração explícita do que é Funcional, Parcial e Pendente.
  • Validação Estrita: 100% dos links relativos validados e 0 emojis encontrados nos arquivos de documentação técnica.

3. Lista de Commits

  • 8d517e7: docs(governance): add release readiness and human decisions register
  • 199f938: docs(readiness): synchronize release readiness, evaluation guides and human decisions matrix
  • 2e87a0c: docs(release): update maturity status and synchronized release readiness matrix

4. Evidências de Validação

  • Validação de Links Relativos: 0 links quebrados (docs-links.yml script aprovado).
  • Conformidade Corporativa: 0 emojis encontrados na documentação técnica (ci-docs.yml script aprovado).
  • Drift Check com Código: 0 CRITICAL, 0 HIGH (python scripts/check_drift.py --docs ../documentation).

Ressalva sobre Testes End-to-End (E2E)

Aviso: Testes E2E permanecem com status NOT RUN. Registrado como risco aceito pendente de decisão e validação humana em sessão real de navegador com a extensão empacotada, e não como cobertura equivalente.


5. Bloqueios Humanos Pendentes (Portões H1 a H6)

Este PR não deve ser mergeado até a conclusão e homologação das decisões humanas:

  • H1 — Autenticação e Credenciais: Definição e injeção de segredos no ambiente de produção.
  • H2 — Licenciamento de Datasets: Parecer jurídico sobre redistribuição de corpora acadêmicos de terceiros (Fake.br / Lins-2019).
  • H3 — Anotação Humana de Avaliação: Execução da curadoria e rotulagem humana para medição de Recall@K e MRR.
  • H4 — Privacidade e Termos de Uso: Aprovação jurídica formal da Política de Privacidade sob a LGPD.
  • H5 — Validação com Usuários: Condução do experimento de campo cego com 50+ usuários reais.
  • H6 — Decisão de Publicação: Autorização final de merge em main e publicação da extensão.

6. Referência Cruzada

@pedrohpsantos
pedrohpsantos marked this pull request as ready for review October 7, 2026 23:22
@pedrohpsantos
pedrohpsantos merged commit 3099599 into main Oct 7, 2026
5 checks passed
@pedrohpsantos
pedrohpsantos deleted the codex/go-phase-01-hardening branch October 7, 2026 23:23
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