# Universal Visualization System (UVS) — ICore Sovereign Surfaces

> Status: **v1 (reviewable + refineable)** · Signed artifact (see `UVS-PLAN.proof.json`)
> Scope: Visualization Science + Visual Arts + Inline/Agentic AI Visualization & Animation
> for ICore and its surfaces: `use.initialcore.net`, `uix.initialcore.net`,
> `lifepioneer.initialcore.net`, `lifeagent.initialcore.net`
> Doctrine constraints that bind every pixel: **zero-server**, **no-tabs (vertical only)**,
> **Brave/Shields-ON / no Google CDN·fonts·analytics (C5)**, **content-addressed + Ed25519-attested**,
> **WASM-first inference**, **superset-over-replacement**, **no telemetry**, **self-attesting** (EI-core).

---

## 0. Thesis
The AI is **not a chat panel bolted on** — *the visualization IS the agent's cognition made visible*.
Animation is a first-class constitutional medium: it shows attestation, negotiation, and drift-free
evolution as living structure. Every motion must be sovereign-device-cheap (GPU `transform`/`opacity`),
reduced-motion-native, and (where it defines experience) a signed, content-addressed spec.

## 1. Visualization Science (perception → cognition)
- **Data-ink first (Tufte):** every element earns its pixels; remove chrome, keep signal.
- **Preattentive encoding:** color/size/position for trust state (verified=green pulse, unverified=red, pending=blue) — legible in <200ms, no reading required.
- **Progressive disclosure:** proof summary inline; expand canonical body on demand (EI_CORE.verifyConsole).
- **Reduced-motion as a default right:** animations opt-IN via `prefers-reduced-motion`; sovereignty includes neuro-inclusion. Never forced motion.
- **Dark-surface color science:** high-contrast, no pure-white; proof hues deuteranopia-safe.

## 2. Visual Arts (composition as constitutional voice)
- **Negative space = calm authority.** Generous vertical rhythm; the agent's silence is designed, not empty.
- **System-font typography only** (no Google fonts); weight carries hierarchy, not typefaces.
- **Generative/agentic aesthetics:** the mesh and the proof ARE the art — living, not stock.

## 3. Inline AI / Agentic AI Visualization
- **Proof-as-glyph:** each Ed25519 proof renders as an animated seal that visibly *locks* on verify.
- **Capability constellation:** `meshNodes()` as a living vertical node-graph — nodes breathe when active.
- **Reasoning trace:** perceive→cognize→act→communicate→evolve shown as an inline step-lit flow; each step flashes its signature.
- **Selection/intent flow:** USE interop as animated intent-routing (extends `routing-pill` to show cross-node negotiation USDS⇄Life).
- **Conformance meter:** 29 invariants as a calm bar that *tightens* (never drops) — drift is invisible because impossible.
- **Provenance ribbon:** a permanent thin content-addressed trail under every entity action.

## 4. Animation Grammar (declared, first-class)
- **Entrance:** vertical fade/slide only (no horizontal tabs, ever).
- **State:** proof-verify pulse (`erPulse`), mesh node pulse, routing fade — all `transform`/`opacity`.
- **Ambient:** mesh heartbeat ≤1Hz; CPU-bounded; paused under `reduced-motion` / `visibility:hidden`.
- **Attention:** routing pill, activation glow — ephemeral, never infinite loops.
- **Grammar is declarative + signed:** a viz-spec is a content-addressed artifact; the surface verifies its own animation manifest before playing (closes UI supply-chain drift, mirrors EI-core self-attest).

## 5. Per-surface flagship
| Surface | Visualization flagship |
|---|---|
| **use** | Live ledger diff + proof-verify animation; paste-anchor → inline signature "lock". |
| **uix** | EI disclosure proof-badges that animate-lock on verify; capability constellation preview. |
| **lifepioneer** | **Series fork-tree** — variants branch from a Canon root with a visible *no-drift* anchor line; variant diff viz. |
| **lifeagent** | Live sovereign mesh (EI-core) + reasoning-trace inline + activation glow + per-message attestation seal (Viz-core, shipped this pass). |

## 6. Cross-cutting substrate — Viz-core (sibling of EI-core) — SHIPPED THIS PASS
`Life/pwa/platform/viz-core.{js,css}` (zero-CDN, system-font, reduced-motion-native, WASM-ready):
- `VIZ_CORE.proofSeal({state,label})` — animated attestation seal: `pending`=rotating arc, `ok`=lock snaps + green glow, `bad`=red shake. Replaces the plain badge in mesh nodes.
- `VIZ_CORE.nodeConstellation({mount,nodes,rootLabel})` — vertical "agent spine": a root (registry/Canon) with sovereign nodes branching, each a pulsing dot, connectors drawn inline SVG. Sovereign-device safe.
- Heavy layout (constellation physics, fork-tree) is reserved for **WASM** (future) to stay sovereign-fast; v1 uses SVG/CSS.
- Wired into `lifeagent` mesh panel via EI-core (`renderMeshView` detects `window.VIZ_CORE`).

## 7. Reviewable & refineable (governance)
- This document is **v1**, sectioned so each item is independently refineable.
- Re-review on every new capability (new proof types, new mesh nodes, new series kinds).
- Signed artifact: `UVS-PLAN.proof.json` (Ed25519Signature2020 over RFC-8785-subset canonical body, content-addressed `docHash`), verifiable by `node verify-doc.cjs UVS-PLAN.md`.

## 8. Highest-leverage sequence
1. Persist + sign UVS-PLAN (done this pass).
2. Ship Viz-core `proofSeal()` + `nodeConstellation()` into `lifeagent` mesh view (done this pass).
3. Promote Viz-core to `uix` (proof-badges animate-lock).
4. `lifepioneer` series fork-tree viz (ties to `register_series`/`fork_series`).
5. `use` verify animation.
6. Declarative signed viz-spec manifest (self-attesting animation grammar).