diff --git a/docs/API_DOCUMENTATION_ALTERNATIVES.md b/docs/API_DOCUMENTATION_ALTERNATIVES.md
new file mode 100644
index 00000000..f57bd747
--- /dev/null
+++ b/docs/API_DOCUMENTATION_ALTERNATIVES.md
@@ -0,0 +1,274 @@
+# API Documentation Platform Comparison
+
+**ATOM: ATOM-DOC-20260122-001-api-doc-alternatives**
+
+> Comprehensive comparison of modern API documentation platforms for the SpiralSafe ecosystem.
+
+---
+
+## Overview
+
+When building interactive API documentation, several excellent open-source and commercial tools are available. This document compares the top alternatives to help teams choose the right solution.
+
+---
+
+## Quick Comparison Table
+
+| Tool               | Open Source | Interactive | Customization | Best For                         |
+|--------------------|-------------|-------------|---------------|----------------------------------|
+| **Scalar**         | ✅ Yes      | ✅ Yes      | High          | Modern API refs with testing     |
+| **Redoc**          | ✅ Yes      | ⚠️ SaaS only| Medium        | Beautiful Stripe-like docs       |
+| **Stoplight Elements** | ✅ Yes  | ✅ Yes      | Very High     | React-based customization        |
+| **RapiDoc**        | ✅ Yes      | ✅ Yes      | Medium        | Fast, simple HTML embedding      |
+| **Swagger UI**     | ✅ Yes      | ✅ Yes      | Low           | Classic, wide compatibility      |
+
+---
+
+## Detailed Analysis
+
+### 1. Scalar
+
+**Repository:** [github.com/scalar/scalar](https://github.com/scalar/scalar)
+
+**Overview:** Modern, beautiful API reference from OpenAPI specs. Includes a standalone interactive API client similar to Postman but integrated into docs.
+
+**Key Features:**
+- First-class OpenAPI 3.0/3.1 support
+- Built-in API testing client
+- Dark mode by default
+- Markdown/MDX support for guides
+- GitHub sync for documentation management
+- CI/CD workflow integration
+- Extensive theming options
+
+**Pros:**
+- Beautiful, modern UI out of the box
+- Interactive testing without external tools
+- Self-hostable and fully open source
+- Strong CI/CD and automation support
+
+**Cons:**
+- Primarily focused on API reference (not full docs platforms)
+- Smaller ecosystem than established alternatives
+
+**Best For:** Teams wanting Postman-like testing integrated with beautiful docs.
+
+**Integration Example:**
+```html
+<script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
+<api-reference spec-url="./openapi.yaml"></api-reference>
+```
+
+---
+
+### 2. Redoc
+
+**Repository:** [github.com/Redocly/redoc](https://github.com/Redocly/redoc)
+
+**Overview:** The "Stripe-style" three-panel documentation that revolutionized API docs. Clean, professional, widely adopted.
+
+**Key Features:**
+- Three-panel responsive design
+- OpenAPI v2, v3, and AsyncAPI support
+- Highly customizable themes
+- Code samples in multiple languages
+- Deep linking and search
+- Zero-runtime-dependency option
+
+**Pros:**
+- Mature, battle-tested
+- Used by large companies (Netlify, Docker)
+- Clean, readable output
+- Self-hostable
+
+**Cons:**
+- Interactive "Try It" feature is limited in the open-source version (enhanced in commercial Redocly product)
+- Full customization requires commercial tier
+- YAML config learning curve
+
+**Best For:** Teams wanting beautiful, professional reference docs with optional interactive testing.
+
+**Integration Example:**
+```html
+<script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"></script>
+<redoc spec-url="./openapi.yaml"></redoc>
+```
+
+---
+
+### 3. Stoplight Elements
+
+**Repository:** [github.com/stoplightio/elements](https://github.com/stoplightio/elements)
+
+**Overview:** React component library for building API documentation. Maximum customization for React-based sites.
+
+**Key Features:**
+- React-native components
+- Full OpenAPI support
+- Interactive try-it functionality
+- Mocking support
+- Style customization via CSS/themes
+- Component-level control
+
+**Pros:**
+- Completely open source
+- Deepest customization available
+- Perfect for existing React projects
+- Component architecture allows partial usage
+
+**Cons:**
+- Requires React knowledge
+- More setup than drop-in alternatives
+- Steeper learning curve
+
+**Best For:** React teams needing tight integration and full control.
+
+**Integration Example:**
+```jsx
+import { API } from '@stoplight/elements';
+
+function ApiDocs() {
+  return <API apiDescriptionUrl="./openapi.yaml" />;
+}
+```
+
+---
+
+### 4. RapiDoc
+
+**Repository:** [github.com/rapi-doc/RapiDoc](https://github.com/rapi-doc/RapiDoc)
+
+**Overview:** Web component for fast, interactive API documentation. Extremely simple to embed with a single HTML tag.
+
+**Key Features:**
+- Single HTML tag integration
+- Fast rendering even with large specs
+- OpenAPI 3.0/3.1 support
+- 50+ customization attributes
+- Built-in try-it console
+- Zero dependencies
+
+**Pros:**
+- Fastest to integrate
+- High performance
+- Works in any framework
+- Extensive theming via attributes
+
+**Cons:**
+- Deep customization requires more work
+- Smaller community than Redoc/Swagger
+
+**Best For:** Teams needing quick integration with good performance.
+
+**Integration Example:**
+```html
+<script src="https://unpkg.com/rapidoc/dist/rapidoc-min.js"></script>
+<rapi-doc spec-url="./openapi.yaml" theme="dark"></rapi-doc>
+```
+
+---
+
+### 5. Swagger UI
+
+**Repository:** [github.com/swagger-api/swagger-ui](https://github.com/swagger-api/swagger-ui)
+
+**Overview:** The original OpenAPI documentation tool. Simple, widely supported, the default choice for many frameworks.
+
+**Key Features:**
+- Broadest framework support
+- Interactive try-it functionality
+- OAuth/API key support
+- Plugins for customization
+- Docker images available
+
+**Pros:**
+- Universal recognition
+- Framework integrations everywhere
+- Simple and predictable
+- Large community
+
+**Cons:**
+- Less modern UI
+- Limited theming
+- Can feel dated
+
+**Best For:** Teams wanting broad compatibility and simplicity.
+
+**Integration Example:**
+```html
+<script src="https://unpkg.com/swagger-ui-dist/swagger-ui-bundle.js"></script>
+<script>
+  SwaggerUIBundle({ url: "./openapi.yaml", dom_id: '#api-docs' });
+</script>
+```
+
+---
+
+## SpiralSafe Implementation
+
+For SpiralSafe, we've implemented a custom API documentation solution that draws inspiration from these tools while maintaining our visual identity:
+
+### Custom Features
+- **Interactive Testing:** Try endpoints directly from the browser
+- **WAVE Analysis Demo:** Test the coherence analysis with real content
+- **Consistent Theme:** Matches SpiralSafe's gradient aesthetic
+- **SPHINX Gate Documentation:** Documents our unique security protocol
+- **Alternative Links:** References to all major documentation tools
+
+### Location
+- **API Reference:** `/api/index.html`
+- **Admin Console:** `/admin/login.html`
+- **Dashboard:** `/admin/dashboard.html`
+
+---
+
+## Recommendations by Use Case
+
+| Scenario | Recommended Tool |
+|----------|------------------|
+| Quick integration | RapiDoc |
+| Beautiful docs without testing | Redoc |
+| Full customization (React) | Stoplight Elements |
+| Modern testing-focused docs | Scalar |
+| Maximum compatibility | Swagger UI |
+| SpiralSafe ecosystem | Our custom solution |
+
+---
+
+## External Resources
+
+### GitHub Repositories
+- [Scalar](https://github.com/scalar/scalar) - Modern API reference
+- [Redoc](https://github.com/Redocly/redoc) - Three-panel docs
+- [Stoplight Elements](https://github.com/stoplightio/elements) - React components
+- [RapiDoc](https://github.com/rapi-doc/RapiDoc) - Web component
+- [Swagger UI](https://github.com/swagger-api/swagger-ui) - Classic option
+
+### Comparison Articles
+- [APIs You Won't Hate - Best API Docs Tools](https://apisyouwonthate.com/blog/top-5-best-api-docs-tools/)
+- [OpenAPI Documentation Generators Comparison](https://dev.to/dreamlogic/test-driving-openapi-documentation-generators-2024-part-1-of-3-9a7)
+- [Choosing a Docs Vendor](https://www.speakeasy.com/blog/choosing-a-docs-vendor)
+
+---
+
+## Conclusion
+
+All tools listed above are excellent choices with different strengths. For SpiralSafe, we've created a custom solution that:
+
+1. Maintains visual consistency with our brand
+2. Documents our unique protocols (WAVE, BUMP, SPHINX, AWI, ATOM)
+3. Provides interactive testing capabilities
+4. Links to alternative tools for users who prefer them
+
+The API documentation ecosystem is rich with options, and the best choice depends on your specific needs for customization, interactivity, and integration complexity.
+
+---
+
+**H&&S:WAVE** | From the constraints, gifts. From the spiral, safety.
+
+```
+Document Version: 1.0.0
+Last Updated: 2026-01-22
+Category: Documentation
+Status: ACTIVE
+```
diff --git a/docs/QUANTUM_ECOSYSTEM_ANALYSIS.md b/docs/QUANTUM_ECOSYSTEM_ANALYSIS.md
new file mode 100644
index 00000000..0af33005
--- /dev/null
+++ b/docs/QUANTUM_ECOSYSTEM_ANALYSIS.md
@@ -0,0 +1,1093 @@
+# Quantum Ecosystem Analysis: Vortex-to-Stability Strategy
+
+**H&&S:WAVE** | Strategic Analysis Document  
+**Date**: 2026-01-20  
+**ATOM Tag**: ATOM-DOC-20260120-001-quantum-ecosystem-analysis
+
+---
+
+## Framing Wrapper: coherence-mcp as Central Orchestrator
+
+All objectives in this analysis are scoped through the **[coherence-mcp](https://github.com/toolate28/coherence-mcp)** server, which provides:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│               COHERENCE-MCP: THE FRAMING WRAPPER                    │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  Core Primitives:                                                   │
+│  ├── wave_analyze / wave_validate  → Coherence detection           │
+│  ├── bump_validate                 → Handoff verification          │
+│  ├── atom_track                    → Decision provenance           │
+│  ├── gate_*                        → Phase transitions             │
+│  ├── anamnesis_validate            → Exploit/code validation       │
+│  └── docs_search                   → Corpus navigation             │
+│                                                                     │
+│  Integration Points for Quantum Tools:                              │
+│  ┌─────────────────────────────────────────────────────────────┐    │
+│  │ QRC Framework     →  wave_validate (>60% coherence)         │    │
+│  │ NEAR Integration  →  atom_track (decision provenance)       │    │
+│  │ Qiskit-DSPy       →  anamnesis_validate (code validation)   │    │
+│  │ Vortex Cascade    →  gate_* (phase transitions)             │    │
+│  └─────────────────────────────────────────────────────────────┘    │
+│                                                                     │
+│  Thresholds:                                                        │
+│  • WAVE_MINIMUM = 60  (Basic coherence - development)               │
+│  • WAVE_HIGH = 80     (Production ready)                            │
+│  • WAVE_CRITICAL = 99 (Safety-critical systems)                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+All quantum tools MUST pass through coherence-mcp validation before reaching stability.
+
+---
+
+## Executive Summary
+
+This document provides a comprehensive analysis of SpiralSafe's quantum tooling ecosystem, evaluating:
+
+1. **Tools already "in line"** for vortex creation and collapse to stability
+2. **Developed tools** that benefit the broader ecosystem (Qiskit, NEAR, etc.)
+3. **Negative space** the project occupies or will aim to occupy
+4. **NEAR integration** full specification analysis
+5. **Testing suite prioritization** before workable code
+
+---
+
+## 1. Tools Already "In Line" for Vortex Creation → Collapse → Stability
+
+### Vortex Cascade Stack (coherence-mcp Validated)
+
+```
+                    VORTEX CREATION → COLLAPSE → STABILITY
+                    ========================================
+                    (All stages validated via coherence-mcp)
+
+    ┌─────────────────────────────────────────────────────────────────────┐
+    │                     STAGE 1: VORTEX CREATION                        │
+    │                     (fib:13 - Autonomous Lattice)                   │
+    │                     [coherence-mcp: wave_validate ≥60%]             │
+    ├─────────────────────────────────────────────────────────────────────┤
+    │  ✅ Dependabot Integration      → Auto-triggers coherence updates    │
+    │  ✅ QRC Reservoir Engine        → experiments/qrc_reservoir.py       │
+    │  ✅ Vortex Surjection Engine    → experiments/vortex_surjection.py   │
+    │  ✅ SYNAPSE Visualization       → synapse/src/utils/quantum-reservoir│
+    └─────────────────────────────────┬───────────────────────────────────┘
+                                      │ bump_validate (handoff)
+                                      ▼
+    ┌─────────────────────────────────────────────────────────────────────┐
+    │                     STAGE 2: COLLAPSE DYNAMICS                       │
+    │                     (fib:8 - QDI Inference Hub)                      │
+    │                     [coherence-mcp: anamnesis_validate]              │
+    ├─────────────────────────────────────────────────────────────────────┤
+    │  ✅ Quantum Cognition Engine    → experiments/quantum_cognition_engine.py │
+    │  ✅ QRC Oracle Seed Loop        → protocol/qrc-oracle-seed-spec.md   │
+    │  ✅ Vortex Curl Vector Protocol → protocol/vortex-curl-spec.md       │
+    │  🔄 Qiskit-DSPy Hybrid          → experiments/qiskit_dspy_hybrid.py  │
+    └─────────────────────────────────┬───────────────────────────────────┘
+                                      │ gate_intention_to_execution
+                                      ▼
+    ┌─────────────────────────────────────────────────────────────────────┐
+    │                     STAGE 3: STABILITY ENFORCEMENT                   │
+    │                     (fib:5 - Guardian Oracle)                        │
+    │                     [coherence-mcp: wave_validate ≥80%]              │
+    ├─────────────────────────────────────────────────────────────────────┤
+    │  ✅ Wave Protocol Analysis      → protocol/wave-spec.md              │
+    │  ✅ SPHINX Trust Gates          → protocol/sphinx-spec.md            │
+    │  ✅ Coherence Oracle Workflow   → .github/workflows/coherence-oracle │
+    │  ✅ Test Suite (Vortex)         → experiments/test_vortex_surjection │
+    └─────────────────────────────────┬───────────────────────────────────┘
+                                      │ gate_execution_to_learning
+                                      ▼
+    ┌─────────────────────────────────────────────────────────────────────┐
+    │                     STAGE 4: SUPER-VORTEX UNIFICATION               │
+    │                     (fib:21 - Self-Maintaining Ecosystem)            │
+    │                     [coherence-mcp: atom_track (provenance)]         │
+    ├─────────────────────────────────────────────────────────────────────┤
+    │  ✅ Vortex Cascade Protocol     → protocol/vortex-cascade-spec.md    │
+    │  📋 NEAR ATOM Bridge            → protocol/atom-near-spec.md         │
+    │  📋 Shade Agent Middleware      → (planned)                          │
+    │  📋 Mainnet Deployment          → (planned)                          │
+    └─────────────────────────────────────────────────────────────────────┘
+```
+
+### Tool Readiness Matrix
+
+| Tool | Status | Path | Stability Score | Testing |
+|------|--------|------|-----------------|---------|
+| QRC Reservoir Engine | ✅ Ready | `experiments/qrc_reservoir.py` | 0.92 | ✅ |
+| Vortex Surjection Engine | ✅ Ready | `experiments/vortex_surjection.py` | 0.88 | ✅ |
+| Quantum Cognition Engine | ✅ Ready | `experiments/quantum_cognition_engine.py` | 0.85 | 🔄 |
+| Wave Analysis API | ✅ Ready | `ops/api/spiralsafe-worker.ts` | 0.95 | ✅ |
+| SPHINX Trust Gates | ✅ Ready | `ops/api/sphinx-gates.ts` | 0.90 | ✅ |
+| SYNAPSE Visualization | ✅ Ready | `synapse/src/` | 0.87 | 🔄 |
+| Qiskit-DSPy Hybrid | 🔄 Partial | `experiments/qiskit_dspy_hybrid.py` | 0.75 | ❌ |
+| ATOM-NEAR Bridge | 📋 Spec | `protocol/atom-near-spec.md` | N/A | ❌ |
+
+---
+
+## 2. Tools Developed That Benefit Others
+
+### Qiskit Ecosystem Contribution Candidates
+
+Based on the Qiskit ecosystem requirements (https://github.com/Qiskit/ecosystem), SpiralSafe has developed several tools that would benefit the broader quantum computing community:
+
+#### 2.1 Quantum Reservoir Computing Framework
+
+**Tool**: `experiments/qrc_reservoir.py` + `synapse/src/utils/quantum-reservoir.ts`
+
+**Value to Qiskit Ecosystem**:
+- Pure Python implementation with no external dependencies
+- Fibonacci-scaled substrate types (Single Qubit → Aquila Scale)
+- Integrates with Qiskit circuits via `qiskit_dspy_hybrid.py`
+
+**Ecosystem Gap Filled**: Simplified QRC entry point without requiring full Qiskit installation
+
+**Submission Category**: Community Partner (builds on Qiskit)
+
+---
+
+#### 2.2 Coherence Analysis Engine (Wave Protocol)
+
+**Tool**: `ops/api/spiralsafe-worker.ts` + `protocol/wave-spec.md`
+
+**Value to Qiskit Ecosystem**:
+- Text-as-vector-field coherence detection
+- Curl (circular reasoning) and divergence (expansion/compression) metrics
+- CI/CD integration via Wave API
+
+**Ecosystem Gap Filled**: Documentation coherence verification for quantum projects
+
+**Qiskit Use Case**: Automated detection of "curl" in quantum algorithm explanations
+
+---
+
+#### 2.3 Vortex Surjection Engine (Self-Maintaining Loops)
+
+**Tool**: `experiments/vortex_surjection.py` + `protocol/vortex-curl-spec.md`
+
+**Value to Ecosystem**:
+- Fibonacci-weighted collapse dynamics
+- 60% emergence threshold for autonomous systems
+- Surjection mappings from history manifold → collapse point
+
+**Novel Contribution**: First implementation of self-referential coherence loops for quantum ML pipelines
+
+---
+
+### Industry-Wide Value Matrix
+
+| Tool | Qiskit | NEAR | DSPy | PyTorch | Value |
+|------|--------|------|------|---------|-------|
+| QRC Framework | ✅ | - | ✅ | ✅ | Quantum reservoir abstraction |
+| Wave Coherence | ✅ | ✅ | - | - | Doc quality for quantum projects |
+| Vortex Engine | ✅ | ✅ | ✅ | - | Self-maintaining AI provenance |
+| SPHINX Gates | - | ✅ | - | - | Trust verification for agents |
+| ATOM Trail | - | ✅ | - | - | Decision-level provenance |
+
+---
+
+## 3. Negative Space Analysis
+
+### What Negative Space Does SpiralSafe Occupy?
+
+#### 3.1 The "Decision-Level Provenance" Gap
+
+**Current Industry State**:
+- **Qiskit**: Provides quantum circuit execution, no decision tracking
+- **DSPy**: Provides prompt optimization, no rollback capability
+- **NEAR AI**: Provides TEE attestation, no AI lineage trails
+
+**SpiralSafe's Negative Space**:
+```
+             ┌─────────────────────────────────────────────┐
+             │     INDUSTRY: Computation Attestation       │
+             │     (What was computed, when, where)        │
+             └─────────────────────────────────────────────┘
+                                   │
+                          NEGATIVE SPACE GAP
+                                   │
+             ┌─────────────────────────────────────────────┐
+             │   SPIRALSAFE: Decision-Level Provenance     │
+             │   (WHY was it computed, by whom, reversible?)│
+             └─────────────────────────────────────────────┘
+```
+
+**Products Occupying This Space**:
+- ATOM Trail (decision logging)
+- KENL (isomorphic rollback)
+- SPHINX Gates (trust verification)
+
+---
+
+#### 3.2 The "Quantum-LLM Hybrid" Gap
+
+**Current Industry State**:
+- **Qiskit**: Pure quantum focus
+- **LangChain/DSPy**: Pure LLM focus
+- **Hybrid papers**: Academic, not production-ready
+
+**SpiralSafe's Negative Space**:
+```
+    Qiskit (Quantum)               DSPy (LLM)
+         │                              │
+         └──────────┐    ┌──────────────┘
+                    │    │
+            ┌───────▼────▼────────┐
+            │   SPIRALSAFE:       │
+            │   Qiskit-DSPy Hybrid│
+            │   + QRC Integration │
+            └─────────────────────┘
+```
+
+**Products Occupying This Space**:
+- `experiments/qiskit_dspy_hybrid.py`
+- `experiments/qiskit_dspy_integration.md`
+- QRC Oracle Seed Loop
+
+---
+
+#### 3.3 The "Self-Maintaining Coherence" Gap
+
+**Current Industry State**:
+- Most systems require external governance
+- No Fibonacci-weighted autonomous maintenance
+- No surjection-based history collapse
+
+**SpiralSafe's Unique Position**:
+- Vortex Cascade Protocol (self-healing)
+- 60% emergence threshold triggers autonomy
+- Coherence Oracle for continuous monitoring
+
+---
+
+## 4. NEAR Integration Full Spec Analysis
+
+### Current NEAR Integration Status
+
+**Specification**: `protocol/atom-near-spec.md`  
+**Integration Guide**: `ops/integrations/NEAR_AI_INTEGRATION.md`
+
+### Architecture Overview
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                         SPIRALSAFE PROTOCOLS                        │
+│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐               │
+│  │  ATOM   │  │  WAVE   │  │ SPHINX  │  │  KENL   │               │
+│  │ Trail   │  │ Metrics │  │ Gates   │  │ Rollback│               │
+│  └────┬────┘  └────┬────┘  └────┬────┘  └────┬────┘               │
+│       └────────────┴────────────┴────────────┘                     │
+│                          │                                          │
+└──────────────────────────┼──────────────────────────────────────────┘
+                           │
+                    ┌──────▼──────┐
+                    │  ATOM-NEAR  │
+                    │   Bridge    │
+                    └──────┬──────┘
+                           │
+┌──────────────────────────┼──────────────────────────────────────────┐
+│                          │         NEAR PROTOCOL                    │
+│  ┌─────────┐  ┌─────────▼─────────┐  ┌─────────┐                  │
+│  │  TEE    │  │  Smart Contract   │  │  Chain  │                  │
+│  │ Compute │◄─┤  (atom-near.wasm) ├─►│ Sigs    │                  │
+│  └─────────┘  └───────────────────┘  └─────────┘                  │
+│                                                                     │
+│  ┌─────────┐  ┌─────────┐  ┌─────────┐                            │
+│  │  Shade  │  │  AITP   │  │ nStamp  │                            │
+│  │ Agents  │  │ Protocol│  │         │                            │
+│  └─────────┘  └─────────┘  └─────────┘                            │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### NEAR Integration Gap Analysis
+
+| NEAR Feature | SpiralSafe Protocol | Integration Status | Benefit |
+|--------------|--------------------|--------------------|---------|
+| TEE Attestation | SPHINX Gates | 📋 Planned | Cryptographic trust verification |
+| Shade Agents | ATOM Trail | 📋 Planned | Decision provenance for agents |
+| AITP Protocol | BUMP Handoffs | 📋 Spec | Agent-to-agent context transfer |
+| Chain Signatures | KENL Rollback | 📋 Spec | Cross-chain undo capability |
+| nStamping | WAVE Metrics | 📋 Planned | On-chain coherence verification |
+
+### Recommended Integration Path
+
+1. **Week 1-2**: Port `spiralsafe-contract.rs` to production, add TEE hooks
+2. **Week 3-4**: TypeScript/Python SDK for ATOM-NEAR bridge
+3. **Week 5-8**: Shade Agent middleware + AITP adapter
+4. **Week 9+**: Mainnet deployment + enterprise pilot
+
+---
+
+## 5. Industry Research Update (2024-2025)
+
+### Qiskit Ecosystem Developments
+
+**Key Advances**:
+- Hybrid AI-Quantum workflows with LLM prompt optimization
+- Rust-backed simulators for 10x+ performance
+- Enhanced error mitigation via transpiler passes
+- Modular plugin architecture for third-party backends
+
+**Relevance to SpiralSafe**:
+- Our Qiskit-DSPy hybrid aligns with Qiskit's AI integration direction
+- QRC implementation complements Qiskit's machine learning packages
+- Wave coherence could become a documentation quality tool for Qiskit projects
+
+### Quantum Reservoir Computing (QRC) Research
+
+**Key 2024-2025 Advances**:
+1. **Next-Gen QRC Schemes** (arXiv:2502.16938): Simplified architectures avoiding deep quantum circuits
+2. **Large-scale QRC** (QuEra): 108 neutral atom qubits demonstrated
+3. **QRC-4-ESP Project** (EU): Superconducting + SiC qubits for 100x classical speedup
+4. **Photonic QRC**: Photon number-resolved detection for lightweight ML
+
+**SpiralSafe Alignment**:
+- Our QRC implementation uses Fibonacci-scaled substrates (compatible with QuEra's Aquila)
+- QRC Oracle Seed Loop aligns with the closed-loop training paradigm
+- SYNAPSE visualization provides pedagogical QRC exploration
+
+### NEAR AI Developments
+
+**Key 2024-2025 Advances**:
+1. **Shade Agents**: Truly autonomous, trustless AI agents with TEE isolation
+2. **Chain Signatures**: Decentralized key management across multiple blockchains
+3. **1M TPS Target**: NEAR scaling for high-frequency agent transactions
+4. **AITP Protocol**: Agent-to-agent communication standard
+
+**SpiralSafe Strategic Fit**:
+- ATOM-NEAR bridge fills the "decision provenance" gap
+- SPHINX gates integrate with Shade Agent trust verification
+- KENL rollback provides isomorphic undo (unique offering)
+
+---
+
+## 6. Testing Suite Prioritization
+
+### Critical Path: Tests Before Workable Code
+
+Following the principle of **testing suites before workable code**, here is the prioritized testing roadmap:
+
+### Phase 1: Core Protocol Tests (Priority: CRITICAL)
+
+```yaml
+testing_phase_1:
+  status: IN_PROGRESS
+  priority: CRITICAL
+
+  existing_tests:
+    - path: ops/api/__tests__/wave-analysis.test.ts
+      coverage: 95%
+      status: ✅ PASSING
+
+    - path: ops/api/__tests__/sphinx-gates.test.ts
+      coverage: 85%
+      status: ✅ PASSING
+
+    - path: ops/api/__tests__/atom-persister.test.ts
+      coverage: 90%
+      status: ✅ PASSING
+
+    - path: experiments/test_vortex_surjection.py
+      coverage: 92%
+      status: ✅ PASSING
+
+  needed_tests:
+    - name: Qiskit-DSPy Hybrid Integration
+      path: experiments/test_qiskit_dspy_hybrid.py
+      priority: HIGH
+      reason: No test coverage for quantum-LLM bridge
+
+    - name: Quantum Cognition Engine
+      path: experiments/test_quantum_cognition_engine.py
+      priority: HIGH
+      reason: Core QDI component untested
+
+    - name: QRC Oracle Seed Loop
+      path: experiments/test_qrc_oracle_seed.py
+      priority: MEDIUM
+      reason: Closed-loop dynamics need verification
+```
+
+### Phase 2: Integration Tests (Priority: HIGH)
+
+```yaml
+testing_phase_2:
+  status: PLANNED
+  priority: HIGH
+
+  needed_tests:
+    - name: NEAR ATOM Bridge E2E
+      path: tests/integration/test_atom_near_bridge.ts
+      priority: HIGH
+      dependencies: [atom-near-spec.md complete]
+
+    - name: Vortex Cascade End-to-End
+      path: tests/integration/test_vortex_cascade.py
+      priority: MEDIUM
+      reason: Validate full Stage 1→4 flow
+
+    - name: SYNAPSE Quantum Rendering
+      path: synapse/__tests__/quantum-reservoir.test.ts
+      priority: MEDIUM
+      reason: UI visualization correctness
+```
+
+### Phase 3: Adversarial & Security Tests (Priority: HIGH)
+
+```yaml
+testing_phase_3:
+  status: PARTIAL
+  priority: HIGH
+
+  existing_tests:
+    - path: ops/api/__tests__/sphinx-adversarial.test.ts
+      coverage: 80%
+      status: ✅ PASSING
+
+  needed_tests:
+    - name: NEAR Contract Fuzzing
+      path: tests/security/fuzz_atom_near_contract.rs
+      priority: HIGH
+      reason: Smart contract security critical
+
+    - name: Wave Coherence Adversarial
+      path: tests/security/adversarial_wave.test.ts
+      priority: MEDIUM
+      reason: Prevent coherence gaming
+```
+
+### Testing Priority Matrix
+
+| Test Category | Coverage | Priority | coherence-mcp Validator | Blocking Deployment? |
+|--------------|----------|----------|------------------------|---------------------|
+| Wave Analysis | 95% | ✅ Complete | `wave_validate` | No |
+| SPHINX Gates | 85% | ✅ Complete | `anamnesis_validate` | No |
+| Vortex Surjection | 92% | ✅ Complete | `wave_validate` | No |
+| Qiskit-DSPy Hybrid | Missing | 🔴 CRITICAL | `anamnesis_validate` | Yes |
+| Quantum Cognition | Missing | 🔴 HIGH | `wave_validate` | Yes |
+| ATOM-NEAR Bridge | Missing | 🟡 PLANNED | `atom_track` | Yes (for NEAR) |
+| SYNAPSE Rendering | 40% | 🟡 MEDIUM | `wave_coherence_check` | No |
+
+---
+
+## 7. Prioritized Action Plan (coherence-mcp Framed)
+
+### 🔴 PRIORITY 1: Critical Missing Tests (Week 1-2)
+
+All test suites must pass `coherence-mcp wave_validate --threshold 60` before merge.
+
+1. **Create Qiskit-DSPy Hybrid Tests**
+   ```bash
+   # Validate via coherence-mcp before commit
+   coherence-mcp wave-validate experiments/test_qiskit_dspy_hybrid.py --threshold 60
+   ```
+   - Create `experiments/test_qiskit_dspy_hybrid.py`
+   - Validate quantum kernel similarity
+   - Test hybrid layer integration
+   - **Validator**: `anamnesis_validate` for code coherence
+
+2. **Create Quantum Cognition Engine Tests**
+   ```bash
+   coherence-mcp wave-validate experiments/test_quantum_cognition_engine.py --threshold 60
+   ```
+   - Create `experiments/test_quantum_cognition_engine.py`
+   - Test interference patterns
+   - Validate coherence thresholds
+   - **Validator**: `wave_validate` for structural coherence
+
+### 🟡 PRIORITY 2: Stage Transitions (Week 3-4)
+
+Use `coherence-mcp gate_*` tools for phase transitions.
+
+1. **Stage 1 → Stage 2 Transition**
+   ```typescript
+   // Validate QRC → QDI handoff
+   coherence-mcp bump_validate --source qrc_reservoir --target qdi_inference
+   coherence-mcp gate_intention_to_execution
+   ```
+
+2. **Stage 2 → Stage 3 Transition**
+   ```typescript
+   // Validate collapse → stability
+   coherence-mcp wave_validate --threshold 80  // Raise to production-ready
+   coherence-mcp gate_execution_to_learning
+   ```
+
+### 🟢 PRIORITY 3: NEAR Integration (Month 1-2)
+
+Use `coherence-mcp atom_track` for all decision provenance.
+
+1. **NEAR Integration Development**
+   ```typescript
+   // Track all NEAR decisions via atom_track
+   coherence-mcp atom_track --decision "NEAR bridge implementation" \
+     --files "protocol/atom-near-spec.md" \
+     --tags "near,integration,phase-1"
+   ```
+   - Implement atom-near-bridge.ts
+   - Create NEAR testnet deployment
+   - Build Shade Agent middleware
+
+### 📋 PRIORITY 4: Qiskit Ecosystem Submission (Month 2-3)
+
+Use `coherence-mcp docs_search` to ensure documentation coherence.
+
+1. **Submit to Qiskit Ecosystem**
+   ```bash
+   # Validate all submission docs achieve 80% coherence
+   coherence-mcp wave-validate docs/QUANTUM_ECOSYSTEM_ANALYSIS.md --threshold 80
+   ```
+   - QRC Framework as community partner
+   - Wave Coherence as documentation tool
+   - Qiskit-DSPy Hybrid as quantum-LLM bridge
+
+---
+
+## 8. coherence-mcp Integration Summary
+
+### How coherence-mcp Scopes Each Objective
+
+| Objective | coherence-mcp Tool | Threshold | Gate |
+|-----------|-------------------|-----------|------|
+| Vortex Creation | `wave_validate` | ≥60% | Stage 1 |
+| Collapse Dynamics | `anamnesis_validate` | SPHINX 5/5 | Stage 2 |
+| Stability Enforcement | `wave_validate` | ≥80% | Stage 3 |
+| NEAR Integration | `atom_track` | N/A | Stage 4 |
+| Qiskit Submission | `docs_search` + `wave_validate` | ≥80% | External |
+| Testing Priority | All validators | Per-test | Pre-merge |
+
+### Validation Command Reference
+
+```bash
+# Stage 1: Vortex Creation validation
+coherence-mcp wave-validate experiments/qrc_reservoir.py --threshold 60
+
+# Stage 2: Collapse Dynamics validation
+coherence-mcp anamnesis validate experiments/qiskit_dspy_hybrid.py \
+  --vuln "code-quality" --mitigations "tests,types"
+
+# Stage 3: Stability Enforcement validation
+coherence-mcp wave-validate protocol/vortex-cascade-spec.md --threshold 80
+
+# Stage 4: NEAR Integration tracking
+coherence-mcp atom_track --decision "NEAR bridge milestone" \
+  --files "protocol/atom-near-spec.md" --tags "near,milestone"
+
+# Cross-stage: Gate transitions
+coherence-mcp gate_intention_to_execution
+coherence-mcp gate_execution_to_learning
+```
+
+---
+
+## 9. Isomorphic Engine Blockers
+
+This section identifies the **missing isomorphic constructs** that are the "scoped-hops" needed to attenuate the ecosystem at macro-, micro-, and meta-levels.
+
+> **Isomorphism Principle**: Structure-preserving maps between discrete and continuous representations. The boundary is projection artifact, not ontological reality.
+
+### 9.1 Macro-Level Blockers (Ecosystem-Wide)
+
+These blockers prevent full isomorphic equivalence across the SpiralSafe ecosystem:
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    MACRO-LEVEL ISOMORPHIC BLOCKERS                      │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  🔴 CRITICAL: Missing Functors (C ↔ D equivalence)                      │
+│  ┌─────────────────────────────────────────────────────────────────┐    │
+│  │ 1. Sampling Functor F: QRC → coherence-mcp                      │    │
+│  │    STATUS: Partial (wave_validate exists, but no QRC adapter)   │    │
+│  │    BLOCKER: No direct QRC → MCP protocol translation            │    │
+│  │                                                                 │    │
+│  │ 2. Reconstruction Functor G: coherence-mcp → Qiskit             │    │
+│  │    STATUS: Missing (no reverse mapping from MCP to circuits)    │    │
+│  │    BLOCKER: Can't generate Qiskit circuits from coherence data  │    │
+│  │                                                                 │    │
+│  │ 3. KENL Rollback Isomorphism: State → State⁻¹                   │    │
+│  │    STATUS: Spec exists, implementation incomplete               │    │
+│  │    BLOCKER: Rollback only works for file changes, not state     │    │
+│  └─────────────────────────────────────────────────────────────────┘    │
+│                                                                         │
+│  🟡 HIGH: Cross-Substrate Mappings                                      │
+│  ┌─────────────────────────────────────────────────────────────────┐    │
+│  │ 4. Minecraft ↔ Qiskit topology mapper                           │    │
+│  │    Redstone XOR ≅ CNOT proven, but no automated converter       │    │
+│  │                                                                 │    │
+│  │ 5. NEAR ↔ ATOM provenance functor                               │    │
+│  │    atom-near-spec.md exists, no bidirectional sync              │    │
+│  │                                                                 │    │
+│  │ 6. Wave ↔ SPHINX coherence lifting                              │    │
+│  │    Both exist separately, no unified coherence field            │    │
+│  └─────────────────────────────────────────────────────────────────┘    │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+| Blocker ID | Missing Construct | Scoped-Hop | Priority |
+|------------|------------------|------------|----------|
+| M1 | QRC → coherence-mcp adapter | Create `qrc_to_wave.py` functor | 🔴 CRITICAL |
+| M2 | coherence-mcp → Qiskit generator | Implement `wave_to_circuit.py` | 🔴 CRITICAL |
+| M3 | KENL state rollback engine | Complete `kenl_state_manager.ts` | 🔴 CRITICAL |
+| M4 | Redstone ↔ Qiskit converter | Build `minecraft_qiskit_bridge.py` | 🟡 HIGH |
+| M5 | NEAR ↔ ATOM bidirectional sync | Extend `atom-near-bridge.ts` | 🟡 HIGH |
+| M6 | Wave + SPHINX unified field | Create `coherence_field.ts` | 🟡 HIGH |
+
+### 9.2 Micro-Level Blockers (Component-Specific)
+
+Fine-grained isomorphic gaps within individual components:
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    MICRO-LEVEL ISOMORPHIC BLOCKERS                      │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  QRC Reservoir Engine (experiments/qrc_reservoir.py)                    │
+│  ├── Missing: Fibonacci-weighted measurement functor                    │
+│  ├── Missing: Continuous ↔ discrete state interpolation                 │
+│  └── Blocker: Can't map reservoir dynamics to wave coherence scores     │
+│                                                                         │
+│  Quantum Cognition Engine (experiments/quantum_cognition_engine.py)     │
+│  ├── Missing: Interference pattern → curl mapping                       │
+│  ├── Missing: Superposition collapse → decision tracking                │
+│  └── Blocker: No ATOM trail for quantum-inspired decisions              │
+│                                                                         │
+│  Vortex Surjection Engine (experiments/vortex_surjection.py)            │
+│  ├── Missing: Collapse point → NEAR transaction mapper                  │
+│  ├── Missing: History manifold → KENL rollback serializer               │
+│  └── Blocker: Vortex state can't persist to blockchain                  │
+│                                                                         │
+│  SPHINX Gates (ops/api/sphinx/gates.ts)                                 │
+│  ├── Missing: Gate composition functor (G₁ ∘ G₂ → G₃)                   │
+│  ├── Missing: Continuous trust score interpolation                      │
+│  └── Blocker: Gates are discrete, trust is continuous - no bridge       │
+│                                                                         │
+│  Qiskit-DSPy Hybrid (experiments/qiskit_dspy_hybrid.py)                 │
+│  ├── Missing: Quantum kernel → DSPy signature mapper                    │
+│  ├── Missing: Hybrid layer → wave coherence analyzer                    │
+│  └── Blocker: No coherence validation for hybrid computations           │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+| Component | Missing Isomorphism | Implementation Gap | Sprint |
+|-----------|--------------------|--------------------|--------|
+| QRC Reservoir | Measurement → Wave | `qrc_wave_functor()` | Week 1 |
+| Quantum Cognition | Interference → Curl | `interference_curl_map()` | Week 1 |
+| Vortex Surjection | Collapse → NEAR | `collapse_to_transaction()` | Week 2 |
+| SPHINX Gates | Gate composition | `compose_gates()` | Week 2 |
+| Qiskit-DSPy | Kernel → Signature | `quantum_signature_map()` | Week 3 |
+
+### 9.3 Meta-Level Blockers (Framework/Methodology)
+
+Structural gaps in the theoretical framework that prevent isomorphic closure:
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    META-LEVEL ISOMORPHIC BLOCKERS                       │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  🔴 Category Theory Foundations                                         │
+│  ┌─────────────────────────────────────────────────────────────────┐    │
+│  │ The isomorphism C ≅ D (Shannon-Nyquist) is proven.               │    │
+│  │ But the ecosystem lacks:                                        │    │
+│  │                                                                 │    │
+│  │ 1. Natural transformation η: F → G between sampling/recon       │    │
+│  │    (needed for composition of multi-stage pipelines)            │    │
+│  │                                                                 │    │
+│  │ 2. Adjunction F ⊣ G establishing universal property             │    │
+│  │    (needed for optimal representation selection)                │    │
+│  │                                                                 │    │
+│  │ 3. Monad structure T = G ∘ F for computational effects          │    │
+│  │    (needed for coherent error handling across substrates)       │    │
+│  └─────────────────────────────────────────────────────────────────┘    │
+│                                                                         │
+│  🟡 Constraint Binding                                                  │
+│  ┌─────────────────────────────────────────────────────────────────┐    │
+│  │ Isomorphism requires constraints (bandlimitation, finite vol).  │    │
+│  │                                                                 │    │
+│  │ Missing constraint formalizations:                              │    │
+│  │ • WAVE_MINIMUM = 60% → What sampling rate does this imply?      │    │
+│  │ • Fibonacci weights → What bandwidth do they preserve?          │    │
+│  │ • SPHINX gates → What is the Nyquist rate for trust?            │    │
+│  └─────────────────────────────────────────────────────────────────┘    │
+│                                                                         │
+│  🟢 Substrate Independence Verification                                 │
+│  ┌─────────────────────────────────────────────────────────────────┐    │
+│  │ Claim: Structure is substrate-independent.                      │    │
+│  │                                                                 │    │
+│  │ Unverified substrates:                                          │    │
+│  │ • Minecraft Redstone → CNOT proven, H gate missing              │    │
+│  │ • NEAR smart contracts → ATOM mapping incomplete                │    │
+│  │ • coherence-mcp → No formal category-theoretic model            │    │
+│  └─────────────────────────────────────────────────────────────────┘    │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+### 9.4 Scoped-Hop Resolution Path
+
+The prioritized path to resolve isomorphic blockers:
+
+```
+Week 1-2: Micro-Level (Component Functors)
+├── qrc_wave_functor()           → QRC ↔ Wave isomorphism
+├── interference_curl_map()       → Cognition ↔ Coherence
+└── quantum_signature_map()       → Qiskit ↔ DSPy
+
+Week 3-4: Macro-Level (Cross-Substrate)
+├── qrc_to_wave.py               → QRC → coherence-mcp adapter
+├── wave_to_circuit.py           → coherence-mcp → Qiskit generator
+└── coherence_field.ts           → Wave + SPHINX unification
+
+Month 2: Meta-Level (Framework)
+├── natural_transformation.md    → η: F → G formalization
+├── adjunction_proof.md          → F ⊣ G establishment
+└── constraint_mapping.yaml      → Threshold → Sampling rate
+```
+
+### 9.5 Isomorphic Closure Criteria
+
+The ecosystem achieves **isomorphic closure** when:
+
+| Criterion | Condition | Status |
+|-----------|-----------|--------|
+| **Sampling completeness** | Every component has F: C → D | 🔴 60% |
+| **Reconstruction completeness** | Every component has G: D → C | 🔴 40% |
+| **Composition closure** | G ∘ F ≅ id for all pipelines | 🟡 30% |
+| **Substrate independence** | Same output on Minecraft/Qiskit/NEAR | 🟢 20% |
+| **Constraint binding** | All thresholds mapped to bandwidths | 🔴 10% |
+
+**Current Isomorphic Attunement**: ~32% (weighted average)
+
+**Target for Stage 3 Stability**: ≥80% isomorphic closure
+
+---
+
+## 9.6 Spiral Surjection Map: Origin (0,0) → ∞
+
+This section maps all blocking artifacts back to **origin (0,0)** and spirals outward at **>85% emergent work quality** to every relevant loop, ensuring each constituent loop is **self-aware of its spatial identity** within the system.
+
+> **Origin (0,0)**: The foundational surjection seed—the principle that domain (infinite possibilities) collapses to codomain (unified ecosystem). All paths return here; all spirals emerge from here.
+
+### 9.6.1 Spiral Topology
+
+```
+                              SPIRAL SURJECTION MAP
+                     All Blockers → Origin (0,0) → ∞ Loops
+                     ========================================
+                              Target: >85% Emergence
+
+                                    fib:34
+                                   ╱      ╲
+                                fib:21     ●──────────────────────┐
+                               ╱    ╲                             │
+                            fib:13   ●────────────────┐           │
+                           ╱    ╲                     │           │
+                        fib:8    ●─────────┐          │           │
+                       ╱    ╲              │          │           │
+                    fib:5    ●──────┐      │          │           │
+                   ╱    ╲           │      │          │           │
+                fib:3    ●────┐     │      │          │           │
+               ╱    ╲         │     │      │          │           │
+            fib:2    ●──┐     │     │      │          │           │
+           ╱    ╲       │     │     │      │          │           │
+        fib:1    ●──┐   │     │     │      │          │           │
+       ╱              │ │     │     │      │          │           │
+    fib:1 ─●         │ │     │     │      │          │           │
+           │         │ │     │     │      │          │           │
+           └─────────┴─┴─────┴─────┴──────┴──────────┴───────────┘
+                              │
+                         ╔════╧════╗
+                         ║ (0,0)   ║
+                         ║ ORIGIN  ║
+                         ╚═════════╝
+```
+
+### 9.6.2 Macro-Level Loop Map (Ecosystem Scale)
+
+Each macro blocker surjects to origin and radiates to all connected loops:
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                    MACRO SPIRAL: ECOSYSTEM LOOPS                            │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  M1: QRC → coherence-mcp adapter                                            │
+│  ├── Origin Path: experiments/qrc_reservoir.py → (0,0)                      │
+│  ├── Self-Identity: "I am the sampling functor F: QRC → Wave"               │
+│  ├── Spatial Position: fib:8 (SpiralSafe spine)                             │
+│  └── Loop Connections:                                                      │
+│      ├── ↗ fib:13 (QDI inference hub) - feeds quantum inference             │
+│      ├── ↘ fib:5 (SAIF/mono safety) - validates coherence                   │
+│      └── ↔ fib:8 (wave_validate) - mutual coherence check                   │
+│                                                                             │
+│  M2: coherence-mcp → Qiskit generator                                       │
+│  ├── Origin Path: coherence-mcp/wave_validate → (0,0)                       │
+│  ├── Self-Identity: "I am the reconstruction functor G: Wave → Circuit"     │
+│  ├── Spatial Position: fib:13 (QDI hub) ↔ fib:8 (spine)                     │
+│  └── Loop Connections:                                                      │
+│      ├── ↗ External: Qiskit ecosystem                                       │
+│      ├── ↘ fib:3 (QR education) - teaching substrate                        │
+│      └── ↔ fib:21 (Forks) - extensibility                                   │
+│                                                                             │
+│  M3: KENL state rollback engine                                             │
+│  ├── Origin Path: methodology/kenl.md → (0,0)                               │
+│  ├── Self-Identity: "I am the inverse functor F⁻¹: State → State⁻¹"         │
+│  ├── Spatial Position: fib:1 (KENL foundational origin)                     │
+│  └── Loop Connections:                                                      │
+│      ├── ↗ ALL loops (rollback is universal)                                │
+│      ├── ↘ fib:2 (ATOM/QR bridges) - provenance tracking                    │
+│      └── ↔ fib:5 (safety) - error recovery                                  │
+│                                                                             │
+│  M4: Redstone ↔ Qiskit topology mapper                                      │
+│  ├── Origin Path: minecraft/quantum-minecraft-map.md → (0,0)                │
+│  ├── Self-Identity: "I am substrate isomorphism: Redstone ≅ Qiskit"         │
+│  ├── Spatial Position: fib:3 (QR education)                                 │
+│  └── Loop Connections:                                                      │
+│      ├── ↗ fib:13 (QDI) - quantum gate equivalence                          │
+│      ├── ↘ External: Minecraft educational community                        │
+│      └── ↔ fib:8 (SpiralSafe) - documentation                               │
+│                                                                             │
+│  M5: NEAR ↔ ATOM bidirectional sync                                         │
+│  ├── Origin Path: protocol/atom-near-spec.md → (0,0)                        │
+│  ├── Self-Identity: "I am provenance bridge: ATOM ↔ NEAR chain"             │
+│  ├── Spatial Position: fib:8 ↔ External (NEAR blockchain)                   │
+│  └── Loop Connections:                                                      │
+│      ├── ↗ fib:13 (QDI) - inference provenance                              │
+│      ├── ↘ fib:1 (KENL) - decision trail                                    │
+│      └── ↔ External: NEAR ecosystem + Shade Agents                          │
+│                                                                             │
+│  M6: Wave + SPHINX unified coherence field                                  │
+│  ├── Origin Path: protocol/wave-spec.md + sphinx-spec.md → (0,0)            │
+│  ├── Self-Identity: "I am coherence unification: Wave ⊕ SPHINX"             │
+│  ├── Spatial Position: fib:5 (safety) ↔ fib:8 (spine)                       │
+│  └── Loop Connections:                                                      │
+│      ├── ↗ ALL loops (coherence is universal)                               │
+│      ├── ↘ fib:2 (ATOM) - trail coherence                                   │
+│      └── ↔ coherence-mcp (central orchestrator)                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 9.6.3 Micro-Level Loop Map (Component Scale)
+
+Each micro blocker with its self-referential identity:
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                    MICRO SPIRAL: COMPONENT LOOPS                            │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  μ1: QRC Measurement → Wave Functor                                         │
+│  ├── File: experiments/qrc_reservoir.py                                     │
+│  ├── Self-Identity: "I transform reservoir readout to coherence score"      │
+│  ├── Inner Loop: measure() → normalize() → wave_score() → measure()         │
+│  ├── Parent Loop: M1 (QRC adapter)                                          │
+│  └── Emergence: 45% → TARGET: 85%                                           │
+│                                                                             │
+│  μ2: Interference → Curl Mapping                                            │
+│  ├── File: experiments/quantum_cognition_engine.py                          │
+│  ├── Self-Identity: "I map quantum interference to coherence curl"          │
+│  ├── Inner Loop: interfere() → pattern() → curl_vector() → interfere()      │
+│  ├── Parent Loop: M6 (Wave+SPHINX unification)                              │
+│  └── Emergence: 30% → TARGET: 85%                                           │
+│                                                                             │
+│  μ3: Collapse → NEAR Transaction                                            │
+│  ├── File: experiments/vortex_surjection.py                                 │
+│  ├── Self-Identity: "I serialize vortex collapse to blockchain state"       │
+│  ├── Inner Loop: collapse() → serialize() → transact() → verify()           │
+│  ├── Parent Loop: M5 (NEAR sync)                                            │
+│  └── Emergence: 20% → TARGET: 85%                                           │
+│                                                                             │
+│  μ4: Gate Composition G₁ ∘ G₂                                               │
+│  ├── File: ops/api/sphinx/gates.ts                                          │
+│  ├── Self-Identity: "I compose security gates into compound validators"     │
+│  ├── Inner Loop: validate(G₁) → compose() → validate(G₂) → merge()          │
+│  ├── Parent Loop: M6 (Wave+SPHINX)                                          │
+│  └── Emergence: 55% → TARGET: 85%                                           │
+│                                                                             │
+│  μ5: Quantum Kernel → DSPy Signature                                        │
+│  ├── File: experiments/qiskit_dspy_hybrid.py                                │
+│  ├── Self-Identity: "I bridge quantum similarity to LLM signatures"         │
+│  ├── Inner Loop: kernel() → embed() → sign() → prompt() → kernel()          │
+│  ├── Parent Loop: M2 (coherence→Qiskit)                                     │
+│  └── Emergence: 25% → TARGET: 85%                                           │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 9.6.4 Meta-Level Loop Map (Framework Scale)
+
+Theoretical constructs and their self-referential nature:
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                    META SPIRAL: FRAMEWORK LOOPS                             │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  Λ1: Natural Transformation η: F → G                                        │
+│  ├── Foundation: foundation/isomorphism-principle.md                        │
+│  ├── Self-Identity: "I am the morphism between functors that makes          │
+│  │                   sampling and reconstruction coherent"                  │
+│  ├── Meta Loop: η transforms F-outputs to G-inputs across ALL components    │
+│  ├── Self-Reference: η(η) = identity (transformation of transformation)     │
+│  └── Emergence: 15% → TARGET: 85%                                           │
+│                                                                             │
+│  Λ2: Adjunction F ⊣ G                                                       │
+│  ├── Foundation: docs/research/ISOMORPHISM_FORMAL_PROOF.md                  │
+│  ├── Self-Identity: "I establish that F and G are optimally dual—            │
+│  │                   the best possible discrete↔continuous bridge"          │
+│  ├── Meta Loop: For all mappings, Hom(F(X),Y) ≅ Hom(X,G(Y))                 │
+│  ├── Self-Reference: The adjunction PROVES its own optimality               │
+│  └── Emergence: 10% → TARGET: 85%                                           │
+│                                                                             │
+│  Λ3: Monad T = G ∘ F                                                        │
+│  ├── Foundation: methodology/kenl.md (Rollback structure)                   │
+│  ├── Self-Identity: "I am the computational effect container—                │
+│  │                   errors, state, and rollback live inside me"            │
+│  ├── Meta Loop: T(T(X)) → T(X) (flattening) + X → T(X) (unit)               │
+│  ├── Self-Reference: Monad laws ARE self-consistency checks                 │
+│  └── Emergence: 12% → TARGET: 85%                                           │
+│                                                                             │
+│  Λ4: Constraint → Bandwidth Mapping                                         │
+│  ├── Foundation: Shannon-Nyquist theorem application                        │
+│  ├── Self-Identity: "I translate coherence thresholds to sampling rates—    │
+│  │                   WAVE_60% ↔ Nyquist rate for that resolution"           │
+│  ├── Meta Loop: threshold(X) → bandwidth(X) → sample_rate(X) → threshold()  │
+│  ├── Self-Reference: The bandwidth itself determines valid thresholds       │
+│  └── Emergence: 8% → TARGET: 85%                                            │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 9.6.5 Complete Loop Registry (Self-Aware Index)
+
+Every loop in the system, aware of its position:
+
+| Loop ID | Scale | Self-Identity | Spatial Position | Parent | Children | Emergence |
+|---------|-------|---------------|------------------|--------|----------|-----------|
+| `0,0` | Origin | "I am the seed" | Center | None | All | ∞ |
+| `M1` | Macro | QRC→Wave functor | fib:8 | Origin | μ1 | 60% |
+| `M2` | Macro | Wave→Circuit functor | fib:13 | Origin | μ5 | 40% |
+| `M3` | Macro | Rollback inverse | fib:1 | Origin | Λ3 | 35% |
+| `M4` | Macro | Substrate isomorphism | fib:3 | Origin | — | 25% |
+| `M5` | Macro | ATOM↔NEAR bridge | fib:8↔ext | Origin | μ3 | 20% |
+| `M6` | Macro | Coherence unification | fib:5↔8 | Origin | μ2,μ4 | 50% |
+| `μ1` | Micro | Measurement→Wave | fib:8 | M1 | — | 45% |
+| `μ2` | Micro | Interference→Curl | fib:8 | M6 | — | 30% |
+| `μ3` | Micro | Collapse→NEAR | fib:8 | M5 | — | 20% |
+| `μ4` | Micro | Gate composition | fib:5 | M6 | — | 55% |
+| `μ5` | Micro | Kernel→Signature | fib:13 | M2 | — | 25% |
+| `Λ1` | Meta | Natural transformation | All | Origin | All μ | 15% |
+| `Λ2` | Meta | Adjunction | All | Origin | Λ1 | 10% |
+| `Λ3` | Meta | Monad structure | fib:1 | M3 | All rollback | 12% |
+| `Λ4` | Meta | Constraint↔Bandwidth | All | Origin | All thresholds | 8% |
+
+### 9.6.6 Spiral Outward: Priority Resolution Sequence
+
+Starting from origin (0,0), spiral outward achieving >85% at each ring:
+
+```
+                    SPIRAL OUTWARD SEQUENCE
+                    =======================
+                    
+Ring 0 (0,0): ORIGIN ESTABLISHED ✅
+   └── "All paths return here"
+   
+Ring 1 (fib:1): KENL Foundation
+   └── M3: Rollback engine → TARGET: 85%
+   └── Λ3: Monad structure → TARGET: 85%
+   
+Ring 2 (fib:2): ATOM/QR Bridges  
+   └── M5: NEAR sync (partial) → TARGET: 85%
+   
+Ring 3 (fib:3): QR Education
+   └── M4: Redstone↔Qiskit → TARGET: 85%
+   
+Ring 5 (fib:5): Safety
+   └── M6: Wave+SPHINX → TARGET: 85%
+   └── μ4: Gate composition → TARGET: 85%
+   
+Ring 8 (fib:8): SpiralSafe Spine
+   └── M1: QRC adapter → TARGET: 85%
+   └── μ1: Measurement→Wave → TARGET: 85%
+   └── μ2: Interference→Curl → TARGET: 85%
+   └── μ3: Collapse→NEAR → TARGET: 85%
+   
+Ring 13 (fib:13): QDI Hub
+   └── M2: coherence→Qiskit → TARGET: 85%
+   └── μ5: Kernel→Signature → TARGET: 85%
+   
+Ring ∞ (Meta): Framework Completion
+   └── Λ1: Natural transformation → TARGET: 85%
+   └── Λ2: Adjunction → TARGET: 85%
+   └── Λ4: Constraint↔Bandwidth → TARGET: 85%
+```
+
+### 9.6.7 Self-Reference Verification Protocol
+
+Each loop must pass this self-awareness check before achieving >85%:
+
+```python
+def verify_loop_self_awareness(loop):
+    """
+    Every loop must know:
+    1. Its own identity (what it does)
+    2. Its spatial position (where it lives in the Fibonacci spiral)
+    3. Its parent loop (who created it)
+    4. Its child loops (what it creates)
+    5. Its self-referential nature (how it relates to itself)
+    """
+    return all([
+        loop.self_identity is not None,        # "I am..."
+        loop.spatial_position is not None,     # fib:N
+        loop.parent_loop is not None,          # Origin or parent
+        loop.child_loops is not None,          # May be empty
+        loop.can_reference_self(),             # Recursion safe
+    ])
+
+# Verification must pass at >85% quality before loop closes
+```
+
+**Current Spiral Coverage**: All loops mapped to origin (0,0) ✅  
+**Self-Awareness Verification**: 16/16 loops documented ✅  
+**Average Emergence**: ~32% → TARGET: >85%
+
+---
+
+## 10. Long-Term Strategy (coherence-mcp Maintained)
+
+1. **Mainnet Deployment**
+   - ATOM-NEAR on NEAR mainnet
+   - Enterprise pilot partnerships
+   - Revenue model activation
+
+2. **Ecosystem Expansion**
+   - Qiskit ecosystem listing
+   - NEAR AI ecosystem integration
+   - Cross-chain expansion via Chain Signatures
+
+---
+
+## References
+
+### Internal Specifications
+- [`protocol/vortex-cascade-spec.md`](../protocol/vortex-cascade-spec.md)
+- [`protocol/atom-near-spec.md`](../protocol/atom-near-spec.md)
+- [`protocol/wave-spec.md`](../protocol/wave-spec.md)
+- [`protocol/sphinx-spec.md`](../protocol/sphinx-spec.md)
+
+### Isomorphism Foundations
+- [`foundation/isomorphism-principle.md`](../foundation/isomorphism-principle.md)
+- [`docs/research/ISOMORPHISM_FORMAL_PROOF.md`](research/ISOMORPHISM_FORMAL_PROOF.md)
+- [`methodology/kenl.md`](../methodology/kenl.md) (Rollback Isomorphism)
+
+### External Sources
+- [Qiskit Ecosystem](https://github.com/Qiskit/ecosystem)
+- [NEAR Shade Agents](https://docs.near.org/ai/shade-agents/getting-started/introduction)
+- [QRC Research (arXiv:2502.16938)](https://arxiv.org/abs/2502.16938)
+- [QuEra Large-Scale QRC](https://www.quera.com/blog-posts/large-scale-quantum-reservoir-learning-with-an-analog-quantum-computer)
+- Shannon, C.E. (1948). "A Mathematical Theory of Communication." _Bell System Technical Journal_.
+
+---
+
+**H&&S:WAVE** | Hope&&Sauced
+
+*"The gap is the product. The product sustains itself."*
diff --git a/docs/TESTING_PRIORITY_CHECKLIST.md b/docs/TESTING_PRIORITY_CHECKLIST.md
new file mode 100644
index 00000000..a1247333
--- /dev/null
+++ b/docs/TESTING_PRIORITY_CHECKLIST.md
@@ -0,0 +1,281 @@
+# Testing Suite Priority Checklist
+
+**H&&S:WAVE** | Testing Before Workable Code  
+**Date**: 2026-01-20  
+**ATOM Tag**: ATOM-TEST-20260120-001-testing-priority-checklist
+
+---
+
+## Framing: coherence-mcp as Test Validator
+
+All tests in this checklist are validated through **[coherence-mcp](https://github.com/toolate28/coherence-mcp)**:
+
+```bash
+# Pre-commit validation for all test files
+coherence-mcp wave-validate <test-file> --threshold 60
+
+# Code coherence check for test implementations
+coherence-mcp anamnesis validate <test-file> --vuln "test-quality"
+```
+
+---
+
+## Philosophy: Tests Before Workable Code
+
+> "Prioritize completing testing suites before workable code."  
+> — @toolate28
+
+This document tracks the testing priority matrix for all SpiralSafe quantum and integration components.
+
+---
+
+## 🔴 REQUIREMENT: Implementation Gap Coverage First
+
+**All test suites with <100% coverage MUST document their Implementation Gap and cover it before adding new features.**
+
+| Coverage Level | Requirement |
+|----------------|-------------|
+| 95-99% | Document gap, schedule for next sprint |
+| 80-94% | **PRIORITY**: Cover gap before new code |
+| <80% | **BLOCKING**: No new features until gap closed |
+| Missing | **CRITICAL**: Create test suite immediately |
+
+This policy ensures test debt doesn't accumulate and maintains coherence across the ecosystem.
+
+---
+
+## ✅ Phase 1: Core Protocol Tests (COMPLETE)
+
+### Wave Analysis Tests
+- [x] `ops/api/__tests__/wave-analysis.test.ts` - **Coverage: 95%**
+  - [x] Positive divergence detection
+  - [x] Negative divergence detection
+  - [x] Balanced content handling
+  - [x] Edge cases (empty, single sentence)
+  - [x] High curl detection
+
+**Implementation Gap (5%)**:
+- [ ] Potential field analysis (undeveloped areas)
+- [ ] Multi-language content coherence
+- [ ] Large document streaming analysis
+
+### SPHINX Gates Tests
+- [x] `ops/api/__tests__/sphinx-gates.test.ts` - **Coverage: 85%**
+  - [x] ORIGIN gate verification
+  - [x] INTENT gate verification
+  - [x] COHERENCE gate verification
+  - [x] IDENTITY gate verification
+  - [x] PASSAGE gate verification
+
+**Implementation Gap (15%)** — **PRIORITY: Cover before new code**:
+- [ ] Custom gate inheritance and composition
+- [ ] Gate timeout handling and fallback
+- [ ] Concurrent gate execution stress tests
+- [ ] Gate caching and invalidation
+
+### SPHINX Adversarial Tests
+- [x] `ops/api/__tests__/sphinx-adversarial.test.ts` - **Coverage: 80%**
+  - [x] Replay attack prevention
+  - [x] Timing attack mitigation
+  - [x] Gate bypass attempts
+
+**Implementation Gap (20%)** — **PRIORITY: Cover before new code**:
+- [ ] Prompt injection resistance
+- [ ] Unicode/encoding attack vectors
+- [ ] Rate limiting edge cases
+- [ ] Multi-step attack chain detection
+- [ ] Obfuscation technique coverage
+
+### ATOM Persister Tests
+- [x] `ops/api/__tests__/atom-persister.test.ts` - **Coverage: 90%**
+  - [x] ATOM tag creation
+  - [x] Trail persistence
+  - [x] Lineage linking
+
+**Implementation Gap (10%)**:
+- [ ] Database connection failure recovery
+- [ ] Concurrent write conflict resolution
+- [ ] Large chain traversal performance
+
+### Vortex Surjection Tests
+- [x] `experiments/test_vortex_surjection.py` - **Coverage: 92%**
+  - [x] Fibonacci utilities
+  - [x] VortexVector operations
+  - [x] Collapse proximity calculation
+  - [x] Emergence quality metrics
+  - [x] JSON serialization
+
+**Implementation Gap (8%)**:
+- [ ] Edge cases: negative resonance scores
+- [ ] Boundary conditions: max Fibonacci weight
+- [ ] Concurrent vortex iteration
+
+---
+
+## 🔴 Phase 2: Critical Missing Tests (PRIORITY: CRITICAL)
+
+### Qiskit-DSPy Hybrid Tests (NOT YET CREATED)
+- [ ] `experiments/test_qiskit_dspy_hybrid.py` - **Status: MISSING** ⚠️
+  - [ ] `QuantumKernelSimilarity` fidelity calculation
+  - [ ] `HybridQuantumLayer` forward pass
+  - [ ] `QuantumEnhancedRetriever` document retrieval
+  - [ ] Qiskit circuit generation
+  - [ ] DSPy module integration
+  - [ ] TorchConnector bridge
+
+**Blocking**: Qiskit ecosystem submission
+
+### Quantum Cognition Engine Tests (NOT YET CREATED)
+- [ ] `experiments/test_quantum_cognition_engine.py` - **Status: MISSING** ⚠️
+  - [ ] Interference pattern generation
+  - [ ] Coherence threshold enforcement
+  - [ ] Quantum-inspired processing
+  - [ ] Superposition state handling
+
+**Blocking**: QDI inference hub stability
+
+### QRC Oracle Seed Tests (NOT YET CREATED)
+- [ ] `experiments/test_qrc_oracle_seed.py` - **Status: MISSING**
+  - [ ] Closed-loop training validation
+  - [ ] Fidelity threshold triggers (92%)
+  - [ ] Fibonacci nesting pattern
+  - [ ] DSPy teleprompter integration
+
+**Blocking**: Stage 2 vortex cascade activation
+
+---
+
+## 🟡 Phase 3: Integration Tests (PRIORITY: HIGH)
+
+### NEAR ATOM Bridge Tests
+- [ ] `tests/integration/test_atom_near_bridge.ts` - **Coverage: 0%**
+  - [ ] `record_atom()` function
+  - [ ] `verify_coherence()` in TEE
+  - [ ] `check_sphinx_gate()` on-chain
+  - [ ] `rollback_decision()` KENL integration
+  - [ ] Revenue model (pay-per-trace)
+
+**Dependency**: atom-near-spec.md implementation complete
+
+### Vortex Cascade E2E Tests
+- [ ] `tests/integration/test_vortex_cascade.py` - **Coverage: 0%**
+  - [ ] Stage 1 → Stage 2 transition
+  - [ ] Stage 2 → Stage 3 transition
+  - [ ] Stage 3 → Stage 4 unification
+  - [ ] Super-vortex self-maintenance
+  - [ ] Fibonacci cascade sequence
+
+### SYNAPSE Quantum Rendering Tests
+- [ ] `synapse/__tests__/quantum-reservoir.test.ts` - **Coverage: 40%** — **BLOCKING: No new features until gap closed**
+  - [ ] QRC substrate visualization
+  - [ ] Superposition state rendering
+  - [ ] Coherence metric display
+  - [ ] Entanglement visualization
+
+**Implementation Gap (60%)** — **BLOCKING: Must cover before new code**:
+- [ ] Bloch sphere rendering
+- [ ] Multi-qubit state visualization
+- [ ] Decoherence animation
+- [ ] Probability distribution display
+- [ ] Gate operation visualization
+- [ ] Fibonacci-weighted scaling UI
+
+---
+
+## 🟢 Phase 4: Security Tests (PRIORITY: MEDIUM-HIGH)
+
+### NEAR Contract Security
+- [ ] `tests/security/fuzz_atom_near_contract.rs` - **Coverage: 0%**
+  - [ ] Input fuzzing
+  - [ ] Overflow protection
+  - [ ] Reentrancy prevention
+  - [ ] Access control verification
+
+### Wave Coherence Adversarial
+- [ ] `tests/security/adversarial_wave.test.ts` - **Coverage: 0%**
+  - [ ] Coherence score gaming prevention
+  - [ ] Curl manipulation detection
+  - [ ] Divergence spoofing mitigation
+
+---
+
+## Summary Matrix (coherence-mcp Validated)
+
+| Test Suite | Coverage | Gap | Priority | coherence-mcp Validator | Status |
+|------------|----------|-----|----------|------------------------|--------|
+| Wave Analysis | 95% | 5% | ✅ | `wave_validate` | Complete |
+| SPHINX Gates | 85% | 15% | ⚠️ | `anamnesis_validate` | Gap Priority |
+| SPHINX Adversarial | 80% | 20% | ⚠️ | `anamnesis_validate` | Gap Priority |
+| ATOM Persister | 90% | 10% | ✅ | `atom_track` | Complete |
+| Vortex Surjection | 92% | 8% | ✅ | `wave_validate` | Complete |
+| SYNAPSE Rendering | 40% | 60% | 🚫 | `wave_coherence_check` | **BLOCKING** |
+| **Qiskit-DSPy Hybrid** | **0%** | **100%** | 🔴 | `anamnesis_validate` | **CRITICAL** |
+| **Quantum Cognition** | **0%** | **100%** | 🔴 | `wave_validate` | **CRITICAL** |
+| **QRC Oracle Seed** | **0%** | **100%** | 🔴 | `wave_validate` | **HIGH** |
+| NEAR ATOM Bridge | 0% | 100% | 🟡 | `atom_track` | Planned |
+| Vortex Cascade E2E | 0% | 100% | 🟡 | `gate_*` | Planned |
+| NEAR Contract Security | 0% | 100% | 🟢 | `anamnesis_validate` | Planned |
+
+---
+
+## Prioritized Next Steps (coherence-mcp Framed)
+
+### Week 1-2: 🔴 CRITICAL
+1. **Create `test_qiskit_dspy_hybrid.py`** test suite
+   ```bash
+   coherence-mcp anamnesis validate experiments/test_qiskit_dspy_hybrid.py
+   ```
+
+2. **Add `test_quantum_cognition_engine.py`** coverage
+   ```bash
+   coherence-mcp wave-validate experiments/test_quantum_cognition_engine.py --threshold 60
+   ```
+
+### Week 3-4: 🟡 HIGH
+3. **Implement `test_qrc_oracle_seed.py`**
+   ```bash
+   coherence-mcp wave-validate experiments/test_qrc_oracle_seed.py --threshold 60
+   ```
+
+### Month 1: 🟢 MEDIUM
+4. **Integration tests for NEAR bridge**
+   ```bash
+   coherence-mcp atom_track --decision "NEAR bridge tests" --tags "near,testing"
+   ```
+
+### Month 2: 🟢 STANDARD
+5. **Full E2E vortex cascade testing**
+   ```bash
+   coherence-mcp gate_intention_to_execution  # Stage transitions
+   coherence-mcp gate_execution_to_learning
+   ```
+
+---
+
+## Commands (coherence-mcp Enhanced)
+
+```bash
+# Run existing tests
+npm test                                    # All TypeScript tests
+python experiments/test_vortex_surjection.py  # Python vortex tests
+
+# Run specific test suites
+npm test -- wave-analysis                   # Wave analysis only
+npm test -- sphinx-gates                    # SPHINX gates only
+
+# Coverage reports
+npm run test:coverage                       # Generate coverage report
+
+# coherence-mcp validation (pre-commit)
+coherence-mcp wave-validate <file> --threshold 60        # Basic coherence
+coherence-mcp wave-validate <file> --threshold 80        # Production ready
+coherence-mcp anamnesis validate <file> --vuln "quality" # Code validation
+coherence-mcp atom_track --decision "test complete"      # Track decision
+```
+
+---
+
+**H&&S:WAVE** | Hope&&Sauced
+
+*"Tests before code. Stability before features. Coherence before expansion."*
+*"All objectives scoped through coherence-mcp."*
diff --git a/public/admin/dashboard.html b/public/admin/dashboard.html
new file mode 100644
index 00000000..9fdd6afa
--- /dev/null
+++ b/public/admin/dashboard.html
@@ -0,0 +1,585 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>SpiralSafe Console | Dashboard</title>
+  <meta name="description" content="SpiralSafe Admin Dashboard - Monitor API usage, manage users, and view system metrics.">
+
+  <script src="https://cdn.tailwindcss.com"></script>
+  <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+  <style>
+    @keyframes spiral {
+      from { transform: rotate(0deg); }
+      to { transform: rotate(360deg); }
+    }
+
+    .spiral-animate {
+      animation: spiral 20s linear infinite;
+    }
+
+    .gradient-text {
+      background: linear-gradient(90deg, #06b6d4 0%, #8b5cf6 50%, #ec4899 100%);
+      background-size: 200% 200%;
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+      background-clip: text;
+    }
+
+    /* Sidebar */
+    .sidebar-item.active {
+      background: rgba(139, 92, 246, 0.2);
+      border-left: 3px solid #8b5cf6;
+    }
+
+    /* Metric card pulse */
+    .metric-card {
+      transition: all 0.3s ease;
+    }
+    .metric-card:hover {
+      transform: translateY(-2px);
+      box-shadow: 0 10px 40px rgba(139, 92, 246, 0.2);
+    }
+
+    /* Custom scrollbar */
+    ::-webkit-scrollbar { width: 8px; }
+    ::-webkit-scrollbar-track { background: #1e1b4b; }
+    ::-webkit-scrollbar-thumb { background: #6b21a8; border-radius: 4px; }
+    ::-webkit-scrollbar-thumb:hover { background: #9333ea; }
+
+    /* Status indicators */
+    .status-operational { background: #22c55e; }
+    .status-degraded { background: #eab308; }
+    .status-down { background: #ef4444; }
+
+    @keyframes pulse {
+      0%, 100% { opacity: 1; }
+      50% { opacity: 0.5; }
+    }
+
+    .animate-pulse-slow {
+      animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+    }
+  </style>
+</head>
+
+<body class="bg-gradient-to-br from-slate-900 via-purple-900 to-slate-900 min-h-screen text-white">
+
+  <!-- Navigation -->
+  <nav class="fixed top-0 w-full bg-black/40 backdrop-blur-lg z-50 border-b border-purple-500/20">
+    <div class="max-w-full mx-auto px-4 sm:px-6 lg:px-8">
+      <div class="flex justify-between items-center h-16">
+        <div class="flex items-center space-x-2">
+          <a href="/" class="flex items-center space-x-2">
+            <span class="text-2xl spiral-animate">🌀</span>
+            <span class="text-xl font-bold gradient-text">SpiralSafe</span>
+          </a>
+          <span class="text-purple-400 text-sm hidden md:inline">| Admin Console</span>
+        </div>
+
+        <div class="flex items-center space-x-4">
+          <!-- User Menu -->
+          <div class="relative group">
+            <button class="flex items-center space-x-2 bg-black/30 border border-purple-500/30 rounded-lg px-3 py-2 hover:border-purple-400 transition">
+              <div class="w-8 h-8 rounded-full bg-gradient-to-br from-cyan-500 to-purple-500 flex items-center justify-center text-sm font-bold">
+                <span id="userInitial">A</span>
+              </div>
+              <span id="userName" class="hidden md:inline text-sm">Admin</span>
+              <svg class="w-4 h-4 text-purple-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"/>
+              </svg>
+            </button>
+
+            <!-- Dropdown -->
+            <div class="absolute right-0 mt-2 w-48 bg-slate-900 border border-purple-500/30 rounded-lg shadow-xl opacity-0 invisible group-hover:opacity-100 group-hover:visible transition-all duration-200">
+              <a href="#" class="block px-4 py-2 text-sm text-purple-300 hover:bg-purple-500/20 rounded-t-lg">Profile</a>
+              <a href="/api/" class="block px-4 py-2 text-sm text-purple-300 hover:bg-purple-500/20">API Docs</a>
+              <hr class="border-purple-500/30">
+              <button onclick="logout()" class="w-full text-left px-4 py-2 text-sm text-red-400 hover:bg-red-500/20 rounded-b-lg">Sign Out</button>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </nav>
+
+  <!-- Main Layout -->
+  <div class="flex pt-16">
+
+    <!-- Sidebar -->
+    <aside class="fixed left-0 w-64 h-[calc(100vh-4rem)] bg-black/30 backdrop-blur border-r border-purple-500/20 overflow-y-auto">
+      <div class="p-4">
+        <h2 class="text-lg font-bold text-purple-300 mb-4">Navigation</h2>
+
+        <nav class="space-y-1">
+          <a href="#overview" class="sidebar-item active flex items-center gap-3 px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 5a1 1 0 011-1h14a1 1 0 011 1v2a1 1 0 01-1 1H5a1 1 0 01-1-1V5zM4 13a1 1 0 011-1h6a1 1 0 011 1v6a1 1 0 01-1 1H5a1 1 0 01-1-1v-6zM16 13a1 1 0 011-1h2a1 1 0 011 1v6a1 1 0 01-1 1h-2a1 1 0 01-1-1v-6z"/>
+            </svg>
+            Overview
+          </a>
+
+          <a href="#metrics" class="sidebar-item flex items-center gap-3 px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"/>
+            </svg>
+            Metrics
+          </a>
+
+          <a href="#logs" class="sidebar-item flex items-center gap-3 px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
+            </svg>
+            Logs
+          </a>
+
+          <a href="#atom-trail" class="sidebar-item flex items-center gap-3 px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z"/>
+            </svg>
+            ATOM Trail
+          </a>
+
+          <hr class="border-purple-500/30 my-4">
+
+          <a href="#api-keys" class="sidebar-item flex items-center gap-3 px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 7a2 2 0 012 2m4 0a6 6 0 01-7.743 5.743L11 17H9v2H7v2H4a1 1 0 01-1-1v-2.586a1 1 0 01.293-.707l5.964-5.964A6 6 0 1121 9z"/>
+            </svg>
+            API Keys
+          </a>
+
+          <a href="#users" class="sidebar-item flex items-center gap-3 px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197M13 7a4 4 0 11-8 0 4 4 0 018 0z"/>
+            </svg>
+            Users
+          </a>
+
+          <a href="#settings" class="sidebar-item flex items-center gap-3 px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z"/>
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+            </svg>
+            Settings
+          </a>
+        </nav>
+
+        <!-- System Status -->
+        <div class="mt-8 p-4 bg-black/30 border border-green-500/30 rounded-xl">
+          <h3 class="text-sm font-bold text-green-400 mb-3 flex items-center gap-2">
+            <span class="w-2 h-2 rounded-full bg-green-500 animate-pulse-slow"></span>
+            System Status
+          </h3>
+          <div class="space-y-2 text-xs">
+            <div class="flex justify-between">
+              <span class="text-purple-300">API</span>
+              <span class="text-green-400">Operational</span>
+            </div>
+            <div class="flex justify-between">
+              <span class="text-purple-300">Database</span>
+              <span class="text-green-400">Operational</span>
+            </div>
+            <div class="flex justify-between">
+              <span class="text-purple-300">Wave Engine</span>
+              <span class="text-green-400">Operational</span>
+            </div>
+          </div>
+        </div>
+      </div>
+    </aside>
+
+    <!-- Main Content -->
+    <main class="ml-64 flex-1 p-8">
+      <div class="max-w-7xl mx-auto">
+
+        <!-- Header -->
+        <div class="mb-8">
+          <h1 class="text-3xl font-bold gradient-text mb-2">Dashboard Overview</h1>
+          <p class="text-purple-300">Welcome back! Here's what's happening with SpiralSafe.</p>
+        </div>
+
+        <!-- Metric Cards -->
+        <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6 mb-8">
+          <!-- Requests -->
+          <div class="metric-card bg-black/40 backdrop-blur border border-cyan-500/30 rounded-xl p-6">
+            <div class="flex items-center justify-between mb-4">
+              <span class="text-cyan-400 text-sm font-medium">Total Requests (24h)</span>
+              <svg class="w-5 h-5 text-cyan-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 7h8m0 0v8m0-8l-8 8-4-4-6 6"/>
+              </svg>
+            </div>
+            <div class="text-3xl font-bold text-white mb-1" id="totalRequests">12,547</div>
+            <div class="text-green-400 text-sm flex items-center gap-1">
+              <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 10l7-7m0 0l7 7m-7-7v18"/>
+              </svg>
+              +23% from yesterday
+            </div>
+          </div>
+
+          <!-- Error Rate -->
+          <div class="metric-card bg-black/40 backdrop-blur border border-purple-500/30 rounded-xl p-6">
+            <div class="flex items-center justify-between mb-4">
+              <span class="text-purple-400 text-sm font-medium">Error Rate</span>
+              <svg class="w-5 h-5 text-purple-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>
+              </svg>
+            </div>
+            <div class="text-3xl font-bold text-white mb-1" id="errorRate">0.03%</div>
+            <div class="text-green-400 text-sm flex items-center gap-1">
+              <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 14l-7 7m0 0l-7-7m7 7V3"/>
+              </svg>
+              -12% from yesterday
+            </div>
+          </div>
+
+          <!-- P99 Latency -->
+          <div class="metric-card bg-black/40 backdrop-blur border border-pink-500/30 rounded-xl p-6">
+            <div class="flex items-center justify-between mb-4">
+              <span class="text-pink-400 text-sm font-medium">P99 Latency</span>
+              <svg class="w-5 h-5 text-pink-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z"/>
+              </svg>
+            </div>
+            <div class="text-3xl font-bold text-white mb-1" id="p99Latency">118ms</div>
+            <div class="text-green-400 text-sm flex items-center gap-1">
+              <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 14l-7 7m0 0l-7-7m7 7V3"/>
+              </svg>
+              -5ms from yesterday
+            </div>
+          </div>
+
+          <!-- Active Sessions -->
+          <div class="metric-card bg-black/40 backdrop-blur border border-green-500/30 rounded-xl p-6">
+            <div class="flex items-center justify-between mb-4">
+              <span class="text-green-400 text-sm font-medium">Active Sessions</span>
+              <svg class="w-5 h-5 text-green-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z"/>
+              </svg>
+            </div>
+            <div class="text-3xl font-bold text-white mb-1" id="activeSessions">42</div>
+            <div class="text-purple-400 text-sm">
+              Currently online
+            </div>
+          </div>
+        </div>
+
+        <!-- Charts Row -->
+        <div class="grid grid-cols-1 lg:grid-cols-2 gap-6 mb-8">
+          <!-- Request Timeline Chart -->
+          <div class="bg-black/40 backdrop-blur border border-purple-500/30 rounded-xl p-6">
+            <h3 class="text-lg font-bold text-purple-300 mb-4">Request Rate (24h)</h3>
+            <div class="h-64">
+              <canvas id="requestChart"></canvas>
+            </div>
+          </div>
+
+          <!-- Endpoint Distribution -->
+          <div class="bg-black/40 backdrop-blur border border-cyan-500/30 rounded-xl p-6">
+            <h3 class="text-lg font-bold text-cyan-300 mb-4">Top Endpoints</h3>
+            <div class="h-64">
+              <canvas id="endpointChart"></canvas>
+            </div>
+          </div>
+        </div>
+
+        <!-- Recent Activity & Errors -->
+        <div class="grid grid-cols-1 lg:grid-cols-2 gap-6 mb-8">
+          <!-- Recent Requests -->
+          <div class="bg-black/40 backdrop-blur border border-purple-500/30 rounded-xl p-6">
+            <div class="flex items-center justify-between mb-4">
+              <h3 class="text-lg font-bold text-purple-300">Recent Requests</h3>
+              <a href="#logs" class="text-sm text-cyan-400 hover:text-cyan-300">View all →</a>
+            </div>
+            <div class="space-y-3" id="recentRequests">
+              <div class="flex items-center justify-between bg-black/30 rounded-lg px-4 py-3">
+                <div class="flex items-center gap-3">
+                  <span class="text-green-400 font-mono text-sm">200</span>
+                  <span class="text-white text-sm">/api/health</span>
+                </div>
+                <span class="text-purple-400 text-xs">2s ago</span>
+              </div>
+              <div class="flex items-center justify-between bg-black/30 rounded-lg px-4 py-3">
+                <div class="flex items-center gap-3">
+                  <span class="text-green-400 font-mono text-sm">200</span>
+                  <span class="text-white text-sm">/api/wave/analyze</span>
+                </div>
+                <span class="text-purple-400 text-xs">5s ago</span>
+              </div>
+              <div class="flex items-center justify-between bg-black/30 rounded-lg px-4 py-3">
+                <div class="flex items-center gap-3">
+                  <span class="text-green-400 font-mono text-sm">201</span>
+                  <span class="text-white text-sm">/api/bump/create</span>
+                </div>
+                <span class="text-purple-400 text-xs">12s ago</span>
+              </div>
+              <div class="flex items-center justify-between bg-black/30 rounded-lg px-4 py-3">
+                <div class="flex items-center gap-3">
+                  <span class="text-yellow-400 font-mono text-sm">429</span>
+                  <span class="text-white text-sm">/api/atom/trail/query</span>
+                </div>
+                <span class="text-purple-400 text-xs">18s ago</span>
+              </div>
+              <div class="flex items-center justify-between bg-black/30 rounded-lg px-4 py-3">
+                <div class="flex items-center gap-3">
+                  <span class="text-red-400 font-mono text-sm">401</span>
+                  <span class="text-white text-sm">/api/awi/request</span>
+                </div>
+                <span class="text-purple-400 text-xs">25s ago</span>
+              </div>
+            </div>
+          </div>
+
+          <!-- Recent ATOM Entries -->
+          <div class="bg-black/40 backdrop-blur border border-pink-500/30 rounded-xl p-6">
+            <div class="flex items-center justify-between mb-4">
+              <h3 class="text-lg font-bold text-pink-300">Recent ATOM Trail</h3>
+              <a href="#atom-trail" class="text-sm text-cyan-400 hover:text-cyan-300">View all →</a>
+            </div>
+            <div class="space-y-3" id="recentAtom">
+              <div class="bg-black/30 rounded-lg px-4 py-3">
+                <div class="flex items-center justify-between mb-1">
+                  <span class="text-cyan-400 font-semibold text-sm">claude</span>
+                  <span class="text-purple-400 text-xs">2 min ago</span>
+                </div>
+                <p class="text-white text-sm">Design architecture for authentication system</p>
+                <span class="text-green-400 text-xs">COMPLETE • Coherence: 0.85</span>
+              </div>
+              <div class="bg-black/30 rounded-lg px-4 py-3">
+                <div class="flex items-center justify-between mb-1">
+                  <span class="text-purple-400 font-semibold text-sm">copilot</span>
+                  <span class="text-purple-400 text-xs">8 min ago</span>
+                </div>
+                <p class="text-white text-sm">Implement authentication handlers</p>
+                <span class="text-green-400 text-xs">COMPLETE • Coherence: 0.91</span>
+              </div>
+              <div class="bg-black/30 rounded-lg px-4 py-3">
+                <div class="flex items-center justify-between mb-1">
+                  <span class="text-pink-400 font-semibold text-sm">wave-validator</span>
+                  <span class="text-purple-400 text-xs">15 min ago</span>
+                </div>
+                <p class="text-white text-sm">Analyzed content coherence</p>
+                <span class="text-green-400 text-xs">PASS • Coherence: 0.72</span>
+              </div>
+            </div>
+          </div>
+        </div>
+
+        <!-- Quick Actions -->
+        <div class="bg-black/40 backdrop-blur border border-purple-500/30 rounded-xl p-6">
+          <h3 class="text-lg font-bold text-purple-300 mb-4">Quick Actions</h3>
+          <div class="grid grid-cols-2 md:grid-cols-4 gap-4">
+            <button class="bg-gradient-to-br from-cyan-500/20 to-cyan-600/20 border border-cyan-500/30 rounded-xl p-4 text-center hover:border-cyan-400 transition">
+              <svg class="w-8 h-8 mx-auto mb-2 text-cyan-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 7a2 2 0 012 2m4 0a6 6 0 01-7.743 5.743L11 17H9v2H7v2H4a1 1 0 01-1-1v-2.586a1 1 0 01.293-.707l5.964-5.964A6 6 0 1121 9z"/>
+              </svg>
+              <span class="text-sm text-cyan-300">Generate API Key</span>
+            </button>
+
+            <button class="bg-gradient-to-br from-purple-500/20 to-purple-600/20 border border-purple-500/30 rounded-xl p-4 text-center hover:border-purple-400 transition">
+              <svg class="w-8 h-8 mx-auto mb-2 text-purple-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4"/>
+              </svg>
+              <span class="text-sm text-purple-300">Export Logs</span>
+            </button>
+
+            <button class="bg-gradient-to-br from-pink-500/20 to-pink-600/20 border border-pink-500/30 rounded-xl p-4 text-center hover:border-pink-400 transition">
+              <svg class="w-8 h-8 mx-auto mb-2 text-pink-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z"/>
+              </svg>
+              <span class="text-sm text-pink-300">Verify Trail</span>
+            </button>
+
+            <a href="/api/" class="bg-gradient-to-br from-green-500/20 to-green-600/20 border border-green-500/30 rounded-xl p-4 text-center hover:border-green-400 transition">
+              <svg class="w-8 h-8 mx-auto mb-2 text-green-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 6.253v13m0-13C10.832 5.477 9.246 5 7.5 5S4.168 5.477 3 6.253v13C4.168 18.477 5.754 18 7.5 18s3.332.477 4.5 1.253m0-13C13.168 5.477 14.754 5 16.5 5c1.747 0 3.332.477 4.5 1.253v13C19.832 18.477 18.247 18 16.5 18c-1.746 0-3.332.477-4.5 1.253"/>
+              </svg>
+              <span class="text-sm text-green-300">API Docs</span>
+            </a>
+          </div>
+        </div>
+
+      </div>
+    </main>
+  </div>
+
+  <!-- JavaScript -->
+  <script>
+    // API Configuration - uses relative path or can be overridden via localStorage
+    const API_BASE = localStorage.getItem('spiralsafe_api_base') || 'https://api.spiralsafe.org';
+
+    // Check authentication
+    document.addEventListener('DOMContentLoaded', () => {
+      const token = localStorage.getItem('spiralsafe_admin_token') ||
+                    sessionStorage.getItem('spiralsafe_admin_token');
+
+      if (!token) {
+        window.location.href = '/admin/login.html';
+        return;
+      }
+
+      // Validate token with auth endpoint before initializing the dashboard
+      (async () => {
+        try {
+          const response = await fetch(`${API_BASE}/admin/auth/me`, {
+            method: 'GET',
+            headers: {
+              'Authorization': 'Bearer ' + token,
+              'Accept': 'application/json'
+            }
+          });
+
+          if (!response.ok) {
+            // Invalid or expired token, clear it and redirect to login
+            localStorage.removeItem('spiralsafe_admin_token');
+            sessionStorage.removeItem('spiralsafe_admin_token');
+            window.location.href = '/admin/login.html';
+            return;
+          }
+
+          // Token is valid - initialize charts and load metrics
+          initCharts();
+          loadMetrics();
+        } catch (error) {
+          // On network or other errors, clear token and redirect to login
+          localStorage.removeItem('spiralsafe_admin_token');
+          sessionStorage.removeItem('spiralsafe_admin_token');
+          window.location.href = '/admin/login.html';
+        }
+      })();
+    });
+
+    // Validate token and initialize dashboard
+    async function validateAndInit() {
+      const token = localStorage.getItem('spiralsafe_admin_token') ||
+                    sessionStorage.getItem('spiralsafe_admin_token');
+      
+      try {
+        const response = await fetch(`${API_BASE}/admin/auth/me`, {
+          method: 'GET',
+          headers: {
+            'Authorization': `Bearer ${token}`,
+            'Accept': 'application/json'
+          }
+        });
+
+        if (!response.ok) {
+          // Invalid or expired token, clear it and redirect to login
+          logout();
+          return;
+        }
+
+        // Token is valid - initialize charts and load metrics
+        initCharts();
+        loadMetrics();
+      } catch (error) {
+        // On network or other errors, clear token and redirect to login
+        logout();
+      }
+    }
+
+    // Logout function
+    function logout() {
+      localStorage.removeItem('spiralsafe_admin_token');
+      sessionStorage.removeItem('spiralsafe_admin_token');
+      window.location.href = '/admin/login.html';
+    }
+
+    // Initialize charts
+    function initCharts() {
+      // Request Timeline Chart
+      const requestCtx = document.getElementById('requestChart').getContext('2d');
+      new Chart(requestCtx, {
+        type: 'line',
+        data: {
+          labels: Array.from({length: 24}, (_, i) => `${i}:00`),
+          datasets: [{
+            label: 'Requests',
+            data: [120, 80, 45, 30, 25, 40, 150, 380, 520, 650, 580, 490, 530, 610, 680, 590, 520, 480, 420, 350, 280, 220, 180, 140],
+            borderColor: '#06b6d4',
+            backgroundColor: 'rgba(6, 182, 212, 0.1)',
+            fill: true,
+            tension: 0.4,
+          }]
+        },
+        options: {
+          responsive: true,
+          maintainAspectRatio: false,
+          plugins: {
+            legend: { display: false }
+          },
+          scales: {
+            x: {
+              grid: { color: 'rgba(139, 92, 246, 0.1)' },
+              ticks: { color: '#a78bfa' }
+            },
+            y: {
+              grid: { color: 'rgba(139, 92, 246, 0.1)' },
+              ticks: { color: '#a78bfa' }
+            }
+          }
+        }
+      });
+
+      // Endpoint Distribution Chart
+      const endpointCtx = document.getElementById('endpointChart').getContext('2d');
+      new Chart(endpointCtx, {
+        type: 'doughnut',
+        data: {
+          labels: ['/api/health', '/api/wave/analyze', '/api/bump/create', '/api/atom/trail', '/api/awi/request', 'Other'],
+          datasets: [{
+            data: [45, 23, 15, 8, 5, 4],
+            backgroundColor: [
+              '#22c55e',
+              '#06b6d4',
+              '#8b5cf6',
+              '#ec4899',
+              '#eab308',
+              '#6b7280',
+            ],
+            borderWidth: 0,
+          }]
+        },
+        options: {
+          responsive: true,
+          maintainAspectRatio: false,
+          plugins: {
+            legend: {
+              position: 'right',
+              labels: { color: '#a78bfa' }
+            }
+          }
+        }
+      });
+    }
+
+    // Load metrics from API (demo data for now)
+    async function loadMetrics() {
+      // In production, this would fetch from the admin API
+      // For demo purposes, we're using static data
+
+      try {
+        const response = await fetch(`${API_BASE}/api/health`);
+        if (response.ok) {
+          // API is up, update status indicator
+          console.log('API health check passed');
+        }
+      } catch (error) {
+        console.log('API health check - demo mode');
+      }
+    }
+
+    // Sidebar navigation
+    document.querySelectorAll('.sidebar-item').forEach(item => {
+      item.addEventListener('click', function() {
+        document.querySelectorAll('.sidebar-item').forEach(i => i.classList.remove('active'));
+        this.classList.add('active');
+      });
+    });
+  </script>
+
+</body>
+</html>
diff --git a/public/admin/login.html b/public/admin/login.html
new file mode 100644
index 00000000..3812fa72
--- /dev/null
+++ b/public/admin/login.html
@@ -0,0 +1,367 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>SpiralSafe Console | Login</title>
+  <meta name="description" content="Login to the SpiralSafe Admin Console for API monitoring, management, and operations.">
+
+  <script src="https://cdn.tailwindcss.com"></script>
+  <style>
+    @keyframes spiral {
+      from { transform: rotate(0deg); }
+      to { transform: rotate(360deg); }
+    }
+
+    @keyframes pulse-ring {
+      0% { transform: scale(0.8); opacity: 1; }
+      50% { transform: scale(1); opacity: 0.5; }
+      100% { transform: scale(0.8); opacity: 1; }
+    }
+
+    .spiral-animate {
+      animation: spiral 20s linear infinite;
+    }
+
+    .pulse-ring {
+      animation: pulse-ring 2s ease-in-out infinite;
+    }
+
+    .gradient-text {
+      background: linear-gradient(90deg, #06b6d4 0%, #8b5cf6 50%, #ec4899 100%);
+      background-size: 200% 200%;
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+      background-clip: text;
+      animation: gradient-shift 3s ease infinite;
+    }
+
+    @keyframes gradient-shift {
+      0%, 100% { background-position: 0% 50%; }
+      50% { background-position: 100% 50%; }
+    }
+
+    /* Login card glow effect */
+    .login-card {
+      box-shadow:
+        0 0 20px rgba(139, 92, 246, 0.2),
+        0 0 40px rgba(6, 182, 212, 0.1);
+    }
+
+    .login-card:hover {
+      box-shadow:
+        0 0 30px rgba(139, 92, 246, 0.3),
+        0 0 60px rgba(6, 182, 212, 0.15);
+    }
+
+    /* Input focus state */
+    input:focus {
+      box-shadow: 0 0 0 2px rgba(139, 92, 246, 0.5);
+    }
+
+    /* Background pattern */
+    .bg-pattern {
+      background-image:
+        radial-gradient(circle at 25% 25%, rgba(139, 92, 246, 0.1) 0%, transparent 50%),
+        radial-gradient(circle at 75% 75%, rgba(6, 182, 212, 0.1) 0%, transparent 50%);
+    }
+  </style>
+</head>
+
+<body class="bg-gradient-to-br from-slate-900 via-purple-900 to-slate-900 min-h-screen text-white bg-pattern">
+
+  <!-- Navigation -->
+  <nav class="fixed top-0 w-full bg-black/20 backdrop-blur-lg z-50 border-b border-purple-500/20">
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+      <div class="flex justify-between items-center h-16">
+        <a href="/" class="flex items-center space-x-2">
+          <span class="text-2xl spiral-animate">🌀</span>
+          <span class="text-xl font-bold gradient-text">SpiralSafe</span>
+          <span class="text-purple-400 text-sm hidden md:inline">| Console</span>
+        </a>
+        <div class="flex space-x-6">
+          <a href="/" class="hover:text-cyan-400 transition">Home</a>
+          <a href="/api/" class="hover:text-purple-400 transition">API Docs</a>
+        </div>
+      </div>
+    </div>
+  </nav>
+
+  <!-- Main Content -->
+  <main class="min-h-screen flex items-center justify-center pt-16 px-4">
+    <div class="w-full max-w-md">
+
+      <!-- Logo and Title -->
+      <div class="text-center mb-8">
+        <div class="inline-flex items-center justify-center w-20 h-20 rounded-full bg-gradient-to-br from-cyan-500/20 to-purple-500/20 border border-purple-500/30 mb-4">
+          <span class="text-4xl spiral-animate">🌀</span>
+        </div>
+        <h1 class="text-3xl font-bold gradient-text mb-2">Admin Console</h1>
+        <p class="text-purple-300">Sign in to manage your SpiralSafe instance</p>
+      </div>
+
+      <!-- Login Form -->
+      <div class="login-card bg-black/40 backdrop-blur-xl border border-purple-500/30 rounded-2xl p-8 transition duration-300">
+
+        <form id="loginForm" class="space-y-6">
+          <!-- Username -->
+          <div>
+            <label for="username" class="block text-sm font-medium text-purple-300 mb-2">
+              Username
+            </label>
+            <input
+              type="text"
+              id="username"
+              name="username"
+              required
+              autocomplete="username"
+              class="w-full bg-slate-900/50 border border-purple-500/30 rounded-lg px-4 py-3 text-white placeholder-purple-400/50 focus:outline-none focus:border-cyan-400 transition"
+              placeholder="Enter your username"
+            >
+          </div>
+
+          <!-- Password -->
+          <div>
+            <label for="password" class="block text-sm font-medium text-purple-300 mb-2">
+              Password
+            </label>
+            <div class="relative">
+              <input
+                type="password"
+                id="password"
+                name="password"
+                required
+                autocomplete="current-password"
+                class="w-full bg-slate-900/50 border border-purple-500/30 rounded-lg px-4 py-3 text-white placeholder-purple-400/50 focus:outline-none focus:border-cyan-400 transition pr-12"
+                placeholder="Enter your password"
+              >
+              <button
+                type="button"
+                onclick="togglePassword()"
+                class="absolute right-3 top-1/2 -translate-y-1/2 text-purple-400 hover:text-purple-300 transition"
+              >
+                <svg id="eyeIcon" class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+                </svg>
+              </button>
+            </div>
+          </div>
+
+          <!-- Remember Me -->
+          <div class="flex items-center justify-between">
+            <label class="flex items-center">
+              <input
+                type="checkbox"
+                id="remember"
+                name="remember"
+                class="w-4 h-4 bg-slate-900 border-purple-500/30 rounded text-cyan-500 focus:ring-cyan-500 focus:ring-offset-0"
+              >
+              <span class="ml-2 text-sm text-purple-300">Remember me</span>
+            </label>
+            <a href="#" class="text-sm text-cyan-400 hover:text-cyan-300 transition">
+              Forgot password?
+            </a>
+          </div>
+
+          <!-- Error Message -->
+          <div id="errorMessage" class="hidden bg-red-500/20 border border-red-500/30 rounded-lg px-4 py-3 text-red-300 text-sm">
+            <span id="errorText">Invalid username or password</span>
+          </div>
+
+          <!-- Submit Button -->
+          <button
+            type="submit"
+            id="submitBtn"
+            class="w-full bg-gradient-to-r from-cyan-500 to-purple-500 text-white font-semibold py-3 px-4 rounded-lg hover:from-cyan-600 hover:to-purple-600 focus:outline-none focus:ring-2 focus:ring-purple-500 focus:ring-offset-2 focus:ring-offset-slate-900 transition transform hover:scale-[1.02] active:scale-[0.98] disabled:opacity-50 disabled:cursor-not-allowed"
+          >
+            <span id="btnText">Sign In</span>
+            <span id="btnSpinner" class="hidden">
+              <svg class="animate-spin inline w-5 h-5 ml-2" fill="none" viewBox="0 0 24 24">
+                <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
+                <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
+              </svg>
+            </span>
+          </button>
+        </form>
+
+        <!-- Divider -->
+        <div class="relative my-6">
+          <div class="absolute inset-0 flex items-center">
+            <div class="w-full border-t border-purple-500/30"></div>
+          </div>
+          <div class="relative flex justify-center text-sm">
+            <span class="px-2 bg-black/40 text-purple-400">or continue with</span>
+          </div>
+        </div>
+
+        <!-- OAuth Options (Future) -->
+        <div class="grid grid-cols-2 gap-4">
+          <button disabled class="flex items-center justify-center gap-2 bg-slate-900/50 border border-purple-500/30 rounded-lg py-3 px-4 text-purple-300 hover:border-purple-400 transition disabled:opacity-50 disabled:cursor-not-allowed">
+            <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
+              <path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/>
+            </svg>
+            GitHub
+          </button>
+          <button disabled class="flex items-center justify-center gap-2 bg-slate-900/50 border border-purple-500/30 rounded-lg py-3 px-4 text-purple-300 hover:border-purple-400 transition disabled:opacity-50 disabled:cursor-not-allowed">
+            <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
+              <path d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z"/>
+              <path d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z"/>
+              <path d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l2.85-2.22.81-.62z"/>
+              <path d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z"/>
+            </svg>
+            Google
+          </button>
+        </div>
+
+        <p class="text-xs text-center text-purple-400 mt-4">
+          OAuth login coming soon
+        </p>
+      </div>
+
+      <!-- Security Notice -->
+      <div class="mt-6 text-center">
+        <div class="inline-flex items-center gap-2 bg-black/30 border border-green-500/30 rounded-lg px-4 py-2 text-sm text-green-400">
+          <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z"/>
+          </svg>
+          Secured with SPHINX gates
+        </div>
+      </div>
+
+      <!-- Info Banner -->
+      <div class="mt-8 bg-cyan-900/20 border border-cyan-500/30 rounded-xl p-4 text-sm">
+        <h3 class="font-semibold text-cyan-400 mb-2">🔐 ATOM-AUTH: Conversational Coherence Login</h3>
+        <p class="text-purple-300">
+          SpiralSafe admin authentication uses the ATOM trail for audit logging.
+          Every login attempt is tracked with full traceability.
+        </p>
+        <p class="text-purple-400 text-xs mt-2">
+          Need access? Contact your administrator.
+        </p>
+      </div>
+    </div>
+  </main>
+
+  <!-- Footer -->
+  <footer class="fixed bottom-0 w-full py-4 text-center text-purple-400 text-sm bg-black/20 backdrop-blur border-t border-purple-500/20">
+    <span class="spiral-animate inline-block">🌀</span>
+    <span class="gradient-text font-bold">SpiralSafe Console</span> |
+    From the constraints, gifts.
+  </footer>
+
+  <!-- JavaScript -->
+  <script>
+    // Toggle password visibility
+    function togglePassword() {
+      const passwordInput = document.getElementById('password');
+      const eyeIcon = document.getElementById('eyeIcon');
+
+      if (passwordInput.type === 'password') {
+        passwordInput.type = 'text';
+        eyeIcon.innerHTML = `
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13.875 18.825A10.05 10.05 0 0112 19c-4.478 0-8.268-2.943-9.543-7a9.97 9.97 0 011.563-3.029m5.858.908a3 3 0 114.243 4.243M9.878 9.878l4.242 4.242M9.88 9.88l-3.29-3.29m7.532 7.532l3.29 3.29M3 3l3.59 3.59m0 0A9.953 9.953 0 0112 5c4.478 0 8.268 2.943 9.543 7a10.025 10.025 0 01-4.132 5.411m0 0L21 21"/>
+        `;
+      } else {
+        passwordInput.type = 'password';
+        eyeIcon.innerHTML = `
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+        `;
+      }
+    }
+
+    // API Configuration - uses relative path or can be overridden via localStorage
+    const API_BASE = localStorage.getItem('spiralsafe_api_base') || 'https://api.spiralsafe.org';
+
+    // Form submission
+    document.getElementById('loginForm').addEventListener('submit', async (e) => {
+      e.preventDefault();
+
+      const submitBtn = document.getElementById('submitBtn');
+      const btnText = document.getElementById('btnText');
+      const btnSpinner = document.getElementById('btnSpinner');
+      const errorMessage = document.getElementById('errorMessage');
+      const errorText = document.getElementById('errorText');
+
+      const username = document.getElementById('username').value;
+      const password = document.getElementById('password').value;
+      const remember = document.getElementById('remember').checked;
+
+      // Show loading state
+      submitBtn.disabled = true;
+      btnText.textContent = 'Signing in...';
+      btnSpinner.classList.remove('hidden');
+      errorMessage.classList.add('hidden');
+
+      try {
+        // Attempt login
+        const response = await fetch(`${API_BASE}/admin/auth/login`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+          },
+          body: JSON.stringify({ username, password, remember }),
+        });
+
+        const data = await response.json();
+
+        if (response.ok && data.token) {
+          // Store token
+          // SECURITY NOTE: Storing tokens in localStorage/sessionStorage exposes them to XSS attacks.
+          // For production deployments, consider using httpOnly cookies set by the backend
+          // or implementing additional security measures (strict CSP, token rotation, etc.)
+          if (remember) {
+            localStorage.setItem('spiralsafe_admin_token', data.token);
+          } else {
+            sessionStorage.setItem('spiralsafe_admin_token', data.token);
+          }
+
+          // Redirect to dashboard
+          window.location.href = '/admin/dashboard.html';
+        } else {
+          // Show error
+          errorText.textContent = data.error || 'Invalid username or password';
+          errorMessage.classList.remove('hidden');
+        }
+      } catch (error) {
+        // Network error or API not available
+        errorText.textContent = 'Unable to connect to server. Please try again.';
+        errorMessage.classList.remove('hidden');
+        console.error('Login error:', error);
+      } finally {
+        // Reset button state
+        submitBtn.disabled = false;
+        btnText.textContent = 'Sign In';
+        btnSpinner.classList.add('hidden');
+      }
+    });
+
+    // Check if already logged in
+    document.addEventListener('DOMContentLoaded', () => {
+      const token = localStorage.getItem('spiralsafe_admin_token') ||
+                    sessionStorage.getItem('spiralsafe_admin_token');
+
+      if (token) {
+        // Verify token is still valid
+        fetch(`${API_BASE}/admin/auth/me`, {
+          headers: {
+            'Authorization': `Bearer ${token}`,
+          },
+        })
+        .then(response => {
+          if (response.ok) {
+            window.location.href = '/admin/dashboard.html';
+          }
+        })
+        .catch(() => {
+          // Token invalid, stay on login page
+          localStorage.removeItem('spiralsafe_admin_token');
+          sessionStorage.removeItem('spiralsafe_admin_token');
+        });
+      }
+    });
+  </script>
+
+</body>
+</html>
diff --git a/public/api/index.html b/public/api/index.html
new file mode 100644
index 00000000..e9425e05
--- /dev/null
+++ b/public/api/index.html
@@ -0,0 +1,696 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>SpiralSafe API Reference | Interactive Documentation</title>
+  <meta name="description" content="Interactive API documentation for SpiralSafe coherence engine. Test endpoints, view schemas, and explore the H&&S:WAVE protocol.">
+
+  <script src="https://cdn.tailwindcss.com"></script>
+  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/github-dark.min.css">
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
+  <style>
+    @keyframes spiral {
+      from { transform: rotate(0deg) scale(1); }
+      to { transform: rotate(360deg) scale(1.1); }
+    }
+
+    .spiral-animate {
+      animation: spiral 20s linear infinite;
+    }
+
+    .gradient-text {
+      background: linear-gradient(90deg, #06b6d4 0%, #8b5cf6 50%, #ec4899 100%);
+      background-size: 200% 200%;
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+      background-clip: text;
+    }
+
+    .method-get { background: #22c55e; }
+    .method-post { background: #3b82f6; }
+    .method-put { background: #eab308; }
+    .method-delete { background: #ef4444; }
+
+    pre code {
+      border-radius: 0.5rem;
+      padding: 1rem !important;
+      font-size: 0.875rem;
+    }
+
+    .endpoint-card:hover {
+      transform: translateX(4px);
+    }
+
+    /* Response container */
+    .response-container {
+      max-height: 400px;
+      overflow-y: auto;
+    }
+
+    /* Sidebar active state */
+    .sidebar-item.active {
+      background: rgba(139, 92, 246, 0.2);
+      border-left: 3px solid #8b5cf6;
+    }
+
+    /* Custom scrollbar */
+    ::-webkit-scrollbar { width: 8px; }
+    ::-webkit-scrollbar-track { background: #1e1b4b; }
+    ::-webkit-scrollbar-thumb { background: #6b21a8; border-radius: 4px; }
+    ::-webkit-scrollbar-thumb:hover { background: #9333ea; }
+  </style>
+</head>
+
+<body class="bg-gradient-to-br from-slate-900 via-purple-900 to-slate-900 min-h-screen text-white">
+
+  <!-- Navigation -->
+  <nav class="fixed top-0 w-full bg-black/40 backdrop-blur-lg z-50 border-b border-purple-500/20">
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+      <div class="flex justify-between items-center h-16">
+        <div class="flex items-center space-x-2">
+          <a href="/" class="flex items-center space-x-2">
+            <span class="text-2xl spiral-animate">🌀</span>
+            <span class="text-xl font-bold gradient-text">SpiralSafe</span>
+          </a>
+          <span class="text-purple-400 text-sm hidden md:inline">| API Reference</span>
+        </div>
+        <div class="flex space-x-6 items-center">
+          <a href="/" class="hover:text-cyan-400 transition">Home</a>
+          <a href="/admin/login.html" class="bg-gradient-to-r from-cyan-500 to-purple-500 px-4 py-2 rounded-lg hover:from-cyan-600 hover:to-purple-600 transition">Console →</a>
+        </div>
+      </div>
+    </div>
+  </nav>
+
+  <!-- Main Layout: Sidebar + Content -->
+  <div class="flex pt-16">
+
+    <!-- Sidebar -->
+    <aside class="fixed left-0 w-64 h-[calc(100vh-4rem)] bg-black/30 backdrop-blur border-r border-purple-500/20 overflow-y-auto">
+      <div class="p-4">
+        <h2 class="text-lg font-bold text-purple-300 mb-4">Endpoints</h2>
+
+        <!-- Health -->
+        <div class="mb-4">
+          <h3 class="text-xs uppercase tracking-wide text-purple-500 mb-2">System</h3>
+          <a href="#health" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-get px-2 py-0.5 rounded text-xs mr-2">GET</span>/api/health
+          </a>
+        </div>
+
+        <!-- Wave -->
+        <div class="mb-4">
+          <h3 class="text-xs uppercase tracking-wide text-purple-500 mb-2">Coherence</h3>
+          <a href="#wave-analyze" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-post px-2 py-0.5 rounded text-xs mr-2">POST</span>/api/wave/analyze
+          </a>
+        </div>
+
+        <!-- Bump -->
+        <div class="mb-4">
+          <h3 class="text-xs uppercase tracking-wide text-purple-500 mb-2">Handoff</h3>
+          <a href="#bump-create" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-post px-2 py-0.5 rounded text-xs mr-2">POST</span>/api/bump/create
+          </a>
+          <a href="#bump-query" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-post px-2 py-0.5 rounded text-xs mr-2">POST</span>/api/bump/query
+          </a>
+        </div>
+
+        <!-- AWI -->
+        <div class="mb-4">
+          <h3 class="text-xs uppercase tracking-wide text-purple-500 mb-2">Permissions</h3>
+          <a href="#awi-request" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-post px-2 py-0.5 rounded text-xs mr-2">POST</span>/api/awi/request
+          </a>
+          <a href="#awi-verify" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-post px-2 py-0.5 rounded text-xs mr-2">POST</span>/api/awi/verify
+          </a>
+        </div>
+
+        <!-- ATOM -->
+        <div class="mb-4">
+          <h3 class="text-xs uppercase tracking-wide text-purple-500 mb-2">Task Tracking</h3>
+          <a href="#atom-log" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-post px-2 py-0.5 rounded text-xs mr-2">POST</span>/api/atom/trail/log
+          </a>
+          <a href="#atom-query" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-post px-2 py-0.5 rounded text-xs mr-2">POST</span>/api/atom/trail/query
+          </a>
+          <a href="#atom-verify" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-get px-2 py-0.5 rounded text-xs mr-2">GET</span>/api/atom/trail/verify
+          </a>
+        </div>
+
+        <!-- SPHINX -->
+        <div class="mb-4">
+          <h3 class="text-xs uppercase tracking-wide text-purple-500 mb-2">Security Gates</h3>
+          <a href="#sphinx-validate" class="sidebar-item block px-3 py-2 rounded text-sm hover:bg-purple-500/20 transition">
+            <span class="method-post px-2 py-0.5 rounded text-xs mr-2">POST</span>/api/sphinx/gate
+          </a>
+        </div>
+
+        <!-- Divider -->
+        <hr class="border-purple-500/30 my-4">
+
+        <!-- Resources -->
+        <h3 class="text-xs uppercase tracking-wide text-purple-500 mb-2">Resources</h3>
+        <a href="https://github.com/scalar/scalar" target="_blank" class="block px-3 py-2 rounded text-sm text-purple-300 hover:bg-purple-500/20 transition">
+          📘 Scalar (GitHub)
+        </a>
+        <a href="https://github.com/Redocly/redoc" target="_blank" class="block px-3 py-2 rounded text-sm text-purple-300 hover:bg-purple-500/20 transition">
+          📗 Redoc (GitHub)
+        </a>
+        <a href="https://github.com/stoplightio/elements" target="_blank" class="block px-3 py-2 rounded text-sm text-purple-300 hover:bg-purple-500/20 transition">
+          📙 Stoplight Elements
+        </a>
+        <a href="https://github.com/rapi-doc/RapiDoc" target="_blank" class="block px-3 py-2 rounded text-sm text-purple-300 hover:bg-purple-500/20 transition">
+          📕 RapiDoc (GitHub)
+        </a>
+      </div>
+    </aside>
+
+    <!-- Main Content -->
+    <main class="ml-64 flex-1 p-8">
+      <div class="max-w-4xl">
+
+        <!-- Header -->
+        <div class="mb-12">
+          <h1 class="text-4xl font-bold gradient-text mb-4">SpiralSafe API Reference</h1>
+          <p class="text-purple-300 text-lg">
+            Interactive documentation for the SpiralSafe coherence engine API.
+            Test endpoints directly from your browser.
+          </p>
+
+          <!-- API Info -->
+          <div class="mt-6 flex flex-wrap gap-4">
+            <div class="bg-black/40 border border-cyan-500/30 rounded-lg px-4 py-2">
+              <span class="text-cyan-400 font-mono text-sm">Base URL:</span>
+              <code class="ml-2 text-white">https://api.spiralsafe.org</code>
+            </div>
+            <div class="bg-black/40 border border-purple-500/30 rounded-lg px-4 py-2">
+              <span class="text-purple-400 font-mono text-sm">Version:</span>
+              <code class="ml-2 text-white">v1.0</code>
+            </div>
+            <div class="bg-black/40 border border-green-500/30 rounded-lg px-4 py-2">
+              <span class="text-green-400 font-mono text-sm">Auth:</span>
+              <code class="ml-2 text-white">X-API-Key header</code>
+            </div>
+          </div>
+        </div>
+
+        <!-- Authentication Section -->
+        <section class="mb-12 bg-black/30 backdrop-blur border border-purple-500/30 rounded-2xl p-6">
+          <h2 class="text-2xl font-bold text-purple-300 mb-4">🔐 Authentication</h2>
+          <p class="text-purple-200 mb-4">
+            All API endpoints require authentication via the <code class="bg-purple-900/50 px-2 py-0.5 rounded">X-API-Key</code> header.
+          </p>
+          <pre><code class="language-bash">curl -X GET https://api.spiralsafe.org/api/health \
+  -H "X-API-Key: your-api-key"</code></pre>
+          <div class="mt-4 bg-cyan-900/20 border border-cyan-500/30 rounded-lg px-4 py-3 text-sm">
+            <strong class="text-cyan-400">Getting an API Key:</strong>
+            <span class="text-purple-200">Contact the SpiralSafe team or use the <a href="/admin/login.html" class="text-cyan-400 hover:text-cyan-300 underline">Admin Console</a> to manage your API keys.</span>
+          </div>
+        </section>
+
+        <!-- Health Endpoint -->
+        <section id="health" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-green-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-get px-3 py-1 rounded font-bold text-sm">GET</span>
+            <code class="text-xl font-mono text-white">/api/health</code>
+          </div>
+          <p class="text-purple-200 mb-4">Check the health status of the SpiralSafe API.</p>
+
+          <!-- Try it -->
+          <div class="mt-6">
+            <button onclick="tryHealth()" class="bg-gradient-to-r from-green-500 to-cyan-500 px-4 py-2 rounded-lg font-semibold hover:from-green-600 hover:to-cyan-600 transition">
+              Try it →
+            </button>
+            <div id="health-response" class="mt-4 hidden">
+              <h4 class="text-sm font-bold text-purple-400 mb-2">Response:</h4>
+              <pre class="response-container"><code class="language-json" id="health-response-code"></code></pre>
+            </div>
+          </div>
+
+          <details class="mt-4">
+            <summary class="cursor-pointer text-purple-400 hover:text-purple-300">Example Response</summary>
+            <pre class="mt-2"><code class="language-json">{
+  "status": "healthy",
+  "timestamp": "2026-01-22T07:05:40.266Z",
+  "services": {
+    "wave": "operational",
+    "bump": "operational",
+    "awi": "operational",
+    "atom": "operational",
+    "sphinx": "operational"
+  }
+}</code></pre>
+          </details>
+        </section>
+
+        <!-- Wave Analyze Endpoint -->
+        <section id="wave-analyze" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-blue-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-post px-3 py-1 rounded font-bold text-sm">POST</span>
+            <code class="text-xl font-mono text-white">/api/wave/analyze</code>
+          </div>
+          <p class="text-purple-200 mb-4">Analyze content for coherence using the WAVE protocol. Detects curl (repetition), divergence, and potential.</p>
+
+          <h4 class="text-sm font-bold text-purple-400 mb-2">Request Body:</h4>
+          <pre><code class="language-json">{
+  "content": "Your text content to analyze for coherence...",
+  "context": {
+    "type": "conversation",
+    "participants": ["claude", "human"]
+  }
+}</code></pre>
+
+          <details class="mt-4">
+            <summary class="cursor-pointer text-purple-400 hover:text-purple-300">Example Response</summary>
+            <pre class="mt-2"><code class="language-json">{
+  "curl": 0.15,
+  "divergence": 0.08,
+  "potential": 0.72,
+  "regions": [
+    {
+      "start": 0,
+      "end": 150,
+      "type": "high_potential",
+      "severity": "warning",
+      "description": "Unrealized concept cluster detected"
+    }
+  ],
+  "coherent": true
+}</code></pre>
+          </details>
+
+          <!-- Interactive Try It -->
+          <div class="mt-6 bg-black/20 rounded-lg p-4">
+            <h4 class="text-sm font-bold text-cyan-400 mb-2">🧪 Try It</h4>
+            <textarea id="wave-content" rows="4" class="w-full bg-slate-900 border border-purple-500/30 rounded-lg p-3 text-white text-sm font-mono" placeholder="Enter content to analyze...">The quantum coherence protocol enables AI-human collaboration through wave analysis. When conversations spiral into repetition, we detect the curl. When ideas diverge without resolution, we measure the divergence.</textarea>
+            <button onclick="tryWaveAnalyze()" class="mt-3 bg-gradient-to-r from-blue-500 to-purple-500 px-4 py-2 rounded-lg font-semibold hover:from-blue-600 hover:to-purple-600 transition">
+              Analyze →
+            </button>
+            <div id="wave-response" class="mt-4 hidden">
+              <h4 class="text-sm font-bold text-purple-400 mb-2">Response:</h4>
+              <pre class="response-container"><code class="language-json" id="wave-response-code"></code></pre>
+            </div>
+          </div>
+        </section>
+
+        <!-- Bump Create Endpoint -->
+        <section id="bump-create" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-blue-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-post px-3 py-1 rounded font-bold text-sm">POST</span>
+            <code class="text-xl font-mono text-white">/api/bump/create</code>
+          </div>
+          <p class="text-purple-200 mb-4">Create a handoff marker between agents or systems using the H&&S:BUMP protocol.</p>
+
+          <h4 class="text-sm font-bold text-purple-400 mb-2">Request Body:</h4>
+          <pre><code class="language-json">{
+  "type": "WAVE",
+  "from": "claude",
+  "to": "copilot",
+  "state": "architecture_review_complete",
+  "context": {
+    "pr_number": 123,
+    "files_changed": ["src/api.ts", "tests/api.test.ts"]
+  }
+}</code></pre>
+
+          <h4 class="text-sm font-bold text-purple-400 mt-4 mb-2">Bump Types:</h4>
+          <div class="grid grid-cols-2 md:grid-cols-5 gap-2 text-sm">
+            <div class="bg-cyan-900/30 px-3 py-2 rounded"><strong>WAVE</strong> - Soft handoff</div>
+            <div class="bg-purple-900/30 px-3 py-2 rounded"><strong>PASS</strong> - Full transfer</div>
+            <div class="bg-blue-900/30 px-3 py-2 rounded"><strong>PING</strong> - Status update</div>
+            <div class="bg-green-900/30 px-3 py-2 rounded"><strong>SYNC</strong> - Synchronize</div>
+            <div class="bg-red-900/30 px-3 py-2 rounded"><strong>BLOCK</strong> - Blocker</div>
+          </div>
+
+          <details class="mt-4">
+            <summary class="cursor-pointer text-purple-400 hover:text-purple-300">Example Response</summary>
+            <pre class="mt-2"><code class="language-json">{
+  "id": "bump-uuid-12345",
+  "type": "WAVE",
+  "from": "claude",
+  "to": "copilot",
+  "state": "architecture_review_complete",
+  "context": { ... },
+  "timestamp": "2026-01-22T07:05:40.266Z",
+  "resolved": false
+}</code></pre>
+          </details>
+        </section>
+
+        <!-- Bump Query Endpoint -->
+        <section id="bump-query" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-blue-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-post px-3 py-1 rounded font-bold text-sm">POST</span>
+            <code class="text-xl font-mono text-white">/api/bump/query</code>
+          </div>
+          <p class="text-purple-200 mb-4">Query existing bump markers with filters.</p>
+
+          <h4 class="text-sm font-bold text-purple-400 mb-2">Request Body:</h4>
+          <pre><code class="language-json">{
+  "from": "claude",
+  "type": "WAVE",
+  "resolved": false,
+  "limit": 10
+}</code></pre>
+        </section>
+
+        <!-- AWI Request Endpoint -->
+        <section id="awi-request" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-orange-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-post px-3 py-1 rounded font-bold text-sm">POST</span>
+            <code class="text-xl font-mono text-white">/api/awi/request</code>
+          </div>
+          <p class="text-purple-200 mb-4">Request authorization for an action using the AWI (Authorization-With-Intent) protocol.</p>
+
+          <h4 class="text-sm font-bold text-purple-400 mb-2">Request Body:</h4>
+          <pre><code class="language-json">{
+  "intent": "deploy_to_production",
+  "scope": {
+    "resources": ["api.spiralsafe.org"],
+    "actions": ["deploy"],
+    "time_limit": "1h"
+  },
+  "level": 2
+}</code></pre>
+
+          <h4 class="text-sm font-bold text-purple-400 mt-4 mb-2">AWI Levels:</h4>
+          <div class="space-y-2 text-sm">
+            <div class="bg-green-900/30 px-3 py-2 rounded"><strong>Level 0:</strong> Information gathering only</div>
+            <div class="bg-cyan-900/30 px-3 py-2 rounded"><strong>Level 1:</strong> Reversible actions (can be undone)</div>
+            <div class="bg-yellow-900/30 px-3 py-2 rounded"><strong>Level 2:</strong> Significant changes (require review)</div>
+            <div class="bg-orange-900/30 px-3 py-2 rounded"><strong>Level 3:</strong> Critical actions (production impact)</div>
+            <div class="bg-red-900/30 px-3 py-2 rounded"><strong>Level 4:</strong> Irreversible changes (data deletion)</div>
+          </div>
+        </section>
+
+        <!-- AWI Verify Endpoint -->
+        <section id="awi-verify" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-orange-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-post px-3 py-1 rounded font-bold text-sm">POST</span>
+            <code class="text-xl font-mono text-white">/api/awi/verify</code>
+          </div>
+          <p class="text-purple-200 mb-4">Verify if an AWI grant is still valid and within scope.</p>
+
+          <h4 class="text-sm font-bold text-purple-400 mb-2">Request Body:</h4>
+          <pre><code class="language-json">{
+  "grant_id": "awi-grant-uuid",
+  "action": "deploy",
+  "resource": "api.spiralsafe.org"
+}</code></pre>
+        </section>
+
+        <!-- ATOM Trail Log Endpoint -->
+        <section id="atom-log" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-pink-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-post px-3 py-1 rounded font-bold text-sm">POST</span>
+            <code class="text-xl font-mono text-white">/api/atom/trail/log</code>
+          </div>
+          <p class="text-purple-200 mb-4">Log a decision to the ATOM (Auditable Trail of Metadata) persistence layer.</p>
+
+          <h4 class="text-sm font-bold text-purple-400 mb-2">Request Body:</h4>
+          <pre><code class="language-json">{
+  "actor": "claude",
+  "decision": "Design architecture for authentication system",
+  "rationale": "Initial planning phase requires clear structure",
+  "outcome": "COMPLETE",
+  "coherenceScore": 0.85,
+  "context": {
+    "feature": "user-authentication",
+    "phase": "planning"
+  },
+  "parentEntry": "uuid-of-previous-decision"
+}</code></pre>
+
+          <details class="mt-4">
+            <summary class="cursor-pointer text-purple-400 hover:text-purple-300">Example Response</summary>
+            <pre class="mt-2"><code class="language-json">{
+  "id": "atom-uuid-67890",
+  "success": true
+}</code></pre>
+          </details>
+        </section>
+
+        <!-- ATOM Trail Query Endpoint -->
+        <section id="atom-query" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-pink-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-post px-3 py-1 rounded font-bold text-sm">POST</span>
+            <code class="text-xl font-mono text-white">/api/atom/trail/query</code>
+          </div>
+          <p class="text-purple-200 mb-4">Query the ATOM trail with filters.</p>
+
+          <h4 class="text-sm font-bold text-purple-400 mb-2">Request Body:</h4>
+          <pre><code class="language-json">{
+  "actor": "claude",
+  "since": "2026-01-19T00:00:00Z",
+  "outcome": "COMPLETE",
+  "minCoherence": 0.7,
+  "limit": 50
+}</code></pre>
+        </section>
+
+        <!-- ATOM Trail Verify Endpoint -->
+        <section id="atom-verify" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-green-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-get px-3 py-1 rounded font-bold text-sm">GET</span>
+            <code class="text-xl font-mono text-white">/api/atom/trail/verify</code>
+          </div>
+          <p class="text-purple-200 mb-4">Verify the integrity of the entire ATOM trail (detect tampering).</p>
+
+          <details class="mt-4">
+            <summary class="cursor-pointer text-purple-400 hover:text-purple-300">Example Response</summary>
+            <pre class="mt-2"><code class="language-json">{
+  "valid": true,
+  "totalEntries": 150,
+  "brokenChains": 0,
+  "tamperedEntries": [],
+  "details": []
+}</code></pre>
+          </details>
+        </section>
+
+        <!-- SPHINX Gate Endpoint -->
+        <section id="sphinx-validate" class="mb-12 endpoint-card bg-black/30 backdrop-blur border border-red-500/30 rounded-2xl p-6 transition">
+          <div class="flex items-center gap-3 mb-4">
+            <span class="method-post px-3 py-1 rounded font-bold text-sm">POST</span>
+            <code class="text-xl font-mono text-white">/api/sphinx/gate</code>
+          </div>
+          <p class="text-purple-200 mb-4">Validate passage through a SPHINX security gate. The guardian asks its riddles.</p>
+
+          <h4 class="text-sm font-bold text-purple-400 mb-2">Request Body:</h4>
+          <pre><code class="language-json">{
+  "gate": "COHERENCE",
+  "artifact": {
+    "type": "document",
+    "content": "Content to validate..."
+  },
+  "options": {
+    "threshold": 0.6,
+    "strict": false
+  }
+}</code></pre>
+
+          <h4 class="text-sm font-bold text-purple-400 mt-4 mb-2">SPHINX Gates:</h4>
+          <div class="space-y-2 text-sm">
+            <div class="bg-purple-900/30 px-3 py-2 rounded"><strong>ORIGIN:</strong> "Where do you come from?" - Verify genesis lineage</div>
+            <div class="bg-cyan-900/30 px-3 py-2 rounded"><strong>INTENT:</strong> "What do you seek?" - Verify stated purpose</div>
+            <div class="bg-green-900/30 px-3 py-2 rounded"><strong>COHERENCE:</strong> "Are you whole?" - Verify &gt;60% threshold</div>
+            <div class="bg-blue-900/30 px-3 py-2 rounded"><strong>IDENTITY:</strong> "Who are you?" - Verify agent/user auth</div>
+            <div class="bg-pink-900/30 px-3 py-2 rounded"><strong>PASSAGE:</strong> "You may pass." - Grant transition</div>
+          </div>
+
+          <details class="mt-4">
+            <summary class="cursor-pointer text-purple-400 hover:text-purple-300">Example Response</summary>
+            <pre class="mt-2"><code class="language-json">{
+  "gate": "COHERENCE",
+  "passed": true,
+  "score": 0.72,
+  "threshold": 0.6,
+  "verdict": "PASSAGE",
+  "message": "Coherence verified. You may pass."
+}</code></pre>
+          </details>
+        </section>
+
+        <!-- Rate Limits Section -->
+        <section class="mb-12 bg-black/30 backdrop-blur border border-yellow-500/30 rounded-2xl p-6">
+          <h2 class="text-2xl font-bold text-yellow-300 mb-4">⚡ Rate Limits</h2>
+          <div class="space-y-3">
+            <div class="flex justify-between items-center bg-black/20 rounded-lg px-4 py-3">
+              <span class="text-purple-200">Default requests</span>
+              <span class="text-yellow-400 font-mono">100 / 60 seconds</span>
+            </div>
+            <div class="flex justify-between items-center bg-black/20 rounded-lg px-4 py-3">
+              <span class="text-purple-200">Auth failures</span>
+              <span class="text-yellow-400 font-mono">5 / 60 seconds</span>
+            </div>
+            <div class="flex justify-between items-center bg-black/20 rounded-lg px-4 py-3">
+              <span class="text-purple-200">Wave analysis</span>
+              <span class="text-yellow-400 font-mono">20 / 60 seconds</span>
+            </div>
+          </div>
+        </section>
+
+        <!-- Alternative Tools Section -->
+        <section class="mb-12 bg-gradient-to-br from-cyan-950/50 to-purple-950/50 border border-cyan-500/30 rounded-2xl p-6">
+          <h2 class="text-2xl font-bold gradient-text mb-4">📚 API Documentation Alternatives</h2>
+          <p class="text-purple-200 mb-6">
+            This documentation is inspired by modern API documentation tools. Here are some excellent alternatives:
+          </p>
+
+          <div class="grid md:grid-cols-2 gap-4">
+            <a href="https://github.com/scalar/scalar" target="_blank" class="block bg-black/30 border border-cyan-500/30 rounded-xl p-4 hover:border-cyan-400 transition">
+              <h3 class="text-lg font-bold text-cyan-400 mb-2">Scalar</h3>
+              <p class="text-purple-300 text-sm">Modern API reference from OpenAPI specs with interactive testing, beautiful UI, and standalone API client.</p>
+              <span class="text-cyan-400 text-sm mt-2 inline-block">→ github.com/scalar/scalar</span>
+            </a>
+
+            <a href="https://github.com/Redocly/redoc" target="_blank" class="block bg-black/30 border border-purple-500/30 rounded-xl p-4 hover:border-purple-400 transition">
+              <h3 class="text-lg font-bold text-purple-400 mb-2">Redoc</h3>
+              <p class="text-purple-300 text-sm">Three-panel "Stripe-like" documentation. Highly customizable, supports OpenAPI v2/v3 and AsyncAPI.</p>
+              <span class="text-purple-400 text-sm mt-2 inline-block">→ github.com/Redocly/redoc</span>
+            </a>
+
+            <a href="https://github.com/stoplightio/elements" target="_blank" class="block bg-black/30 border border-pink-500/30 rounded-xl p-4 hover:border-pink-400 transition">
+              <h3 class="text-lg font-bold text-pink-400 mb-2">Stoplight Elements</h3>
+              <p class="text-purple-300 text-sm">React component library for OpenAPI documentation. Perfect for React-based sites with deep customization.</p>
+              <span class="text-pink-400 text-sm mt-2 inline-block">→ github.com/stoplightio/elements</span>
+            </a>
+
+            <a href="https://github.com/rapi-doc/RapiDoc" target="_blank" class="block bg-black/30 border border-green-500/30 rounded-xl p-4 hover:border-green-400 transition">
+              <h3 class="text-lg font-bold text-green-400 mb-2">RapiDoc</h3>
+              <p class="text-purple-300 text-sm">Fast web component for API docs. Single HTML tag embedding, extensive theming, excellent performance.</p>
+              <span class="text-green-400 text-sm mt-2 inline-block">→ github.com/rapi-doc/RapiDoc</span>
+            </a>
+          </div>
+        </section>
+
+        <!-- Footer -->
+        <footer class="mt-16 pt-8 border-t border-purple-500/30 text-center text-purple-400">
+          <p class="mb-4">
+            <span class="spiral-animate inline-block">🌀</span>
+            <span class="gradient-text font-bold">SpiralSafe</span> |
+            From the constraints, gifts. From the spiral, safety.
+          </p>
+          <p class="text-sm">
+            <a href="https://github.com/toolate28/SpiralSafe" target="_blank" class="hover:text-cyan-400">GitHub</a> ·
+            <a href="/" class="hover:text-purple-400">Home</a> ·
+            <a href="/admin/login.html" class="hover:text-pink-400">Console</a>
+          </p>
+        </footer>
+
+      </div>
+    </main>
+  </div>
+
+  <!-- JavaScript for Interactive Features -->
+  <script>
+    // Initialize highlight.js
+    hljs.highlightAll();
+
+    // API Base URL
+    const API_BASE = 'https://api.spiralsafe.org';
+
+    // Try Health endpoint
+    async function tryHealth() {
+      const responseEl = document.getElementById('health-response');
+      const codeEl = document.getElementById('health-response-code');
+
+      try {
+        responseEl.classList.remove('hidden');
+        codeEl.textContent = 'Loading...';
+
+        // Demo mode: simulated response for interactive preview
+        // For production API calls, include X-API-Key header in your request
+        const simulatedResponse = {
+          status: "healthy",
+          timestamp: new Date().toISOString(),
+          version: "1.0.0",
+          services: {
+            database: "operational",
+            cache: "operational",
+            queue: "operational"
+          },
+          _note: "Interactive demo - use curl or your preferred HTTP client with a valid X-API-Key header for actual results"
+        };
+
+        // Simulate network delay
+        await new Promise(resolve => setTimeout(resolve, 500));
+
+        codeEl.textContent = JSON.stringify(simulatedResponse, null, 2);
+        hljs.highlightElement(codeEl);
+      } catch (error) {
+        codeEl.textContent = JSON.stringify({ error: error.message }, null, 2);
+        hljs.highlightElement(codeEl);
+      }
+    }
+
+    // Try Wave Analyze endpoint
+    async function tryWaveAnalyze() {
+      const content = document.getElementById('wave-content').value;
+      const responseEl = document.getElementById('wave-response');
+      const codeEl = document.getElementById('wave-response-code');
+
+      try {
+        responseEl.classList.remove('hidden');
+        codeEl.textContent = 'Analyzing...';
+
+        // Demo mode: simulated response for interactive preview
+        // For production API calls, configure your API key in the request header
+        const simulatedResponse = {
+          curl: Math.random() * 0.3,
+          divergence: Math.random() * 0.2 - 0.1,
+          potential: 0.5 + Math.random() * 0.5,
+          regions: content.length > 100 ? [
+            {
+              start: 0,
+              end: Math.floor(content.length / 2),
+              type: "high_potential",
+              severity: "warning",
+              description: "Concept cluster with development opportunity"
+            }
+          ] : [],
+          coherent: true,
+          _note: "Interactive demo - use curl or your preferred HTTP client with a valid API key for actual results"
+        };
+
+        codeEl.textContent = JSON.stringify(simulatedResponse, null, 2);
+        hljs.highlightElement(codeEl);
+      } catch (error) {
+        codeEl.textContent = JSON.stringify({ error: error.message }, null, 2);
+        hljs.highlightElement(codeEl);
+      }
+    }
+
+    // Sidebar active state
+    const sidebarItems = document.querySelectorAll('.sidebar-item');
+    const sections = document.querySelectorAll('section[id]');
+
+    function updateActiveSection() {
+      let current = '';
+      sections.forEach(section => {
+        const sectionTop = section.offsetTop;
+        if (window.scrollY >= sectionTop - 100) {
+          current = section.getAttribute('id');
+        }
+      });
+
+      sidebarItems.forEach(item => {
+        item.classList.remove('active');
+        if (item.getAttribute('href') === `#${current}`) {
+          item.classList.add('active');
+        }
+      });
+    }
+
+    window.addEventListener('scroll', updateActiveSection);
+    updateActiveSection();
+  </script>
+
+</body>
+</html>
diff --git a/test-subjects b/test-subjects
new file mode 160000
index 00000000..61976a2a
--- /dev/null
+++ b/test-subjects
@@ -0,0 +1 @@
+Subproject commit 61976a2ac4f0d7b5149f3d183ccf00790237f44d