// Your Verifiable Agentic Foundation

# UORust

UORust reads any Cargo workspace and writes a full Prism model of it, with every facet.

Every kind of Rust fact becomes exactly one kind of Prism record, or is refused. Twenty-eight routes cover crates, dependencies, public functions, tests, error and state enums, unsafe code, file, network, process and environment use, lock-file packages, lints and benchmarks. Two kinds that name different routes are refused as ambiguous, never resolved by a default.

Try the route tableLearn UORustSourceReleases
What a rust developer does with UORust. The tasks of the first user group's goal, in order. Each one is a feature of UORust with acceptance tests.The data in this figure
| Step | What happens |
| --- | --- |
| 1. Project workspace | Write the projection of a workspace into a directory. |
| 2. Checked output | The gate checks the committed fixture projection and a fresh projection of this workspace with lexlean and prismpm |
| --- | --- |
| 3. Deterministic output | Two projections of the same workspace are byte-identical, for the fixture and for this workspace |
| 4. Check projection | Check that a directory holds exactly the projection of a workspace. |

// Context of use · ISO 9241-11

## Who it is for

Every user group of UORust, the goal each one comes for, and the tasks that get it done, in order. Each task is a feature with acceptance tests. The guides below speak for each group.

- KaiRust developerA working Prism model of my own Cargo workspace, without writing it by hand.
- IrisPrism modelerTo see how a complete model is laid out, one record kind at a time.
- VeraSecurity reviewerEvidence that what the model claims about threats and controls is true.
- WrenDevRel authorTo know which records no page teaches yet, and who each page is for.
- OttoMaintainerEverything kept in step when the subject changes, with no generated page edited by hand.
- Rust developerCheck that a directory holds exactly the projection of a workspace.Owns a Cargo workspace and runs uorust to get a Prism model of it without writing the model by hand.1. Project workspace
- 2. Checked output
- 3. Deterministic output
- 4. Check projection
- Prism modelerThe gate checks the committed fixture projection and a fresh projection of this workspace with lexlean and prismpmReads, checks and extends the Prism project uorust emits, and relies on every record tracing to a source span.1. Route facts
- 2. Refuse ambiguity
- 3. Lift behavior
- 4. Checked output
- Security reviewerEvery way a run can end without a projection is a typed UorustError variant with a negative testReviews the threat model uorust derives from unsafe code, effects and the supply chain, and the controls that answer it.1. Project workspace
- 2. Refuse ambiguity
- 3. Typed errors
- DevRel authorUORust is modeled in every facet, each with records, and every module title has a project-local glossary entryWrites the walkthroughs and explorers that teach UORust, and covers every facet record with a resource.1. Browser routes
- 2. Route facts
- 3. Self model
- MaintainerCheck that a directory holds exactly the projection of a workspace.Changes the route table, the engine and this model, and keeps the Rust router, the verified table and the Pages site in step.1. Self model
- 2. Route facts
- 3. Deterministic output
- 4. Check projection

// Command line

## Run it

What UORust&#x27;s command line answers, read from the features that call it.

- uorust project WORKSPACE --out OUTWrite the projection of a workspace into a directory.
- uorust check WORKSPACE --out OUTCheck that a directory holds exactly the projection of a workspace.
- uorust routesThe route table and the router: which kind of Rust fact becomes which kind of Prism record in which facet.

// Architecture · ISO/IEC/IEEE 42010

## How it works

The components of UORust and the systems it works with.

How the parts of UORust connect. Each box is a component, coloured by its kind. Each arrow is an edge of the architecture: data or control moving from one part to another.The data in this figure
| From | Link | To |
| --- | --- | --- |
| Subject workspace | → | Ingest |
| Cargo | → | Ingest |
| --- | --- | --- |
| Subject workspace | → | Cargo |
| crates.io | → | Cargo |
| --- | --- | --- |
| uorust CLI | → | Ingest |
| Ingest | → | Router |
| --- | --- | --- |
| Router | → | Admission |
| Admission | → | Emitter |
| --- | --- | --- |
| Emitter | → | uorust CLI |
| Emitter | → | PrismPM SDK |
| --- | --- | --- |
| rustc toolchain | → | uorust CLI |
| crates.io | → | uorust CLI |
| --- | --- | --- |
| Router | → | Route-table guest |
| Route CLI adapter | → | Route-table guest |
| --- | --- | --- |
| Route-table guest | → | Route CLI adapter |
| Pages site | → | Route-table guest |
| --- | --- | --- |
| Route-table guest | → | Pages site |
| PrismPM SDK | → | Route-table guest |
| --- | --- | --- |
| GitHub Actions | → | Pages site |
| GitHub Actions | → | uorust CLI |
| --- | --- | --- |
| Component | Kind | What it does |
| uorust CLI | Release binary | Project any Cargo workspace into a complete, checked Prism project. |
| --- | --- | --- |
| Ingest | Service | Ingest: cargo metadata, the manifests, Cargo.lock and every source file, parsed with syn, into facts with spans. |
| Router | Service | The route table and the router: which kind of Rust fact becomes which kind of Prism record in which facet. |
| --- | --- | --- |
| Admission | Service | Admission: what the router proposes is admitted, or refused with a typed reason that becomes an open claim. |
| Emitter | Service | Projection: admitted facts to the files of a Prism project, byte for byte the same for the same workspace. |
| --- | --- | --- |
| Route-table guest | Service | The Core-Wasm guest compiled from app/src/Routes.lex.tex: the verified route table, replayed against every acceptance vector. |
| Route CLI adapter | Cli adapter | The generated uorust-routes program that answers the same route requests as the page from a file or standard input. |
| --- | --- | --- |
| Pages site | Static site | The GitHub Pages site that describes UORust and runs the route-table guest in the browser. |
| Subject workspace | External system | The Cargo workspace uorust reads: manifests, lock file and Rust sources. |
| --- | --- | --- |
| Cargo | External system | The cargo metadata command that resolves the subject workspace&#x27;s packages, targets and dependencies. |
| crates.io | External system | The registry the locked dependencies of uorust and of the subject come from. |
| --- | --- | --- |
| rustc toolchain | External system | The pinned Rust toolchain that compiles uorust with forbid(unsafe_code) and the workspace lints. |
| PrismPM SDK | External system | The locked PrismPM and LexLean SDK that checks the emitted project and verifies this model. |
| --- | --- | --- |
| GitHub Actions | External system | The CI that runs just vv on every push and deploys the Pages site. |

