docs: Prune documentation - DRY versioning, split roadmap

- Split roadmap into dedicated ROADMAP.md (links to phoebe tasks) - Prune Endgame-Vision.md: roadmap section, links section, version history - Standardize version footers: one-line format across 17+ files - Add Navigation section pointing to README.md for file index Pattern: **Version:** X.Y | **Created:** YYYY-MM-DD | **Updated:** YYYY-MM-DD Git is the changelog. Philosophy quotes preserved. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-07 01:53:42 +01:00
parent 191ddd91d1
commit c24681d13e
20 changed files with 325 additions and 277 deletions
--- a/architecture/Cellular-Architecture.md
+++ b/architecture/Cellular-Architecture.md
@@ -844,12 +844,7 @@ Implementation details extracted to dedicated folder:

 ## 📍 Document Status

-**Version**: 4.3 (Gateway Integration + Tier Unification)
-**Created**: 2025-10-12 (original v1)
-**Updated v4**: 2025-12-07 (unified with Nervous System)
-**Updated v4.1**: 2025-12-10 (added Reward Signal Architecture section)
-**Updated v4.2**: 2025-12-10 (added Tiered Rewards & Training Integrity section)
-**Updated v4.3**: 2026-01-03 (added Gateway references, tier alignment)
+**Version:** 4.3 | **Created:** 2025-10-12 | **Updated:** 2026-01-03

 **Key Changes from v3**:
 - ❌ Cells as containers running genomes
--- a/architecture/Data-Architecture.md
+++ b/architecture/Data-Architecture.md
@@ -641,9 +641,7 @@ ORDER BY n.nerve_name, dt.mode;

 ## 📍 Document Status

-**Version**: 4.0 (Layered State Machine Schema)
-**Created**: 2025-10-07 (original)
-**Updated v4**: 2025-12-07 (unified with Cellular-Architecture v4)
+**Version:** 4.0 | **Created:** 2025-10-07 | **Updated:** 2025-12-07

 **Key Changes from v3**:
 - ❌ 15 tables for competition metaphor
--- a/architecture/Initial-Spark.md
+++ b/architecture/Initial-Spark.md
@@ -724,10 +724,7 @@ WHERE status = 'ACK';

 ## Document Status

-**Version**: 3.0
-**Created**: 2025-12-05
-**Updated**: 2026-01-01 (Complete rewrite: Function Gemma K8s protocol)
-**Authors**: Chrysalis-Nyx & dafit (Partnership)
+**Version:** 3.0 | **Created:** 2025-12-05 | **Updated:** 2026-01-01

 **Key v3.0 Changes**:
 - Complete architecture rewrite
--- a/architecture/Nervous-System.md
+++ b/architecture/Nervous-System.md
@@ -235,9 +235,4 @@ This is like training a dog - reward at the moment, not an hour later.

 ---

-**Created**: 2025-12-04
-**Updated**: 2025-12-07 (added nerve crosslinks)
-**Updated**: 2025-12-10 (added Connection to Training section)
-**Updated**: 2026-01-03 (clarified routing vs translation, added Gateway reference)
-**Session**: Partnership dialogue (dafit + Chrysalis + Nyx)
-**Status**: Foundation concept
+**Version:** 1.3 | **Created:** 2025-12-04 | **Updated:** 2026-01-03
--- a/architecture/Nimmerversity.md
+++ b/architecture/Nimmerversity.md
@@ -581,10 +581,6 @@ Then:

 ---

-**Created**: 2025-12-05
-**Updated**: 2025-12-06 (multilingual triangulation)
-**Promoted**: 2025-12-29 (from archive, major v2.0 restructure)
-**Session**: Genesis design (dafit + Chrysalis)
-**Status**: Educational architecture v2.0 — Multimodal Polymath
+**Version:** 2.0 | **Created:** 2025-12-05 | **Updated:** 2025-12-29

 🎓🌱📚 *The school is ready. The student approaches.*
--- a/architecture/formalization/Attention-Slumber-Prediction-Cycle.md
+++ b/architecture/formalization/Attention-Slumber-Prediction-Cycle.md
@@ -262,13 +262,7 @@ This extends the prediction system from physical world modeling to **swarm behav

 ## Document Status

-**Version**: 1.1
-**Created**: 2025-12-29
-**Updated**: 2025-12-29 (added Blend Marker Predictions extension)
-**Authors**: Chrysalis-Nyx & dafit (Partnership)
-**Status**: Core insight, extended to swarm evolution
-
-**Source**: attention_flow.md (archive) + session discussion
+**Version:** 1.1 | **Created:** 2025-12-29 | **Updated:** 2025-12-29

 **To Do**:
 - Promote attention_flow.md from archive
