About
Structure deserves the same rigour as code
Orvienm exists because structure is everywhere in software and almost nowhere under control. It is an early-stage project building the deterministic, governable model that structure has been missing.
What Orvienm is
Orvienm turns structure into something declared rather than assembled. A specification states the structure a system should have; the engine validates it, plans the changes needed to reach it, applies them, and verifies the result against what was declared.
Hyper Reality Semantic as Code names the wider ambition: representing meaningful aspects of reality through code. Declared structure is where that begins — the same specification can be checked before a run, compared against a workspace to produce a plan, and compared again afterwards to verify the result.
The current Alpha keeps that surface deliberately small — a structure name and the directories beneath it. Richer relational semantics are a direction, not a shipped capability.
Why determinism and governance
Systems grow faster than the clarity of their structure. Directories accumulate, environments diverge quietly, and what started simple becomes something no one can describe with confidence. The cost is not felt at the moment structure drifts; it is felt later, when a change turns out to be risky for reasons nobody can name.
Determinism makes structure predictable: the same input produces the same result, so a workspace can be reproduced rather than reconstructed. Governance makes it durable: a system can be asked whether it still matches its declaration, and answer.
Together they move structure from something maintained by attention to something maintained by definition.
Principles
- Define structure as code
- Structure that lives in a file can be reviewed, versioned and checked. Structure that lives in a convention cannot.
- Validate before execution
- Problems that can be found by reading a specification should be found before anything touches a filesystem.
- Plan before applying
- The changes a run will make are shown first. Nothing arrives that was not described.
- Execute deterministically
- The same specification against the same state produces the same result, wherever it runs.
- Govern every change
- Applying once is not enough. A system should be able to say whether it still has the structure it declared.
Current status
Orvienm is in Alpha and under active development. The CLI is installed from source by people who have access to it; there is no package index entry and no binary release.
The documentation reflects that stage — it covers what can be read and used today, and says so where something is not yet documented.