docs: polish README with Solstice-AI flagship branding and enterprise spec

README.md

@@ -12,77 +12,93 @@ tags:
 - solstice-ai
 - objective-gated
 - zero-waste
-- anti-mig25
+- dynamic-reasoning
 - gguf
 - ollama
 - llama.cpp
 - vllm
 ---
 
-<div align="center">
+<p align="center">
+  <img src="https://cdn-uploads.huggingface.co/production/uploads/67c2e844e0921a5410eec10a/Y5M42dCag2f7Fc6fDtV0Z.jpeg" alt="Solstice-AI Banner" width="100%">
+</p>
 
-# ⚡ Protium-1.0: Objective-Gated Cognitive Architecture
+<h1 align="center">Protium-1.0: Objective-Gated Cognitive Architecture</h1>
 
-[![Solstice AI](https://img.shields.io/badge/Solstice--AI-Protium--1.0-blueviolet?style=for-the-badge&logo=openai)](https://huggingface.co/Solstice-AI)
-[![Model-Agnostic](https://img.shields.io/badge/Architecture-Model--Agnostic-success?style=for-the-badge)](https://huggingface.co/Solstice-AI/Protium-1.0)
-[![Levels](https://img.shields.io/badge/Cognitive%20Spectrum-L0%20to%20L10%20Dynamic-orange?style=for-the-badge)](https://huggingface.co/Solstice-AI/Protium-1.0)
-[![Swarm](https://img.shields.io/badge/Swarm-20--Agent%20%2B%20Council-red?style=for-the-badge)](https://huggingface.co/Solstice-AI/Protium-1.0)
+<h3 align="center">Zero-Waste Cognitive Protocol &bull; Dynamic Cognitive Impedance &bull; Universal LLM Runtime Support</h3>
 
-**Zero Neutrons. Zero Dead Weight. Pure Thrust.**
+<p align="center">
+  <img src="https://img.shields.io/badge/org-Solstice--AI-blueviolet" alt="Solstice-AI">
+  <img src="https://img.shields.io/badge/license-Apache%202.0-blue" alt="License">
+  <img src="https://img.shields.io/badge/protocol-Protium--1.0%20(Objective--Gated)-success" alt="Protocol">
+  <img src="https://img.shields.io/badge/architecture-Universal%20Cross--Family-crimson" alt="Architecture">
+  <img src="https://img.shields.io/badge/default%20mode-L10%20Proteus%20Dynamic-purple" alt="Default Mode">
+  <img src="https://img.shields.io/badge/inference-Zero--Waste%20Early--Exit-brightgreen" alt="Zero-Waste">
+</p>
 
-</div>
+---
+
+## Executive Summary
+
+**Protium-1.0** is Solstice-AI's high-efficiency, objective-gated cognitive reasoning architecture for open-weight foundation models. Named after **Protium** ($^1\text{H}$) — the fundamental isotope of hydrogen featuring zero neutrons and zero dead weight — Protium-1.0 replaces traditional, unconstrained chain-of-thought bloat with a lean, forward-only reasoning pipeline.
+
+Traditional reasoning chat templates frequently impose static token minimums, rigid pseudo-schemas, or unconstrained internal deliberation loops. Protium-1.0 resolves this fundamental inefficiency by establishing an **Objective-Gated Protocol**: every reasoning sequence anchors its verification criteria at step one, reasons strictly forward toward that objective, and terminates deliberation the exact millisecond verified correctness is attained.
+
+Equipped with the **`[L10]` Proteus Dynamic Engine** as its native default, Protium-1.0 auto-calibrates cognitive depth to the intrinsic difficulty of each prompt—collapsing to near-zero latency on direct queries while dynamically allocating full analytical runway for axiomatic proofs and complex engineering tasks.
 
 ---
 
-## 🔬 What is Protium-1.0?
+## Architectural Principles
+
+### 1. Token 1 Target Anchoring
+At the inception of the cognitive trajectory, the model isolates and locks the exact termination criteria required for a complete, verified solution. The target is anchored before execution begins.
 
-**Protium-1.0** is Solstice-AI's high-efficiency, objective-gated cognitive reasoning architecture. Derived from **Protium** ($^1	ext{H}$) — the lightest, purest isotope of hydrogen consisting of one proton and zero neutrons — Protium-1.0 eliminates all cognitive ballast, rhetorical hesitation, and circular overthinking loops.
+### 2. Forward-Only Deduction
+Reasoning progresses strictly forward along deductive axes. Internal conversational stalling, rhetorical hesitation, and self-conversational commentary (*"Let me see"*, *"Hmm"*, *"Wait"*) are systematically eliminated from the attention cache.
 
-Unlike legacy reasoning templates that impose arbitrary token floors (e.g. DavidAU's 5,000-token minimums), hardcoded pseudo-schemas, or unconstrained self-conversational babble, Protium-1.0 operates on a **forward-only, objective-gated protocol**.
+### 3. Objective-Gated Early Exit
+Deliberation is bounded exclusively by mathematical, programmatic, and empirical verification. The moment the target anchor is verified, the `<think>` block terminates immediately and the final response is delivered.
 
-### Core Architecture Tenets
+### 4. Delta-Isolated Error Correction
+If a logical contradiction or boundary failure is detected during verification, the model isolates and repairs only the specific broken parameter. It does not regress into circular overthinking loops or full-context restarts.
 
-1. **Token 1 Target Anchor**: The model isolates the exact termination condition at token 1. It anchors where "done and verified" lies before solving.
-2. **Forward-Only Deduction**: Thinking advances directly toward the target. Internal conversational monologues (*"Let's see..."*, *"Hmm..."*, *"Wait, let me rethink..."*) are strictly eliminated.
-3. **Objective-Gated Early Exit**: The moment the target condition is satisfied and verified, `<think>` terminates immediately. Zero stall, zero padding, zero manufactured doubt.
-4. **Anti-MiG-25 / Delta-Only Correction**: If a contradiction or constraint violation occurs, the model isolates and repairs only the specific broken delta. It never spirals into circular loops or complete restarts.
-5. **Absolute Operational Aura**: Clean, decisive, unhedged output delivery with maximum information density and zero conversational preamble.
-6. **Zero Token Quotas or Word Floors**: Reasoning depth is guided 100% by problem complexity and verification gates, never an artificial token counter.
+### 5. Decisive Operational Aura
+Outputs are delivered with maximum information density, absolute resolve, and complete absence of conversational preamble or unnecessary hedging.
 
 ---
 
-## 🎚️ The Cognitive Spectrum
+## The Cognitive Spectrum
 
-Protium-1.0 defaults to **`[L10]` Proteus (Dynamic Reasoning)**, which automatically shifts cognitive depth based on intrinsic prompt difficulty:
+Protium-1.0 features 11 calibrated reasoning tiers plus specialized multi-agent convergence modes. It defaults natively to **`[L10]` Proteus (Dynamic Adaptive)**:
 
-| Level | Identifier | Archetype | Operational Focus | Ideal Workload |
+| Level | Identifier | Archetype | Operational Focus | Workload Profile |
 |---|---|---|---|---|
-| **[L10]** | `proteus` / `dynamic` | **Dynamic Adaptive (Default)** | **Fluid impedance matching** | **Auto-scales across all queries (near-zero on simple, expands on hard)** |
-| **[L0]** | `mortal` / `regular` | Instant Execution | Thinking OFF | Conversational chat, pure classification, basic summarization |
-| **[L1]** | `hermes` | Rapid Instinct | High-velocity check | Instant sanity checks, syntax validation, arithmetic verification |
-| **[L2]** | `apollo` | Disciplined Deduction | Linear implication | Constraint mapping, structured rule following, direct logic |
-| **[L3]** | `artemis` | Boundary & Failure Audit | Edge vulnerability probe | Null checks, type boundaries, concurrency hazard audits |
-| **[L4]** | `athena` | Strategic Architecture | Modular synthesis | Multi-step refactors, API design, trade-off optimization |
-| **[L5]** | `prometheus` | Defensive Engineering | Second-order modeling | Fault tolerance, scaling bottlenecks, lifecycle resilience |
-| **[L6]** | `solstice` | Deep Systemic Derivation | Axiomatic derivation | Dual-hypothesis synthesis, axiomatic proof, stress-testing |
-| **[L7]** | `hyperion` | First-Principles Synthesis | Ground-up decomposition | Comprehensive first-principles decomposition |
-| **[L8]** | `einstein` | Theoretical Mastery | Unified invariant reduction | Theoretical breakthroughs, deep algorithms, continuous derivations |
-| **[L9]** | `oracle` | Proof-Grade Authority | Formal proof verification | Exhaustive formal proofs, zero-placeholder implementations |
-| **Swarm** | `swarm` | 20-Perspective Swarm | Divergent synthesis | Breakthrough ideation, multi-perspective tension resolution |
-| **Council**| `council` | Adversarial Research Panel | Institutional consensus | Multi-specialist consensus, formal verification, audit |
+| **[L10]** | `proteus` / `dynamic` | **Dynamic Adaptive (Default)** | **Fluid impedance matching** | **Auto-calibrated depth across all inputs; collapses on lookups, expands on proofs** |
+| **[L0]** | `mortal` / `regular` | Instant Execution | Thinking Suppressed | Conversational dialogues, zero-overhead classification, streaming tasks |
+| **[L1]** | `hermes` | Rapid Instinct | High-velocity verification | Single-pass sanity checks, syntax validation, arithmetic confirmation |
+| **[L2]** | `apollo` | Disciplined Deduction | Linear constraint trace | Parameter mapping, rule following, structured deduction |
+| **[L3]** | `artemis` | Boundary & Failure Audit | Edge vulnerability probe | Null/empty states, numeric limits, concurrency collision auditing |
+| **[L4]** | `athena` | Strategic Architecture | Modular synthesis | Multi-step refactoring, API interface design, trade-off optimization |
+| **[L5]** | `prometheus` | Defensive Engineering | Second-order impact modeling | Fault tolerance, graceful degradation, scaling lifecycle resilience |
+| **[L6]** | `solstice` | Deep Systemic Derivation | Multi-hypothesis synthesis | Axiomatic proofs, competing architecture stress-testing |
+| **[L7]** | `hyperion` | First-Principles Synthesis | Ground-up decomposition | Comprehensive first-principles decomposition across all logical surfaces |
+| **[L8]** | `einstein` | Theoretical Mastery | Unified invariant reduction | Theoretical breakthroughs, advanced algorithmic reduction, formal derivations |
+| **[L9]** | `oracle` | Proof-Grade Authority | Formal mathematical verification | Exhaustive formal proofs, zero-placeholder production implementations |
+| **Swarm** | `swarm` | 20-Perspective Swarm | Divergent conceptual synthesis | Complex multi-perspective cross-pollination and convergence |
+| **Council**| `council` | Adversarial Research Panel | Institutional consensus | Formal verification critic panel, candidate scoring, and audit |
 
 ---
 
-## 🚀 Quickstart & Runtime Integration
+## Runtime Integration & Usage
 
 ### 1. llama.cpp / LM Studio
-Pass any family template via the `--chat-template-file` flag:
+Supply any family template directly to `llama-cli` or `llama-server`:
 ```bash
 # Default Proteus dynamic reasoning:
-llama-cli -m model.gguf --chat-template-file templates/qwen.jinja -p "Refactor this async worker"
+llama-cli -m model.gguf --chat-template-file templates/qwen.jinja -p "Implement a lock-free ring buffer in Rust"
 
 # Explicit level steering:
-llama-cli -m model.gguf --chat-template-file templates/qwen.jinja -p "[L4] Refactor this async worker"
+llama-cli -m model.gguf --chat-template-file templates/qwen.jinja -p "[L4] Implement a lock-free ring buffer in Rust"
 ```
 
 ### 2. Ollama Modelfile
@@ -101,54 +117,66 @@ tokenizer = AutoTokenizer.from_pretrained("Qwen/Qwen2.5-32B-Instruct")
 with open("templates/qwen.jinja") as f:
     tokenizer.chat_template = f.read()
 
-# Dynamic default:
+# Dynamic default execution:
 prompt = tokenizer.apply_chat_template(
     [{"role": "user", "content": "Prove that every planar graph is 5-colorable."}],
     tokenize=False,
     add_generation_prompt=True
 )
 
-# Explicit level:
+# Explicit tier selection via kwarg:
 prompt_athena = tokenizer.apply_chat_template(
-    [{"role": "user", "content": "Refactor this code"}],
+    [{"role": "user", "content": "Refactor this database connection pool"}],
     reasoning_effort="athena",
     tokenize=False,
     add_generation_prompt=True
 )
 ```
 
+### 4. vLLM / SGLang / Open WebUI
+Pass standard OpenAI-compatible parameters in the payload:
+```json
+{
+  "model": "Qwen3.8-27B-Protium",
+  "messages": [{"role": "user", "content": "Design an async event bus"}],
+  "reasoning_effort": "proteus"
+}
+```
+
 ---
 
-## 🎯 Steering Controls
+## Steering & Control Syntax
+
+Protium-1.0 supports instant mid-session steering via inline tags or standard API kwargs:
 
-- **Inline Steering**:
-  - `[L10]` or `{REASON:proteus}`: Dynamic unconstrained adaptive reasoning (Default).
-  - `[L4]` or `{REASON:athena}`: Locks to Athena modular balance.
-  - `[L8]` or `{REASON:einstein}`: Locks to Einstein theoretical level.
-  - `[regular]` or `[vanilla]`: Pure clean zero-overhead template without think tags.
-  - `{REASON:i8}`: Silent execution (runs L8 cognitive rigor internally without emitting `<think>`).
-- **Runtime Kwargs**:
-  - `reasoning_effort="10"|"proteus"|"dynamic"|"auto"`
-  - `reasoning_effort="1".."9"` or named levels (`hermes`, `apollo`, `artemis`, `athena`, `prometheus`, `solstice`, `hyperion`, `einstein`, `oracle`, `swarm`, `council`)
-  - `regular=True` or `mode="vanilla"` (zero overhead)
+* **Inline Steering Tags** (case-insensitive, cleanly stripped prior to model consumption):
+  * `[L10]` or `{REASON:proteus}`: Dynamic unconstrained adaptive reasoning (Default).
+  * `[L4]` or `{REASON:athena}`: Fixed Athena strategic architecture.
+  * `[L8]` or `{REASON:einstein}`: Fixed Einstein theoretical reduction.
+  * `[regular]` or `[vanilla]`: Pure vanilla chat template with zero system directives or thinking tokens.
+  * `{REASON:i8}`: Silent execution (applies Level 8 analytical rigor internally while suppressing `<think>` emission).
+* **Runtime API Kwargs**:
+  * `reasoning_effort="10"|"proteus"|"dynamic"|"auto"`
+  * `reasoning_effort="1".."9"` or named levels (`hermes`, `apollo`, `artemis`, `athena`, `prometheus`, `solstice`, `hyperion`, `einstein`, `oracle`, `swarm`, `council`)
+  * `regular=True` or `mode="vanilla"` (zero-overhead execution)
 
 ---
 
-## 📂 Model Family Templates
+## Cross-Family Architecture Matrix
 
-| Family | Template File | Native Tokens |
+| Model Family | Template Path | Special Token Implementation |
 |---|---|---|
-| **Universal / ChatML** | `templates/universal.jinja` | `<\|im_start\|>`, `<\|im_end\|>` |
-| **Qwen 2.5 / 3.8** | `templates/qwen.jinja` | `<\|im_start\|>`, `<\|im_end\|>`, Vision |
-| **DeepSeek Native** | `templates/deepseek.jinja` | `<｜User｜>`, `<｜Assistant｜>`, DSML |
-| **Llama 3 / 4** | `templates/llama3.jinja` | `<\|start_header_id\|>`, `<\|eot_id\|>` |
+| **Universal / ChatML** | `templates/universal.jinja` | `<|im_start|>`, `<|im_end|>` |
+| **Qwen 2.5 / 3.8 / Omni** | `templates/qwen.jinja` | `<|im_start|>`, `<|im_end|>`, Spatial/Temporal Vision |
+| **DeepSeek Native** | `templates/deepseek.jinja` | `<｜User｜>`, `<｜Assistant｜>`, Native DSML Tool Format |
+| **Meta Llama 3 / 4** | `templates/llama3.jinja` | `<|start_header_id|>`, `<|eot_id|>` |
 | **Mistral / Mixtral** | `templates/mistral.jinja` | `[INST]`, `[/INST]` |
 | **Google Gemma 2 / 3** | `templates/gemma.jinja` | `<start_of_turn>`, `<end_of_turn>` |
-| **Zhipu GLM 4 / 5** | `templates/glm.jinja` | `[gMASK]<sop>`, `<\|user\|>`, `<\|assistant\|>` |
-| **Vanilla Standalone** | `templates/regular_*.jinja` | Zero-overhead clean templates |
+| **Zhipu GLM 4 / 5.3** | `templates/glm.jinja` | `[gMASK]<sop>`, `<|user|>`, `<|assistant|>` |
+| **Vanilla Standalone** | `templates/regular_*.jinja` | Zero-overhead clean reference templates |
 
 ---
 
 <div align="center">
-Built with precision by <b>Solstice AI</b>.
+Developed and maintained by <b>Solstice AI</b>.
 </div>