[P1] Preparar a release 0.8.0 e ampliar a engenharia de qualidade #27

Objetivo

Preparar, congelar e validar a release 0.8.0 do IQCC para submissão ao CRAN, sem introduzir nova metodologia durante o gate final.

A versão 0.8.0 é apropriada porque o pacote ganhou novas APIs públicas, novas famílias metodológicas, vignettes executáveis, site pkgdown e mudanças estruturais relevantes.

Esta issue é exclusivamente um gate de release. Correções estatísticas, novas funções e validações científicas devem ser concluídas nas issues próprias antes de entrar aqui.

Bloqueadores atuais

Não iniciar o PR final da release antes de:

• [P1][FIX] Corrigir o mapeamento e o estudo numérico da robustez assintótica de Hotelling T² #83 concluída — correção do estudo de robustez assintótica de Hotelling T²;
• [P0][VALIDATION] Consolidar fixtures publicados do gráfico p (normal, CF1 e CF2) #86 concluída — validação científica do gráfico p;
• [P1][VALIDATION] Completar a validação publicada do gráfico R: risco, ARL, d2 e d3 #87 concluída — validação científica do gráfico R;
• [P0][VALIDATION] Ampliar a reprodução publicada e os oráculos independentes do DS-np #88 concluída — validação científica DS-np;
• [P0][VALIDATION] Consolidar a derivação e a validação científica do gráfico u #89 concluída — validação científica do gráfico u;
• [P1][VALIDATION] Completar a validação publicada do gráfico de variância generalizada |S| #90 concluída — validação científica da variância generalizada;
• [P1][DOC] Criar vignette consolidada de validação científica do IQCC #91 concluída — vignette consolidada de validação;
• [P1][ARCH] Extrair funções numéricas puras para os limites do gráfico S #94 concluída, ou retirada do escopo da 0.8.0 por decisão explícita — funções puras do gráfico S;
• todos os workflows verdes em master.

As issues #9 e #70 são pós-release e não bloqueiam a 0.8.0.

Fase A — preparação de metadados

Executar em PR próprio depois dos bloqueadores:

• definir Version: 0.8.0 em DESCRIPTION;
• conferir Authors@R, papéis, nomes e contatos;
• conferir licença, URLs, BugReports e versão mínima de R;
• reorganizar NEWS.md em seção objetiva para 0.8.0;
• adicionar ou revisar inst/CITATION com referência do pacote e referências metodológicas apropriadas;
• atualizar README e site somente quanto a versão, escopo efetivamente entregue e migração;
• criar/revisar cran-comments.md;
• remover artefatos acidentais de testes, builds e plots.

Não incluir implementação metodológica neste PR.

Fase B — compatibilidade e checks

• executar devtools::document() e confirmar ausência de deltas inesperados;
• executar testes, examples e vignettes;
• executar R CMD check --as-cran;
• verificar R release, devel e oldrel em Linux;
• verificar Windows e macOS;
• confirmar cache e estabilidade da matriz de CI existente;
• executar check de URLs, spelling, documentation-quality e pkgdown;
• confirmar que aliases e chamadas históricas relevantes continuam funcionando;
• revisar mensagens, warnings e depreciações;
• executar revdepcheck para dependentes conhecidos, quando aplicável;
• verificar que o site publicado corresponde ao commit da release.

Fase C — empacotamento e submissão

• gerar o tarball final a partir de commit limpo e identificado;
• executar win-builder ou serviço equivalente;
• registrar resultados externos em cran-comments.md;
• conferir tamanho do pacote, tempos de exemplos/testes e arquivos instalados;
• criar tag/release somente após aprovação dos checks;
• submeter ao CRAN;
• tratar eventuais comentários do CRAN em issue e PR separados.

Decisões que não pertencem ao DeepSeek

O DeepSeek pode:

• atualizar metadados a partir de instruções fechadas;
• reorganizar NEWS;
• preparar CITATION e cran-comments para revisão;
• executar checks e diagnosticar falhas mecânicas;
• corrigir problemas portáveis de CI e documentação.

Exigem revisão/decisão humana ou de modelo forte:

• interpretação de NOTE/WARNING do CRAN;
• decisão de aceitar ou retirar funcionalidade da release;
• redação final de alegações científicas;
• decisão sobre compatibilidade/depreciação;
• submissão e resposta oficial ao CRAN.

Nenhum agente deve fazer merge, tag ou submissão automaticamente.

Critérios de aceite

• todos os bloqueadores científicos e arquiteturais resolvidos;
• DESCRIPTION, NEWS, README, site e inst/CITATION coerentes com 0.8.0;
• R CMD check --as-cran sem ERROR e sem WARNING não explicado;
• matriz multiplataforma verde;
• pkgdown e vignettes publicados corretamente;
• validações científicas críticas integradas;
• revdepcheck sem regressão conhecida não documentada;
• cran-comments.md pronto e verificável;
• tarball final reproduzível a partir do commit/tag da release.

Relações

• [EPIC/P0] Criar camada de funções puras para limites, risco, ARL e tamanho amostral #6/[P1][ARCH] Extrair funções numéricas puras para os limites do gráfico S #94 — arquitetura restante;
• [EPIC/P0] Criar suíte de validação numérica contra os artigos-base do IQCC #10/[P0][VALIDATION] Consolidar fixtures publicados do gráfico p (normal, CF1 e CF2) #86-[P1][DOC] Criar vignette consolidada de validação científica do IQCC #91 — validação científica;
• [EPIC/P1] Documentação, vignettes e posicionamento do IQCC #11 — documentação;
• [ROADMAP] Revitalização científica e release 0.8.0 do IQCC #13 — roadmap mestre;
• [ROADMAP] Expandir a documentação do IQCC para futura publicação na JSS #50 — trabalho pós-release/JSS.