Changelog
All notable changes to the XRAI spec + reference implementations.
Format follows Keep a Changelog. Versioning follows Semantic Versioning: MAJOR.MINOR.PATCH. Breaking spec changes → MAJOR. New primitives or optional fields → MINOR. Docs / typo / clarifications → PATCH.
[Unreleased]
Site — public preview refresh — 2026-04-30
- Topnav: surface
agent (jarvis.html), conf (LiveKit hologram demo), runtimes (RUNTIMES.md scoreboard) — three buried pages now first-class.
- New pages live on
imclab.github.io/xra1/: landing, dev, priorities, replay, conf, plus 4 runtime stubs (runtimes/{echarts,icosa,needle,playcanvas}/viewer.html).
- Examples: 10 new XRAI fixtures (05–14 + INDEX.xrai.json).
- RFCs: 6 new (0004 relation types, 0009 stream ingestion, 0010 archetypes, 0011 blueprints, 0012 decoder contract, 0013 master ontology).
- JS modules: 13 new (auth, gemini, jarvis, kb-browser, memory-sync, sessions-connector, stack-inspector, trace, xray-graph, dimension-morph, essence-distiller, perceptual-frame, reticle).
- Data privacy:
data/*.json snapshots replaced with sanitized public stubs (no session content, no internal priorities, no KB index). Real telemetry stays in the private monorepo only.
- Hygiene: removed two
../../../ path-escapes (jarvis.html arch-cards) and one in priorities.html.
- Spec content (SPEC.md, MANIFESTO.md, etc.) unchanged — still v1.0.0.
Planned for v1.1
- Event primitives beyond stub (temporal scheduling, triggers, reaction chains).
- Conformance suite (
runtimes/_conformance/) with minimum viable pass bar.
- Three.js + PlayCanvas reference adapters (alpha).
- MCP server tool surface finalized (
mcp-server/).
Planned for v1.2
- visionOS + Unreal reference adapters.
- Federated query (
xrai-fed://).
- Signed graphs (author attestation, optional).
[1.0.0] — 2026-04-29
First public release. Extracted from the Portals codebase (h3m.ai) as shipped on the CVPR 2026 camera-ready (2026-04-10).
Added
- Top-level schema:
xrai_version, id, author, scene, relations, events (stub).
- Entity primitives:
cube, sphere, cylinder, capsule, plane, glb, hologram, light, emitter.
- Relation types:
parent-of, wire-binds, reacts-to-audio, tracks.
- URI scheme:
xrai://<uuid>/node/<id>.
- MIME type:
application/vnd.xrai+json.
- Minimal example scene in
SPEC.md §Examples.
- LLM authoring guidance in
MANIFESTO.md.
- 10 design principles.
- BDFL governance (Year 1), transition-to-foundation criteria documented.
- MIT license for spec text, reference implementations, and prompt libraries. CC0 for the normative JSON schema.
Known gaps
- Event primitives are a stub. Temporal scheduling + triggers ship in 1.1.
- Reference runtimes beyond Portals (Unity) are README-only. Three.js + PlayCanvas adapters are week-2 deliverables.
- No standalone validator CLI yet. Conformance tests ship with 1.1.
demos/jarvis_demos.md scripts are documented but videos are not yet recorded.
Out of scope for v1
- Physics simulation semantics (engine-defined).
- Rendering quality or LOD hints (renderer-defined).
- Multiplayer sync protocol (separate spec, planned).
- Rights + monetization layer (intentionally absent — spec is neutral).
How to read this changelog
- [Unreleased] shows what’s in flight. No guarantees until versioned.
- Each release section is frozen once tagged. Fixes applied post-release go to the next version.
- Breaking changes are called out explicitly. Migration notes live at
docs/migrations/<from>-<to>.md.
If you depend on XRAI and a change would break you, file an issue before we tag — we’d rather know.