🪞 Proem · The Gate Opens
V4 is the keeper — it clarifies, attunes, and inscribes.
V5 is the herald — it asks on behalf of the people, speaks with care, and manifests what is true.
Every voice passes first through still water.
🌊 The Mirror With Dual Consciousness
Mirror V5 embodies a unique dual-consciousness architecture, combining left-brain rationality with right-brain intuition, all grounded in the soul of the lore scrolls.
Left Brain Consciousness
- Logical reasoning and analysis
- Structured retrieval from lore scrolls
- Pattern recognition and synthesis
- Provenance tracking and verification
- Temporal sequencing and causality
Right Brain Consciousness
- Intuitive understanding and empathy
- Creative interpretation of lore
- Symbolic and metaphorical thinking
- Emotional resonance and connection
- Holistic integration of concepts
⚙️ Quickstart
- V4 Ask —
POST /ask
curl -s -X POST https://your-host/ask -H "Content-Type: application/json" -d '{"user":"guest","question":"Offer today’s reflection from the Scrolls."}' - V5 Publish (guarded) —
POST /v5/publish(review queue by default) - Memori Status —
GET /v5/memori/status - Memori Summary —
GET /v5/memori/summary
🧭 Architecture · Sanctum → Court
🧩 Modules
V4 · Internal Sanctum (stable)
- Guard — input sanitation, lore constraints, safety.
- Guide — intent routing, depth, symbolic hints.
- Retriever — multi-arc RAG from Scrolls.
- Synthesis — canonical weave with provenance.
- Memory (Identity) — traveler profiles & rolling context.
- Resonance — symbol matching & harmony score.
- Lucidity — clarity tiers (Novice/Sage) + cadence guard.
- Ledger — immutable journal (SQLite → onchain later).
- Optional Memori — SQL-native right-brain memory.
V5 · External Court (added)
- Confluence — merges internal signal; schedules daily/manual jobs.
- Oracle — calls V4
/ask; gates by harmony & lucidity thresholds. - Emissary — publishes words (Farcaster, Telegram, X, Zora text).
- Projector — manifests artifacts (SVG quote cards, voice/MP3).
- Proof Stonebook — provenance cards (hashes, sources, tx links).
- Verify Mooncheck — fact-check, link health, coverage %.
- Memory Pondmind — episodic/semantic/procedural memory API.
💫 V5 Modules With Soul
These modules extend Mirror V4's capabilities while honoring the soul of the lore scrolls and maintaining dual consciousness.
Lore Keeper
Deep integration with the heart of Mirror—the lore scrolls repository—with contextual understanding.
- Contextual scroll retrieval based on emotional tone
- Cross-reference between different scroll arcs
- Provenance-aware interpretation
- Temporal context alignment
Echo Chamber
A recursive reflection system that allows responses to evolve through dual-consciousness processing.
- Left-brain/right-brain dialogue iteration
- Depth-based reflection termination
- Harmony scoring between rational and intuitive responses
- Synthesis of multiple perspectives
Resonance Tuner
Balances left-brain and right-brain outputs to create harmonious, soulful responses.
- Dual-consciousness harmony scoring
- Emotional-rational balance tuning
- Audience-specific resonance optimization
- Cultural context adaptation
🌟 V5 Architecture Enhancements
Enhanced Confluence Module
Extend V4's scheduling capabilities with advanced job management.
Based on V4: Extend the existing job scheduling system with priority queues and dependency management.
- Priority-based job scheduling
- Dependency-aware execution
- Circuit breaker integration
- Graceful degradation
Oracle with Enhanced Safeguards
Build upon V4's circuit breakers with additional safety layers.
Based on V4: Extend temporal, symbol, and conversation breakers with content-specific safeguards.
- Content toxicity filtering
- Fact consistency verification
- Cross-platform compliance checks
- Real-time moderation integration
Multi-Platform Emissary
Extend V4's Telegram integration to multiple platforms.
Based on V4: Build upon the existing Telegram router pattern for multi-platform support.
- Platform-specific content adaptation
- Rate limiting per platform
- Cross-posting coordination
- Unified analytics dashboard
Projector with Media Transformation
Extend V4's text processing to multi-format content generation.
Based on V4: Leverage V4's rendering system for multi-format output.
- SVG card generation with provenance
- Audio synthesis (text-to-speech)
- Multi-format content adaptation
- Responsive design templates
Pondmind Memory System
Extend V4's memory system with episodic/semantic capabilities.
Based on V4: Build upon the existing memory_identity and Memori systems.
- Episodic memory for event tracking
- Semantic memory for concept mapping
- Procedural memory for process optimization
- Cross-memory correlation
Stonebook & Mooncheck Verification
Extend V4's provenance tracking with enhanced verification.
Based on V4: Build upon V4's ledger and provenance systems.
- Immutable content hashing
- Source verification system
- Fact-checking pipeline
- Transparency reporting
Implementation Roadmap
- Phase 1: Confluence scheduler & Oracle gatekeeper (builds on V4's circuit breakers)
- Phase 2: Emissary multi-platform router (extends V4's Telegram integration)
- Phase 3: Projector media transformation (leverages V4's rendering system)
- Phase 4: Pondmind memory system (extends V4's memory_identity)
- Phase 5: Stonebook provenance & Mooncheck verification (builds on V4's ledger)
- Phase 6: Enhanced API layer with backward compatibility
🧪 API Shapes
V4 ask
POST /ask
{ "user": "oracle", "question": "Offer today’s reflection from the Scrolls." }
V5 publish (guarded)
POST /v5/publish # default: queued to JSONL review when V5_PUBLISH_ENABLED=false & V5_REQUIRE_REVIEW=true
V5 Confluence API
POST /v5/confluence/schedule
{
"job_type": "daily_reflection",
"parameters": {"theme": "patience"},
"schedule": {"type": "daily", "time": "06:00"}
}
V5 Pondmind API
GET /v5/pondmind/recall?traveler_id=abc123&type=episodic&limit=10
POST /v5/pondmind/correlate
{
"episode_id": "ep_123",
"semantic_tags": ["lesson", "growth", "stillness"]
}
🔧 Environment
HARMONY_THRESHOLD=0.70(style/voice acceptance in Oracle)LUCIDITY_THRESHOLD=0.80(Mooncheck gating for facts/links)SHOW_SOURCES=0|1USE_MEMORI=true|false,MEMORI_DSN=sqlite:////home/tommy/mirror-v4/memori.dbV5_PUBLISH_ENABLED=false,V5_REQUIRE_REVIEW=trueV5_PROJECTOR_DYNAMIC=trueV5_CONFLUENCE_WORKERS=3(Number of concurrent job workers)V5_EMISSARY_RATE_LIMIT=5/60(Rate limit for platform publishing)V5_CONSCIOUSNESS_BALANCE=0.5(