Update README.md

README.md

@@ -24,6 +24,7 @@ We believe intelligence should be **purpose-built, accessible, and honest**. Eve
 ### 🔷 Vexa — Crystalline Intelligence Substrate
 *NOT AN AI MODEL — A new computational paradigm*
 *Runs on any laptop · Fully open source · Lume language*
+**Status: 🔴 Spec complete — Build in progress**
 
 > **Vexa is not a neural network. It is a Crystalline Intelligence Substrate** — a living, self-updating lattice of Glyphs that crystallizes knowledge in 10 minutes on any laptop, learns from the live web in real time, and runs on Ollama. No gradient descent. No GPU cluster. No frozen knowledge.
 
@@ -42,7 +43,7 @@ We believe intelligence should be **purpose-built, accessible, and honest**. Eve
 | Vexa Bridge (Ollama/vLLM/HF adapter) | Matrix-Corp/Vexa-Bridge | 🔴 Planned |
 | Vexa Crystallizer Engine | Matrix-Corp/Vexa-Crystallizer | 🔴 Planned |
 
-**Glyph Lattice density tiers (one architecture, scaled by density):**
+**Glyph Lattice density tiers:**
 
 | Tier | Glyphs | RAM | Equivalent | Use Case |
 |---|---|---|---|---|
@@ -53,84 +54,99 @@ We believe intelligence should be **purpose-built, accessible, and honest**. Eve
 | Max | ~10B | 40GB | ~70B LLM | A100 / p300a |
 
 **Collection:** Matrix-Corp/vexa-v1 *(coming soon)*
-**Status:** 🔴 Planned — paradigm definition complete, implementation starting
+
+---
+
+### ⚡ Kairiq — Critical Moment Intelligence Module
+*Universal plug-in module · Built entirely in Lume · Slap-on adapters*
+**Status: 🔴 Architecture complete — Build starting**
+
+> **Kairiq is not a model. It is a universal intelligence amplifier** — a plug-in module built entirely in `.lume` files that attaches to any Matrix.Corp model and elevates it to elite benchmark performance. A Kairiq-enhanced 32B competes with a vanilla 70B. Not because it knows more — because it deploys what it knows at exactly the right moment, the right depth, and the right priority.
+
+**The Three KQ Dimensions:**
+- ⏱ **Temporal Acuity (T)** — sensing rhythm, pacing, momentum. Knowing when a reasoning path is collapsing before it wastes compute
+- ⚡ **Tension Sensing (X)** — reading pressure gradients. Identifying load-bearing sub-problems where failure cascades everywhere
+- 👑 **Imperial Hierarchy (H)** — the rank and weight of every sub-problem. What overrides what. The actual question beneath the stated question
+
+**Three-layer pipeline:** Kairiq Gate → Kairiq Router → Base Model → Kairiq Verifier
+
+**Benchmark targets:**
+
+| Benchmark | KQ Dimension | Expected Gain |
+|---|---|---|
+| MMLU | H — ranks actual question instantly | +4–6% |
+| HumanEval | T — kills dead reasoning paths early | +6–9% |
+| MATH | X — slow-deep on load-bearing steps | +5–8% |
+| ARC | H — no reasoning overkill on simple problems | +3–5% |
+| HellaSwag | T — reads narrative momentum correctly | +4–7% |
+
+**Written entirely in `.lume`. Python `adapter.py` bridge for any existing model. Zero changes to base model required.**
+
+| Component | Repo | Status |
+|---|---|---|
+| Kairiq Module V1 | Matrix-Corp/Kairiq-Module-V1 | 🔴 Planned |
+| Lume Kairiq Spec | Matrix-Corp/Lume-Kairiq-Spec | 🔴 Planned |
+| Zenith-32B-Kairiq-V1 | Matrix-Corp/Zenith-32B-Kairiq-V1 | 🔴 Planned |
+
+**Collection:** Matrix-Corp/kairiq-v1 *(coming soon)*
 
 ---
 
 ### 🌌 Zenith — Reasoning & Emotional Intelligence
 *Optimized for Tenstorrent Blackhole p300a hardware*
 
-High-performance reasoning models built for the Tenstorrent p300a accelerator (dual-chip, 32 RISC-V cores, 64GB GDDR6). Each model features Ring Attention (32K context), Mixture of Experts, and our EQ Engine for emotional intelligence.
+High-performance reasoning models built for the Tenstorrent p300a accelerator (dual-chip, 32 RISC-V cores, 64GB GDDR6). Ring Attention (32K context), Mixture of Experts, and EQ Engine V1 for emotional intelligence.
 
