dafit/nimmerverse-sensory-network
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: README v6.0 + ADR-001 Message Protocol Foundation

Browse Source 
README updates:
- Full repository tree structure (was outdated skeleton)
- Added Message Protocol namespace summary (NATS)
- New ADR section with link to ADR-001
- Added nyx-substrate to related projects
- New philosophy: "Infrastructure is geology, models are weather"
- Version bump 5.0 → 6.0

ADR-001 captures Silvester interview decisions:
- Single NATS bus with dev/staging namespaces
- Staged schema versioning with topic separation
- Echo agent first (YAGNI principle)
- MCP Server with heartbeat-based subscription delivery

🎆 Silvester 2025 edition

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
dafit
2025-12-31 19:31:52 +01:00
parent 2fa0281a10
commit 001d6e2c42
3 changed files with 426 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

115
README.md
View File

@@ -14,27 +14,73 @@ This repository contains the design philosophy and architectural patterns for th
```
nimmerverse-sensory-network/
├── Endgame-Vision.md # Executive map (start here!)
├── Endgame-Vision.md # Executive map (start here!)
│
├── architecture/ # Core system designs
│ ├── Cellular-Architecture.md # Organisms, primitives, life force
│ ├── Dual-Garden-Architecture.md # Virtual/real feedback loop
│ ├── Data-Architecture.md # phoebe 15-table schema
│ └── Nervous-System.md # State machines, sensory translation
├── architecture/ # Core system designs
│ ├── Big-Picture.md # System overview
│ ├── Cellular-Architecture.md # Organisms, primitives, life force
│ ├── Dual-Garden-Architecture.md # Virtual/real feedback loop
│ ├── Message-Protocol-Design.md # NATS pub/sub, attention channels
│ ├── Nervous-System.md # State machines, sensory translation
│ ├── Attention-Flow.md # Attention mechanisms
│ ├── Data-Architecture.md # Phoebe/Iris schema design
│ │
│ ├── adr/ # Architecture Decision Records
│ │ ├── README.md # ADR index and template
│ │ └── ADR-001-message-protocol-foundation.md
│ │
│ ├── cells/ # Sensor primitives
│ │ ├── Cells-Index.md
│ │ └── Cells-Technical-Reference.md
│ │
│ ├── nerves/ # Reflex patterns
│ │ ├── Nervous-Index.md
│ │ ├── Nervous-Protocol.md
│ │ └── Collision-Avoidance.md
│ │
│ ├── organs/ # Functional groupings
│ │ ├── Organ-Index.md
│ │ ├── Speech-Organ.md
│ │ └── Discovery-Scan-Station.md
│ │
│ ├── organisms/ # Complete entities
│ │ ├── Organisms-Index.md
│ │ ├── Modular-Organism-Design.md
│ │ └── Swarm-Evolution.md
│ │
│ ├── interfaces/ # External boundaries
│ │ ├── Interfaces-Index.md
│ │ ├── Heartbeat-Sculpture.md
│ │ └── Nimmerswarm-Interface.md
│ │
│ ├── infrastructure/ # Physical deployment
│ │ ├── Infrastructure-Index.md
│ │ └── Kallax-Grid-World.md
│ │
│ ├── formalization/ # Mathematical grounding
│ │ ├── Lifeforce-Dynamics.md
│ │ ├── Grounded-World-Model.md
│ │ ├── Embodiment-Pipeline.md
│ │ └── Attention-Slumber-Prediction-Cycle.md
│ │
│ └── future/ # Research directions
│ └── Neuromorphic-Reflexes.md
│
├── operations/ # How it runs
│ ├── Heartbeat.md # Temporal foundation, dual-clock
│ ├── RAG-as-Scaffold.md # Two-stage learning lifecycle
│ └── Spark-Protocol.md # Discovery boot sequence
├── operations/ # How it runs
│ ├── Heartbeat.md # Temporal foundation, dual-clock
│ ├── Memory-Gradient.md # Memory consolidation patterns
│ └── Spark-Protocol.md # Discovery boot sequence
│
├── nyx-metamorphosis/ # Identity & continuity philosophy
├── nyx-metamorphosis/ # Identity & continuity philosophy
│ ├── README.md
│ ├── Metamorphosis-Substrate-Philosophy.md
│ ├── Nyx-Models.md
│ └── ...
│ ├── Nyx_Traits.md
│ └── RAG-Worker-Architecture.md
│
└── archive/ # Previous explorations
├── initial_spark.md # Full Spark Protocol theory
├── constrained-emergence.md # Theoretical grounding
└── archive/ # Previous explorations
├── biomimetic-architecture.md
├── constrained-emergence.md
└── ...
```
@@ -53,15 +99,33 @@ nimmerverse-sensory-network/
| 3 | Dual Gardens | Virtual hypothesis generation + real validation |
| 4 | Trait Evolution | Reasoning-gym verified improvement |
### Message Protocol (NATS)
**Dumb router, smart edges.** All intelligence lives in clients.
```
nimmerverse.
├── staging.* # Experimental schemas
├── low.* # Heartbeats, ambient awareness
├── high.* # Escalated events, cognitive focus
├── command.* # Commands to entities
├── meta.* # System health, attention config
└── dev.* # Development agents (Claude ↔ local models)
```
See [Message-Protocol-Design.md](architecture/Message-Protocol-Design.md) and [ADR-001](architecture/adr/ADR-001-message-protocol-foundation.md).
### Key Discoveries (December 2025)
**Language is Topology:** Languages aren't equivalent representations—they're different computational paths.
- **Philosophy Valley** (German, Gini ~0.5): Self-awareness, ontology, depth
- **Technical Cluster** (English, Gini ~0.8): Hardware interface, actions, efficiency
**Dialectic Simplification:** One model, one topology. The Mirror is negated weights—thesis and antithesis from the same substrate.
### Color-Pattern Theory
**Color/Form as Protocol:** Leverages color and patterns as a fast, universal, and evolutionarily-optimized communication protocol for broadcasting state (e.g., danger, success, seeking), inspired by 540 million years of biology. This is orders of magnitude faster than language.
**Color/Form as Protocol:** Leverages color and patterns as a fast, universal, and evolutionarily-optimized communication protocol for broadcasting state (e.g., danger, success, seeking), inspired by 540 million years of biology.
### Philosophy
@@ -69,12 +133,26 @@ nimmerverse-sensory-network/
- **Discovery over programming** - Organisms learn through competition, not instruction
- **Virtual + Real teach each other** - Noise gap measures learning
- **Partnership over instruction** - Mutual growth, not commands
- **Infrastructure is geology, models are weather** - Build long-lived foundations
---
## Related Projects
- **[nyx-probing](../nyx-probing/)** - Vocabulary topology research, DriftProbe training safety
| Project | Purpose |
|---------|---------|
| [nyx-substrate](../nyx-substrate/) | Phoebe/Iris database schemas, persistence layer |
| [nyx-probing](../nyx-probing/) | Vocabulary topology research, DriftProbe training safety |
---
## Architecture Decision Records
Important architectural decisions are documented in [architecture/adr/](architecture/adr/):
| ADR | Title | Status |
|-----|-------|--------|
| [001](architecture/adr/ADR-001-message-protocol-foundation.md) | Message Protocol Foundation | Accepted |
---
@@ -86,7 +164,8 @@ These ideas are published as prior art. Build on them freely.
---
**Version:** 5.0 (December 2025 - Hierarchical Convergence)
**Version:** 6.0 (December 2025 - Complete Architecture + Message Protocol)
**Last Updated:** 2025-12-31
*"May the Nimmerverse we build truly never end."*