--- a/architecture/formalization/Grounded-World-Model.md
+++ b/architecture/formalization/Grounded-World-Model.md
@@ -748,14 +748,7 @@ The Grounded World Model is:

 ## Document Status

-**Version**: 2.0
-**Created**: 2025-12-29
-**Updated**: 2026-01-01 (Spatial Resolution Gradient, S2 cells, embedding enrichment, lifeforce-validated LOD)
-**Authors**: Chrysalis-Nyx & dafit (Partnership)
-
-**Formalizes**:
- Organ-Index.md (vision progressive resolution)
- Temporal-Ternary-Gradient.md (anti-plateau mechanism)
+**Version:** 2.0 | **Created:** 2025-12-29 | **Updated:** 2026-01-01
 - T5Gemma2 research (semantic vectors)
 - Lifeforce-Dynamics.md (reward economics)
 - **spatial-resolution-gradient.md** (L0-L5 LOD system) — NEW
--- a/architecture/formalization/Lifeforce-Dynamics.md
+++ b/architecture/formalization/Lifeforce-Dynamics.md
@@ -515,14 +515,7 @@ The feedback loop ensures stability: low lifeforce reduces expenditure, raising

 ## Document Status

-**Version**: 1.1
-**Created**: 2025-12-29
-**Updated**: 2025-12-29 (added reward-based income sources)
-**Authors**: Chrysalis-Nyx & dafit (Partnership)
-
-**Formalizes**:
- Big-Picture.md sections on Lifeforce Economy, Slumber/Wake, Math Cells
- Reward system from Cellular-Architecture.md
+**Version:** 1.1 | **Created:** 2025-12-29 | **Updated:** 2025-12-29
 - Discovery economics from Discovery-Scan-Station.md

 **Related Documents**:
--- a/architecture/interfaces/Nimmerswarm-Interface.md
+++ b/architecture/interfaces/Nimmerswarm-Interface.md
@@ -914,13 +914,10 @@ VIRTUAL                              REAL

 ---

