← All Specifications

UIX

A constitutional doctrine of experience: how intelligence, humans, systems, and reality interact under constitutional principles — the layer where constitutional intelligence becomes perceivable, usable, and governable.

Doctrine 6 Invariants 86 Lines Doctrine

Universal Constitutional Experience System — UIX v0.1.1

A constitutional doctrine of experience: how intelligence, humans, systems, and reality interact under constitutional principles — the layer where constitutional intelligence becomes perceivable, usable, and governable.

Part I — Specification

1. Position in the constitutional chain

Reality
  → USCP (six primitives — what must always be true)
  → USC / URS (representation)
  → USE (Universal Selection Engine — verify → select → execute)
  → UIX (this layer — where constitutional intelligence becomes
     perceivable, usable, and governable)
  → Applications

UIX sits below USE and above Applications: every experience is the result of a selection (USE-2: selection precedes execution). UIX is not a component library, a design system, or a framework — it is the constitutional experience layer. Motion, analytics, dashboards, spatial and multimodal interfaces are capabilities, never the identity.

2. Strategic principle

**How should intelligence, humans, systems, and reality interact under constitutional principles?**

3. Layer architecture

LayerRoleTechnology
**Selection**USE — verified options, declared preference, recorded selectionUSE log · USE-1..6
**Truth**Constitutional models, verification, identity, invariantsRust → WASM
**Performance**Rendering, layout, graphics, animation, computationZig → WASM (on demand)
**Experience**Browser integration, PWA lifecycle, adapters, interactionJavaScript (orchestrates, never owns logic)

Technologies serve the architecture; all three implementation layers are replaceable below the invariant layer (UAM doctrine: capabilities are adapters, never core dependencies).

4. Invariants

5. LD-family fit (how the Linked Data family composes with UIX)

LD documentRole in UIXEvidence in the layer
**CORE-LD**Semantic representation basis — every `SemanticIntent` and node payload is CORE-LD-shapedExperience nodes serialize to JSON/CBOR-LD; bridge uses JSON bridge until CBOR-LD lands
**TRUST-LD**Identity + provenance of experience sources — trust seals attest who/what produced an experience`TrustSeal::new(node_id, rules, nonce)` — content-addressed proof of governance provenance
**POLICY-LD**Governance — which experiences may exist, in which modes, under which constraintsUIX-GOV rules, `GovernanceEngine::default_rules()`, `verify_node`/`verify_graph`
**MEMORY-LD**Audit — the USE log and verification history as an append-only constitutional recordUSE log (`useLog`), Lamport-timestamped `ConstitutionalResponse`, seal history

The experience pipeline maps directly onto the family: input → CORE-LD, governance → POLICY-LD, provenance → TRUST-LD, audit → MEMORY-LD, with USE as the selection act between verification and execution.

6. Four-question stress test

QuestionAnswer
What must always be true?Every experience conforms before it renders (UIX-1..5)
What should every conforming system look like?Four-layer architecture: Selection / Truth / Performance / Experience
How do systems interact?Typed boundary: `ExperienceEvent` (observations) → `ConstitutionalCommand` (verified instructions) → `RenderFrame` (feedback loop)
How do we prove conformance?In-browser WASM verification, TrustSeals, USE log, UIX conformance suite

Part II — Doctrine

Selection is the act; experience is the consequence

UIX embodies the USE boundary: certainty above the Selection rung (constitutional rules are fixed, non-negotiable, machine-verified) and adaptability below it (engines, modes, and renderers are replaceable and selected per situation). The USE log makes every choice visible, reversible, and auditable — no hidden fallbacks, no implicit decisions.

Constitutional by design, usable by anyone

UIX never requires the whole of ICore. External platforms may adopt UIX capabilities under a declared interoperability profile; ICore adoption carries the full invariant set. This is the doctrine of superset over replacement applied to experience: a strict constitutional core, tolerant adoption paths, no lock-in.

Freeze gate

UIX remains Doctrine until (1) a UIX conformance suite runs green (native 36+ tests + in-browser WASM verification), and (2) the USE log is demonstrated end-to-end in the CodeLab (verify → select → execute across TRUST-LD → USE → POLICY-LD → MEMORY-LD). Only then does UIX flip to Frozen and enter UCF attestation. The first external adoption may, at that point, register as the first interop-profile case.


UIX v0.1.1 · ICore Constitutional Substrate · CBOR-LD · Ed25519Signature2020 · SHA-256 Content-Addressed TrustSeals · USE-1..6 · UIX-GOV-001–012