Curso / Aula 2 de 6
14 min · caso real sanitizado
Cobertura antes de interpretação
Objetivo: Fechar um inventário em que todo item tem estado final, o manifest é congelado e qualquer movimento do corpus vivo vira exceção nomeada — nunca ajuste silencioso.
Primeiro, em linguagem simples
Interpretar antes de inventariar é resumir um livro pelo índice: você explica brilhantemente os capítulos que viu e inventa os que não viu. A ordem honesta é: conte tudo primeiro — cada item ganha um registro com estado final — e só então interprete.
Um inventário só fecha com zero pendências. Se algo não pôde ser processado, ele não desaparece: vira uma exceção nomeada, com dono e motivo. Ausência nunca é sucesso.
Abra a camada técnica
O inventário é construído sobre um manifest congelado: a enumeração do filesystem é feita uma vez, com hash, e toda contagem posterior se refere àquele snapshot. Corpus vivo não espera a boa vontade do auditor — ele se move durante o trabalho.
Caso real: o pacote-semente mudou de categoria no meio do inventário (de x-bookmarks para ai-models). A tentação é “ajustar o manifest e seguir”. A regra é o oposto: congelar, nomear o drift e reconciliar — o item movido aparece no ledger como drift nominal, comprovado fisicamente na auditoria final.
Projeção de status determinística na missão real: 2.830 registros processados + 24 exceções nomeadas; o checker independente só fecha com 0 itens sem estado final ou listando nominalmente cada exceção.
Por que “ajuste silencioso” é a pior opção
Quando o auditor corrige quieto uma divergência — um item que mudou de lugar, uma contagem que não bate — ele apaga a evidência de que o corpus é vivo. A próxima contagem diverge de novo, e ninguém sabe qual das duas é real.
Nomear o drift preserva as duas verdades: o estado no congelamento e o estado na reconciliação. É mais barato do que a ambiguidade.
A regra do zero pendente
Dê um estado final a cada item do lote. O inventário só fecha quando nenhum item estiver pendente.
Drift detectado: durante o inventário, o pacote-semente moveu-se da categoria x-bookmarks para ai-models. Como registrar?