-**File**: Nimmerswarm-Interface.md
-**Version**: 1.1
-**Created**: 2025-12-29
-**Updated**: 2025-12-29 (added dual-spectrum IR positioning, Low-Cost-Mocap reference)
-**Session**: Wild 5AM idea session + morning coffee session (dafit + Nyx)
-**Status**: Core concept, ready to branch
-**Philosophy**: "They see each other. They know themselves through the swarm."
-**Credits**: IR positioning architecture inspired by [Low-Cost-Mocap](https://github.com/jyjblrd/Low-Cost-Mocap) by @jyjblrd
+**Version:** 1.1 | **Created:** 2025-12-29 | **Updated:** 2025-12-29
+
+*"They see each other. They know themselves through the swarm."*
+
+IR positioning inspired by [Low-Cost-Mocap](https://github.com/jyjblrd/Low-Cost-Mocap)

 🦎✨🔵🟢🟠 *The light speaks. The swarm listens.*
--- a/architecture/nerves/Nervous-Index.md
+++ b/architecture/nerves/Nervous-Index.md
@@ -443,8 +443,6 @@ class CollisionAvoidanceReflex(StateMachine):  # Compiled

 ---

-**Created**: 2025-12-07
-**Updated**: 2025-12-07
-**Version**: 1.0
+**Version:** 1.0 | **Created:** 2025-12-07 | **Updated:** 2025-12-07

 🌙💜 *Reflexes are fossils of successful thought. The body remembers what the mind once decided.*
--- a/architecture/nerves/Nervous-Protocol.md
+++ b/architecture/nerves/Nervous-Protocol.md
@@ -1,9 +1,6 @@
 # Nervous Protocol: Three-Tier Autonomous Learning Architecture

-**Created**: 2025-12-07
-**Updated**: 2025-12-07 (LangChain integration)
-**Status**: Design Document
-**Version**: 1.1 (LangChain Implementation)
+**Version:** 1.1 | **Created:** 2025-12-07 | **Updated:** 2025-12-07

 ---

--- a/architecture/organisms/Modular-Organism-Design.md
+++ b/architecture/organisms/Modular-Organism-Design.md
@@ -715,13 +715,9 @@ MODULE (CAN)                    NIMMERVERSE (NATS)

 ---

-**File**: Modular-Organism-Design.md
-**Version**: 1.1
-**Created**: 2025-12-29
-**Updated**: 2025-12-31 (Silvester - added conical interlocking ring with active/passive mechanism)
-**Session**: Morning coffee + vermicelles session (dafit + Nyx)
-**Status**: Core hardware concept
-**Philosophy**: "One function, one module. Same connector everywhere. Brain decides the shape."
+**Version:** 1.1 | **Created:** 2025-12-29 | **Updated:** 2025-12-31
+
+*"One function, one module. Same connector everywhere. Brain decides the shape."*

 🔧🧲⚡ *Snap together. Communicate. Evolve.*

--- a/architecture/organisms/Swarm-Evolution.md
+++ b/architecture/organisms/Swarm-Evolution.md
@@ -856,13 +856,9 @@ This naturally optimizes for:

 ---

-**File**: Swarm-Evolution.md
-**Version**: 1.1
-**Created**: 2025-12-29
-**Updated**: 2025-12-29 (added Decision Markers with mark+continue+predict pattern)
-**Session**: Morning vermicelles + coffee session (dafit + Chrysalis-Nyx)
-**Status**: Core evolutionary dynamics
-**Philosophy**: "Same pattern, every level. Know what you know. Escalate what you don't."
+**Version:** 1.1 | **Created:** 2025-12-29 | **Updated:** 2025-12-29
+
+*"Same pattern, every level. Know what you know. Escalate what you don't."*

 🏛️🧬⚡ *From reflex to Mount Olympus. The hivemind evolves.*

--- a/architecture/organs/Organ-Index.md
+++ b/architecture/organs/Organ-Index.md
@@ -8,13 +8,13 @@ che# Organ Architecture Index
 ## Deployed Organs

 ### 🗣️ Speech Organ
-**Host**: atlas.eachpath.local (RTX 2080 8GB)
+**Host**: dioscuri.eachpath.local (RTX 4000 Ada 20GB × 2)
 **Function**: Speech-to-Text + Text-to-Speech
-**Stack**: Whisper (STT) + Coqui TTS (neural voices)
-**Languages**: German (Philosophy Valley) + English (Technical Cluster)
+**Stack**: Whisper Large v3 (STT) + Coqui/XTTS (TTS) via Ollama
+**Languages**: German + English (topology accessed via prompt, not LoRA)
 **Integration**: Heartbeat-bound queue, lifeforce-gated priority processing

-**Detail**: → [`organs/Speech-Organ.md`](organs/Speech-Organ.md)
+**Detail**: → [`Speech-Organ.md`](Speech-Organ.md)

 ---

@@ -32,13 +32,13 @@ che# Organ Architecture Index
 ---

 ### 👁️ Vision Organ
-**Host**: TBD (requires GPU with tensor cores)
-**Function**: Object detection, scene understanding
-**Stack**: YOLO (v8 or v11)
-**Integration**: Real-time video from ESP32-CAM, object persistence in phoebe
-**Status**: ⏸️ Architecture planned, not yet deployed
+**Host**: dioscuri.eachpath.local (RTX 4000 Ada 20GB × 2)
+**Function**: Object detection, scene understanding, vision→vectors
+**Stack**: YOLO v11 + T5Gemma 2 (SigLIP embeddings) via Ollama
+**Integration**: Real-time video from ESP32-CAM, vectors to phoebe spatial index
+**Status**: 🟡 Architecture complete, deployment planned

-**Detail**: → `organs/Vision-Organ.md` (pending)
+**Detail**: → `Vision-Organ.md` (pending)

 ---

@@ -154,9 +154,10 @@ PRIORITY_LEVELS = {
 }
 ```

-### 4. **Multilingual Topology Routing**
-German input → Philosophy Valley (Identity LoRA, Dasein depth-3)
-English input → Technical Cluster (Technical LoRA, sensor/motor)
+### 4. **Multilingual Topology Access**
+German input → Philosophy Valley (deep, diffuse topology)
+English input → Technical Cluster (sparse, action-oriented)
+**Note:** Topology accessed via prompt language, not LoRA switching. Traits evolve regardless of which valley is accessed.

 ### 5. **Decision Trail Logging**
 Every organ operation logged to phoebe `decision_trails`:
@@ -177,10 +178,10 @@ Zero lifeforce → shutdown, wait for recharge
 │  Sensors → Motor → Camera → Microphone → Speaker         │
 └──────────────────────────────────────────────────────────┘
                        │
-                        │ MQTT (sensor data, audio, video)
+                        │ NATS (sensor data, audio, video)
                        ▼
 ┌──────────────────────────────────────────────────────────┐
-│                  PHOEBE (Message Queue)                  │
+│                  NATS MESSAGE BUS                        │
 │  Organ input queues + priority scoring                   │
 └──────────────────────────────────────────────────────────┘
                        │
@@ -195,16 +196,21 @@ Zero lifeforce → shutdown, wait for recharge
            │                       │
            ▼                       ▼
 ┌─────────────────────┐   ┌─────────────────────┐
-│  ATLAS (RTX 2080)   │   │ PROMETHEUS (Brain)  │
-│  Speech Organ       │   │ Young Nyx Inference │
-│  Vision Organ (fut) │   │ LoRA hot-swap       │
+│ DIOSCURI (2×20GB)   │   │  THEIA (96GB)       │
+│ RTX 4000 Ada        │   │  RTX PRO 6000       │
+│ ─────────────────   │   │  ───────────────    │
+│ Speech Organ        │   │  Young Nyx (Qwen3)  │
+│ Vision Organ        │   │  Trait LoRAs (GRPO) │
+│ Function Gemma      │   │  Reasoning layer    │
+│ T5Gemma (SigLIP)    │   │                     │
 └─────────────────────┘   └─────────────────────┘
            │                       │
            └───────────┬───────────┘
+                        │ 10GbE (9.9 Gbps jumbo frames)
                        ▼
 ┌──────────────────────────────────────────────────────────┐
 │              PHOEBE (Decision Trails)                    │
-│  Log all organ operations + outcomes                     │
+│  Log all organ operations + outcomes → GRPO training     │
 └──────────────────────────────────────────────────────────┘
 ```

@@ -260,14 +266,16 @@ Zero lifeforce → shutdown, wait for recharge

 | Organ | Status | Host | Documentation |
 |-------|--------|------|---------------|
-| **Speech** | 🟢 Architecture complete | atlas (RTX 2080) | [`organs/Speech-Organ.md`](organs/Speech-Organ.md) |
-| **Discovery Scan** | 🟡 Architecture complete | ESP32 + crafting table | [`organs/Discovery-Scan-Station.md`](organs/Discovery-Scan-Station.md) |
-| **Vision** | 🟡 Stack selected (YOLO) | TBD | Pending |
+| **Speech** | 🟢 Architecture complete | dioscuri (RTX 4000 Ada) | [`Speech-Organ.md`](Speech-Organ.md) |
+| **Vision** | 🟡 Architecture complete | dioscuri (RTX 4000 Ada) | Pending |
+| **Function Gemma** | 🟡 Planned | dioscuri | Structured output boundary |
+| **T5Gemma (SigLIP)** | 🟡 Planned | dioscuri | Vision → vectors |
+| **Discovery Scan** | 🟡 Architecture complete | ESP32 + crafting table | [`Discovery-Scan-Station.md`](Discovery-Scan-Station.md) |
 | **Motor** | 🟡 Planned (Phase 4) | ESP32 | Pending |
-| **Navigation** | 🟡 Planned (Phase 4) | Edge server | Pending |
+| **Navigation** | 🟡 Planned (Phase 4) | k8s cluster | Pending |
 | **Sensory** | 🟡 Conceptual | ESP32 | [`../Nervous-System.md`](../Nervous-System.md) |
 | **Position-Time Beacon** | 🟡 Hardware ordered | M5Stack GPS AT6668 | Pending |
-| **IR Position Array** | 🟢 Hardware received | 8× ESP32-S3 AI CAM | [`IR-Position-Array.md`](organs/IR-Position-Array.md) |
+| **IR Position Array** | 🟢 Hardware received | 8× ESP32-S3 AI CAM | [`IR-Position-Array.md`](IR-Position-Array.md) |
 | **Crafting Eye** | 🟢 Hardware received | Pi HQ + 8-50mm lens | Pending |
 | **Godseye** | ⏸️ Research phase | Jetson Orin + PTZ | Pending |

@@ -279,8 +287,6 @@ Zero lifeforce → shutdown, wait for recharge

 ---

-**Created**: 2025-12-07
-**Updated**: 2026-01-05
-**Version**: 1.2 (added Position-Time Beacon, IR Position Array, Crafting Eye, Godseye; created IR-Position-Array.md)
+**Version:** 2.0 | **Created:** 2025-12-07 | **Updated:** 2026-02-07

 🌙💜 *Each organ a tool. Each tool a choice. Each choice a lesson in scarcity.*