# EI/EX Optimization Plan — ICore Sovereign Surfaces

> Status: **v1 (reviewable + refineable)** · Signed artifact (see `EI-EX-OPTIMIZATION-PLAN.proof.json`)
> Scope: Entity Interface (EI) + Entity Experience (EX) for ICore and its surfaces:
> `use.initialcore.net`, `uix.initialcore.net`, `lifepioneer.initialcore.net`, `lifeagent.initialcore.net`
> Doctrine constraints that bind every move: **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**, **invariants never optional**.

---

## 0. Definitions
- **EI (Entity Interface):** how any sovereign entity — Creator, agent, adopter, Life instance — meets the constitution. The contract surface.
- **EX (Entity Experience):** the felt quality — trust, speed, clarity, sovereignty. What makes adoption stick.
- Both are **reviewable and refineable for the best reasons and best results**: every item below is independently refinable, and the plan itself is a *signed* artifact, reviewable by the same Ed25519 doctrine it describes.

## 1. Guiding principles (the out-of-the-box differentiators)
1. **Self-attesting UI.** The EI manifest is itself a signed artifact in the registry; the surface verifies its own source before painting. Kills UI supply-chain drift.
2. **Provenance-native EX.** Every data point carries its Ed25519 proof + content-address inline (not a hidden "security" page). *Trust you can see* is the moat.
3. **Entitlement-gated components.** UI sections unlock from governance entitlements (now built in `reference-agents/src/governance.rs`). EI renders only what the entity is permitted; capability = UI, not a separate auth layer.
4. **Offline-first verified cache.** SW caches the signed ledger; render from local verified copy → instant + tamper-proof, even air-gapped.
5. **Mesh-native EI.** Surface `meshNodes()` as a live, vertical, verified-node list (capabilities progressively disclosed). The agent mesh becomes a visible, navigable reality.
6. **Zero telemetry.** EX measured by local interaction proofs, never surveillance.

## 2. Per-surface plan (Now → Future)
| Surface | Role | Now (quick wins, shipped/planned) | Future (next-gen) |
|---|---|---|---|
| **use.initialcore.net** | Canonical truth (registry) | Human verification view: paste any profile/anchor → inline Ed25519 + content-address check (reuse `verifyProfile`). | Self-attesting UI manifest; read-only "constitution explorer" over `meshNodes` + `interopProfiles`. |
| **uix.initialcore.net** | EI skeleton / disclosure | Extend `#ei-interop` with proof badges + progressive disclosure; wire entitlement-gated sections. | Shared **EI-core** lib (badges, vertical primitives, SW cache) consumed by all 4 surfaces. |
| **lifepioneer.initialcore.net** | Pioneering Series / orchard creation | **Instantiate** from `register_series`/`fork_series`: one-click spawn a Life orchard forked with no-drift Canon anchor. | Series marketplace EI — browse/compose variants, each a self-verifying orchard template. |
| **lifeagent.initialcore.net** | Running Life instance | Visualize `consultRegistry()` mesh discovery as the vertical verified-node list (EI-core, shipped this pass). | On-device WASM inference EI (UCA capabilities); entitlement-driven feature unlock. |

## 3. Cross-cutting EI/EX substrate
- **Vertical, tabless, progressive-disclosure layout** everywhere (hard constraint).
- **Self-hosted assets only** (system/self-hosted fonts, no external CDN) → works under Shields-ON.
- **Semantic EI versioning** negotiated against the agent mesh (like USDS⇄Life) so UI stays compatible as backends evolve.
- **Accessibility = sovereignty:** high-contrast, reduced-motion, screen-reader-native, content-addressed i18n locale packs.

## 4. EI-core (shared substrate) — SHIPPED THIS PASS
`Life/pwa/platform/ei-core.{js,css}` (reusable; to be promoted to a shared location for all surfaces):
- `EI_CORE.badge()` — proof badge (pending/ok/bad).
- `EI_CORE.verifyConsole()` — self-attesting verification card.
- `EI_CORE.renderMeshView()` — vertical, verified sovereign-agent node list (delegates to `USE_REGISTRY.meshNodes`, never trusts).
- `EI_CORE.cacheLedger()` — SW-backed offline verified cache (best-effort).
- Wired into `lifeagent` (`#eiMesh` panel) — replaces the plain chat-note mesh with a live, self-verifying panel.

## 5. Reviewable & refineable (governance)
- This document is **v1**, sectioned so each item is independently refinable.
- Re-review on every new capability landing (new entitlement/series types, new mesh nodes).
- The plan is a **signed** artifact: `EI-EX-OPTIMIZATION-PLAN.proof.json` (Ed25519Signature2020 over the RFC-8785-subset canonical body), verifiable by `node verify-doc.cjs EI-EX-OPTIMIZATION-PLAN.md`.

## 6. Highest-leverage sequence
1. Persist EI-core shared (done this pass, in `Life/pwa/platform`).
2. Light up `lifeagent` mesh view (done this pass).
3. Promote EI-core to `uix` and re-skin `#ei-interop` with proof badges.
4. Add `use` human verification view.
5. `lifepioneer` series spawn/instantiate UI (ties to `register_series`/`fork_series`).
6. Entitlement-gated UI sections (governance toolkit → EI).