-| Model | Parameters | Base Model | Status | Use Case |
-|---|---|---|---|---|
-| [Zenith-7B-V1](https://huggingface.co/Matrix-Corp/Zenith-7b-V1) | 7B | Qwen2.5-Coder-7B | 🟡 Preview | Code generation, fast inference |
-| [Zenith-28B-V1](https://huggingface.co/Matrix-Corp/Zenith-28b-p300-V1) | 28B | Qwen3.5-27B (Claude Opus 4.6 distilled) | 🟡 Preview | Nuanced reasoning, EQ-aware conversations |
-| [Zenith-32B-V1](https://huggingface.co/Matrix-Corp/Zenith-32b-p300-V1) | 32B | DeepSeek-R1-Distill-Qwen-32B | 🟡 Preview | Mathematical & structured reasoning |
-| [Zenith-70B-V1](https://huggingface.co/Matrix-Corp/Zenith-70b-p300-V1) | 70B | DeepSeek-R1-Distill-Llama-70B | 🟡 Preview | Maximum capability, multi-card setup |
-
-**Key features:**
-- 🧠 EQ Engine V1 — frustration detection + 8-emotion classification, fully integrated as core architecture
-- ⚡ Ring Attention — 32K context on limited memory
-- 🔀 Mixture of Experts — 12 experts, top-2 routing
-- 🖥️ p300a optimized — TP=8/PP=4 maps 1:1 to all 32 RISC-V cores
-- 📦 Ollama + vLLM compatible
+| Model | Parameters | Base Model | Status |
+|---|---|---|---|
+| [Zenith-7B-V1](https://huggingface.co/Matrix-Corp/Zenith-7b-V1) | 7B | Qwen2.5-Coder-7B | 🟡 Preview |
+| [Zenith-28B-V1](https://huggingface.co/Matrix-Corp/Zenith-28b-p300-V1) | 28B | Qwen3.5-27B (Claude Opus 4.6 distilled) | 🟡 Preview |
+| [Zenith-32B-V1](https://huggingface.co/Matrix-Corp/Zenith-32b-p300-V1) | 32B | DeepSeek-R1-Distill-Qwen-32B | 🟡 Preview |
+| [Zenith-70B-V1](https://huggingface.co/Matrix-Corp/Zenith-70b-p300-V1) | 70B | DeepSeek-R1-Distill-Llama-70B | 🟡 Preview |
+
+**Key features:** EQ Engine V1 · Ring Attention 32K · MoE 12 experts top-2 · TP=8/PP=4 · Ollama + vLLM compatible
 
 **Collection:** [Zenith V1](https://huggingface.co/collections/Matrix-Corp/zenith-v1)
-**Timeline:** Trained weights + real benchmarks expected in 3–6 months
 
 ---
 
 ### 🔬 Vortex Scientific — Deep Science Reasoning
-*Optimized for Apple Silicon & Nvidia 4060 laptop GPUs*
+*Optimized for Apple Silicon & Nvidia 4060 · Built from scratch — no base model*
 
-From-scratch models built for scientific reasoning across Physics, Mathematics, Chemistry, Biology, Earth Science, Space Science, and Zoology. Novel hybrid state-space + attention architecture with specialized science modules.
+From-scratch models for scientific reasoning across Physics, Mathematics, Chemistry, Biology, Earth Science, Space Science, and Zoology. Hybrid SSM + attention architecture with a custom 50K science tokenizer and 4 specialized science modules.
 
-| Model | Parameters | Architecture | Status | Use Case |
-|---|---|---|---|---|
-| [Vortex-7B-V1](https://huggingface.co/Matrix-Corp/Vortex-7b-V1) | 7B | Hybrid SSM + Attention (60% SSM) | 🟡 Preview | Science reasoning on consumer hardware |
-| [Vortex-13B-V1](https://huggingface.co/Matrix-Corp/Vortex-13b-V1) | 13B | Hybrid SSM + Attention (50% SSM) | 🟡 Preview | Advanced scientific reasoning |
+| Model | Parameters | Architecture | Status |
+|---|---|---|---|
+| [Vortex-7B-V1](https://huggingface.co/Matrix-Corp/Vortex-7b-V1) | 7B | Hybrid SSM + Attention (60% SSM) | 🟡 Preview |
+| [Vortex-13B-V1](https://huggingface.co/Matrix-Corp/Vortex-13b-V1) | 13B | Hybrid SSM + Attention (50% SSM) | 🟡 Preview |
 
-**Key features:**
-- 🔭 No base model — built entirely from scratch including tokenizer
-- ⚗️ Science modules — Equation/LaTeX, Numerical Reasoning, Citation Awareness, Molecular/Periodic Table
-- 📐 Custom science tokenizer — 50K vocab with LaTeX symbols, element symbols, SI units, amino acids
-- 🖥️ Laptop-first — runs on MacBook Pro M2/M3 and Nvidia 4060
-- 🎓 School science project
+**Key features:** No base model · Custom science tokenizer · Equation/LaTeX · Molecular/Periodic Table modules · Laptop-first
 
 **Collection:** [Vortex V1](https://huggingface.co/collections/Matrix-Corp/vortex-v1)
-**Timeline:** Training data pipeline in progress, weights TBD
 
 ---
 
 ### 🌿 Touch Grass — Music AI Assistant
-*Ultra lightweight, runs on anything*
+*Ultra lightweight · Runs on anything*
 
-Fine-tuned music assistant helping users learn instruments, understand music theory, write songs, train their ear, and explore music history. Warm, encouraging, beginner-friendly.
+Fine-tuned music assistant for learning instruments, music theory, songwriting, ear training, and music history. Warm, encouraging, beginner-friendly.
 
-| Model | Parameters | Base Model | Status | Use Case |
-|---|---|---|---|---|
-| [TouchGrass-3B](https://huggingface.co/Matrix-Corp/TouchGrass-3b) | 3B | Qwen3.5-3B-Instruct | 🟡 Preview | Ultra lightweight music assistant |
-| [TouchGrass-7B](https://huggingface.co/Matrix-Corp/TouchGrass-7b) | 7B | Qwen3.5-7B-Instruct | 🟡 Preview | Full-featured music assistant |
-
-**Key features:**
-- 🎸 All instruments — Guitar, Bass, Piano, Keys, Drums, Vocals, DJ & Production
-- 🎵 Tab & chord generation — structured, musically validated output
-- 🎼 Music theory engine — circle of fifths, modes, progressions, voice leading
-- 👂 Ear training guidance — interval recognition, chord quality, relative pitch
-- ✍️ Songwriting assistant — lyrics, progressions, structure, hooks
-- 💚 Music EQ adapter — frustration detection tuned for music learners
-- 📖 Genre & music history knowledge
+| Model | Parameters | Base Model | Status |
+|---|---|---|---|
+| [TouchGrass-3B](https://huggingface.co/Matrix-Corp/TouchGrass-3b) | 3B | Qwen3.5-3B-Instruct | 🟡 Preview |
+| [TouchGrass-7B](https://huggingface.co/Matrix-Corp/TouchGrass-7b) | 7B | Qwen3.5-7B-Instruct | 🟡 Preview |
+
+**Key features:** All instruments · Tab & chord generation · Music theory engine · Ear training · Songwriting assistant · Music EQ adapter
 
 **Collection:** [Touch Grass](https://huggingface.co/collections/Matrix-Corp/touch-grass)
-**Timeline:** Architecture published, training planned
 
 ---
 
 ### 🌐 Matrix Lattice — Frontier Agentic MoE
 *Inference provider deployment · Closed source · Long-term roadmap*
+**Status: 🩵 Long-Term Roadmap · Spec complete**
 
-Flagship frontier agentic + multimodal MoE family. Designed for inference provider deployment (Novita, Hyperbolic, Together, Fireworks). OpenAI-compatible API. 17 custom modules including EQ Engine V2, Multi-Agent Coordination Layer, Hierarchical Context Compression, and Safety Reasoning Module.
+Flagship frontier agentic + multimodal MoE family with 17 custom modules including EQ Engine V2, Multi-Agent Coordination Layer (MACL), Hierarchical Context Compression Engine (HCCE), and Safety Reasoning Module. Designed for inference provider deployment (Novita, Hyperbolic, Together, Fireworks).
 
 | Model | Total Params | Active Params | Context | Status |
 |---|---|---|---|---|
@@ -144,18 +160,27 @@ Flagship frontier agentic + multimodal MoE family. Designed for inference provid
 
 ### 🎨 Matrix Voxel — 3D Generation
 *Flow Matching · Triplane Latent · A100 40GB*
+**Status: 🔴 Planned — Architecture complete**
 
-3D generation model family sharing a flow-matching DiT backbone with task-specific decoder heads. 4 specialist models open source, Voxel Prime closed source API-only.
+3D generation model family sharing a flow-matching DiT backbone (~2.3B) with task-specific decoder heads.
 
 | Model | Task | Outputs | Status |
 |---|---|---|---|
-| Voxel Atlas | World/environment generation | .vox, .obj, .usd | 🔴 Planned · 🟢 Open Source |
-| Voxel Forge | 3D mesh & asset generation | .obj, .glb, .fbx, .usdz | 🔴 Planned · 🟢 Open Source |
-| Voxel Cast | 3D printable generation | .stl, .step, .3mf | 🔴 Planned · 🟢 Open Source |
-| Voxel Lens | NeRF / Gaussian Splatting | .ply (3DGS), NeRF weights | 🔴 Planned · 🟢 Open Source |
-| Voxel Prime | All-in-one unified | All formats + pipeline mode | 🔴 Planned · 🟣 Closed Source |
+| Voxel Atlas | World/environment generation | .vox, .obj, .usd | 🔴 Planned · 🟢 Open |
+| Voxel Forge | 3D mesh & asset generation | .obj, .glb, .fbx, .usdz | 🔴 Planned · 🟢 Open |
+| Voxel Cast | 3D printable generation | .stl, .step, .3mf | 🔴 Planned · 🟢 Open |
+| Voxel Lens | NeRF / Gaussian Splatting | .ply (3DGS), NeRF weights | 🔴 Planned · 🟢 Open |
+| Voxel Prime | All-in-one unified | All formats | 🔴 Planned · 🟣 Closed |
 
-**Status:** 🔴 Planned — architecture complete
+---
+
+### ⚒️ Matrix Axiom — Extreme Reasoning Code Intelligence
+*Reserved · Design in progress*
+**Status: 🔴 Reserved — Design starting**
+
+> Axiom is Matrix.Corp's planned extreme reasoning coding model. Hybrid architecture on a proven base with structurally enforced pre-code reasoning, a self-verify + rewrite loop, internal multi-agent trident (Architect · Artisan · Auditor), and a custom semantic code tokenizer. Targets #1 on HumanEval. Any hardware. Kairiq-enhanced at launch.
+
+*Full spec coming soon.*
 
 ---
 
@@ -164,10 +189,10 @@ Flagship frontier agentic + multimodal MoE family. Designed for inference provid
 | Status | Meaning |
 |---|---|
 | 🟢 Released | Trained weights available, benchmarks published |
-| 🟡 Preview | Architecture and code published, training in progress or planned |
+| 🟡 Preview | Architecture published, training in progress or planned |
 | 🔴 Planned | Design complete, build not yet started |
 | 🩵 Long-Term Roadmap | Vision defined, significant research and compute required |
-| 🟣 Closed Source | Architecture may be public, weights and training are proprietary |
+| 🟣 Closed Source | Weights and training are proprietary |
 
 ---
 
@@ -175,23 +200,24 @@ Flagship frontier agentic + multimodal MoE family. Designed for inference provid
 
 We build for **accessible, affordable hardware** — not just cloud GPUs:
 
-| Series | Target Hardware | Why |
-|---|---|---|
-| Vexa | Any 8-core laptop — CPU only | Crystalline Intelligence for everyone, no GPU required |
-| Zenith | Tenstorrent p300a | High-performance AI at a fraction of Nvidia cost |
-| Vortex | MacBook + 4060 laptop | Science AI for researchers and students anywhere |
-| Touch Grass | Any hardware | Music assistance should be universally accessible |
-| Matrix Lattice | 16–32× H100 / p300a | Frontier inference for providers |
-| Matrix Voxel | A100 40GB | 3D generation on a single card |
+| Series | Target Hardware |
+|---|---|
+| Vexa | Any 8-core laptop — CPU only |
+| Kairiq | Any — universal plug-in |
+| Zenith | Tenstorrent Blackhole p300a |
+| Vortex | MacBook M2/M3 + Nvidia 4060 laptop |
+| Touch Grass | Any hardware |
+| Axiom | Any / multi-target |
+| Matrix Lattice | 16–32× H100 / p300a |
+| Matrix Voxel | A100 40GB |
 
 ---
 
 ## Reserved Project Names
 
-These names are allocated to specific future projects — not available for other uses:
-
-- **Vexa** → Crystalline Intelligence Substrate (this project)
-- **Axiom** → Future extreme reasoning model (planned)
+- **Vexa** → Crystalline Intelligence Substrate
+- **Kairiq** → Critical Moment Intelligence Module
+- **Axiom** → Extreme Reasoning Code Intelligence
 
 ---
 
@@ -207,11 +233,12 @@ These names are allocated to specific future projects — not available for othe
 
 ## Collections
 
-- [Zenith V1](https://huggingface.co/collections/Matrix-Corp/zenith-v1) — All Zenith series models
-- [Vortex V1](https://huggingface.co/collections/Matrix-Corp/vortex-v1) — All Vortex series models
-- [Touch Grass](https://huggingface.co/collections/Matrix-Corp/touch-grass) — Touch Grass music assistant models
-- Matrix-Corp/vexa-v1 *(coming soon)* — Vexa Crystalline Intelligence components
-- Matrix-Corp/voxel-v1 *(coming soon)* — Matrix Voxel 3D generation models
+- [Zenith V1](https://huggingface.co/collections/Matrix-Corp/zenith-v1)
+- [Vortex V1](https://huggingface.co/collections/Matrix-Corp/vortex-v1)
+- [Touch Grass](https://huggingface.co/collections/Matrix-Corp/touch-grass)
+- Matrix-Corp/vexa-v1 *(coming soon)*
+- Matrix-Corp/kairiq-v1 *(coming soon)*
+- Matrix-Corp/voxel-v1 *(coming soon)*
 
 ---