Sobre
Estrutura merece o mesmo rigor que código
O Orvienm existe porque estrutura está em todo lugar no software e quase em lugar nenhum sob controle. É um projeto em estágio inicial construindo o modelo determinístico e governável que faltava à estrutura.
O que é o Orvienm
O Orvienm transforma estrutura em algo declarado, e não montado. Uma especificação declara a estrutura que um sistema deve ter; o engine a valida, planeja as mudanças necessárias para alcançá-la, aplica-as e confere o resultado contra o que foi declarado.
Hyper Reality Semantic as Code nomeia a ambição mais ampla: representar aspectos significativos da realidade por meio de código. A estrutura declarada é onde isso começa — a mesma especificação pode ser verificada antes de uma execução, comparada com um workspace para produzir um plano e comparada de novo depois para conferir o resultado.
O Alpha atual mantém essa superfície deliberadamente pequena — um nome de estrutura e os diretórios sob ele. Semântica relacional mais rica é uma direção, não uma capacidade entregue.
Por que determinismo e governança
Os sistemas crescem mais rápido do que a clareza da sua estrutura. Diretórios se acumulam, ambientes divergem silenciosamente, e o que começou simples vira algo que ninguém consegue descrever com confiança. O custo não aparece no momento em que a estrutura se desvia; aparece depois, quando uma mudança se revela arriscada por motivos que ninguém sabe nomear.
O determinismo torna a estrutura previsível: a mesma entrada produz o mesmo resultado, então um workspace pode ser reproduzido em vez de reconstruído. A governança a torna durável: dá para perguntar a um sistema se ele ainda corresponde à sua declaração — e obter resposta.
Juntos, eles tiram a estrutura do campo do que se mantém por atenção e a colocam no campo do que se mantém por definição.
Princípios
- Definir estrutura como código
- Estrutura que vive em um arquivo pode ser revisada, versionada e verificada. Estrutura que vive em uma convenção, não.
- Validar antes de executar
- Problemas que podem ser encontrados lendo uma especificação devem ser encontrados antes que algo toque o sistema de arquivos.
- Planejar antes de aplicar
- As mudanças que uma execução fará são mostradas antes. Nada chega sem ter sido descrito.
- Executar de forma determinística
- A mesma especificação sobre o mesmo estado produz o mesmo resultado, onde quer que rode.
- Governar cada mudança
- Aplicar uma vez não basta. Um sistema deve conseguir dizer se ainda tem a estrutura que declarou.
Status atual
O Orvienm está em Alpha e em desenvolvimento ativo. A CLI é instalada a partir do código-fonte por quem tem acesso a ele; não há entrada em índice de pacotes nem release binário.
A documentação reflete esse estágio — cobre o que pode ser lido e usado hoje, e diz quando algo ainda não está documentado.