Produto / Governança
Estrutura que continua verdadeira depois de aplicada
Governança é o que acontece entre uma aplicação e outra: conferir o workspace contra a declaração, apontar onde os dois divergiram e reparar apenas o que o Orvienm governa.
Política estrutural
Uma especificação é uma política, não uma instrução única. Ela declara a estrutura que um workspace deve ter, e continua declarando isso depois que o primeiro apply termina.
É isso que torna a estrutura verificável. Um workspace corresponde à sua declaração ou não corresponde, e a diferença pode ser produzida sob demanda, em vez de descoberta quando algo quebra.
Verify
O verify compara o estado do workspace com a estrutura esperada. Ele lê a especificação, percorre os caminhos que ela declara e reporta cada um como presente, ausente ou presente mas não declarado. Ele não altera nada.
O que a verificação reporta
- Presente
- Declarado e encontrado no workspace.
- Ausente
- Declarado, mas não encontrado no workspace.
- Não declarado
- Encontrado no workspace, mas fora da especificação.
Um workspace convergiu quando a verificação não reporta nenhuma diferença. Convergência é um estado que se pode conferir, não uma promessa feita no momento do apply.
Desvio
Desvio é o que a verificação encontra quando a realidade se afastou da declaração. Um diretório renomeado à mão, um ambiente montado a partir de um modelo desatualizado, uma migração pela metade.
Detectar não é corrigir.
O Orvienm relata o desvio e para por aí. Ele não decide por você que uma diferença deve ser resolvida, nem em que direção. Decidir o que uma divergência significa é a parte que exige uma pessoa ou uma política explícita, e esconder isso dentro de uma correção automática eliminaria justamente o sinal que a governança existe para produzir.
Reparo conservador
Quando você de fato pede ao Orvienm que feche uma lacuna, o reparo é conservador.
- Cria o que está faltando
- Caminhos que a especificação declara e que o workspace não tem são criados.
- Preserva o que não governa
- Caminhos presentes no workspace mas ausentes da especificação permanecem exatamente como estão.
- Nada é removido implicitamente
- Não ter sido declarado não é motivo para exclusão. Não existe passe de limpeza automática.
A assimetria é proposital. Criar um diretório que faltava é reversível; remover um diretório do qual outra pessoa dependia não é.
Proveniência e rastreabilidade
A estrutura carrega uma identidade determinística, de modo que um workspace materializado pode ser ligado de volta à especificação e ao estado que o produziram. Duas execuções que produzem a mesma estrutura produzem a mesma identidade; uma mudança na estrutura a altera.
O mesmo princípio se estende ao Content Layer e ao Ask fundamentado — capacidades em Alpha do Orvienm Studio, e não do engine de linha de comando: o conteúdo pode ser escaneado em unidades determinísticas que carregam proveniência, e o Ask responde a partir dessas unidades citadas ou se recusa a responder quando não tem o que citar — uma resposta que falha fechada em vez de uma resposta plausível.
O que fica registrado
O engine de linha de comando registra uma única coisa: o fingerprint da especificação a partir da qual o workspace foi construído, gravado em um lock file no primeiro apply que cria uma estrutura. Esse único registro é o que torna o desvio detectável — uma especificação alterada deixa de corresponder àquilo de que o workspace foi construído.
Deliberadamente, não é um log de execuções. O engine não mantém repositório de snapshots nem histórico de execução; histórico execução a execução é uma capacidade do Orvienm Studio, não da CLI. O que o lock file contém e como o desvio é avaliado estão documentados na Referência da especificação.