// Security · ISO/IEC 27034 and 27005

## How it is kept safe

11 threats and the 13 controls that answer them. The threat model maps every threat to a control with evidence.

| Threats the model names | Controls that answer them |
| --- | --- |
| Build script executionSource exfiltrationCrafted source exhaustionMisrouted factDisputed projectionDependency compromiseUnsafe memoryPath escapeWorkflow token abuseTampered pagesPages host substitution | No build executionOfflineBounded ingestVerified route tableRouter conformanceTyped refusalDeterministic outputCargo denyLocked buildForbid unsafeConfined outputPinned workflowsArtifact closure |

// Quality · ISO/IEC 25010

## How it is measured

Each quality measure and the bound it must stay within.

| Measure | Bound |
| --- | --- |
| Routed fact kinds | 29 |
| Route vectors | 41 |
| --- | --- |
| Self model drift | 0 |
| Rerun differing bytes | 0 |
| --- | --- |
| Self projection milliseconds | 16258 |
| Route request bytes | 330 |
| --- | --- |
| Unregistered tests | 0 |
| Clippy warnings | 0 |
| --- | --- |
| Minimum rust minor | 89 |
| Route cli needed libraries | 0 |
| --- | --- |
| Unsafe blocks | 0 |
| Unlifted functions | 0 |

// Brand · Wheeler, W3C design tokens, WCAG 2.2

## The brand it carries

Read from UOR Foundation at the commit brand/foundation.lock pins. Every text colour meets its WCAG 2.2 contrast criterion, a theorem the Lean kernel checks.

| Element | Text |
| --- | --- |
| Name | UOR Foundation |
| Tagline | Your Verifiable Agentic Foundation |
| --- | --- |
| Promise | Build, ship and run self-verifying AI applications that just work. From edge to cloud, and beyond. |
| Positioning | Prism is an open SDK that seamlessly enables you to build, ship and run self-verifying AI applications. From edge to cloud, and beyond. |
| --- | --- |
| Mission | Universal Object Reference (UOR) is an open standard for content–addressed decentralized identity of digital objects. Based on formal verification. |
| Value | Open by default |
| --- | --- |
| Value | Identity from content |
| Value | No central authority |
| --- | --- |
| Steward | Stewarded by an independent 501(c)(3). |
| Call to action | npx prism-code@latest setup |
| --- | --- |
| Typography | Space Grotesk, system-ui, sans-serif; JetBrains Mono, ui-monospace, monospace |
| Product name | UORust |
| --- | --- |
| Product promise | Every kind of Rust fact becomes exactly one kind of Prism record, or is refused. |
- --fd-bg#0a0a0a
- --fd-panel#121212
- --fd-fg#fafafa
- --fd-dim#999999
- --fd-line#333333
- --fd-line-strong#616161
- --fd-accent#fafafa
| Text | On | Contrast | WCAG 2.2 needs |
| --- | --- | --- | --- |
| --fd-accent | --fd-bg | 18.97:1 | 4.5:1 |
| --fd-accent | --fd-panel | 17.95:1 | 4.5:1 |
| --- | --- | --- | --- |
| --fd-bg | --fd-accent | 13.62:1 | 4.5:1 |
| --fd-bg | --fd-fg | 18.97:1 | 4.5:1 |
| --- | --- | --- | --- |
| --fd-dim | --fd-bg | 6.95:1 | 4.5:1 |
| --fd-dim | --fd-fg | 6.04:1 | 4.5:1 |
| --- | --- | --- | --- |
| --fd-dim | --fd-panel | 6.58:1 | 4.5:1 |
| --fd-fg | --fd-bg | 18.97:1 | 3:1 |
| --- | --- | --- | --- |
| --fd-fg | --fd-bg | 18.97:1 | 4.5:1 |
| --fd-fg | --fd-line | 15.79:1 | 4.5:1 |
| --- | --- | --- | --- |
| --fd-fg | --fd-panel | 17.95:1 | 3:1 |
| --fd-fg | --fd-panel | 17.95:1 | 4.5:1 |
