Timmy_Foundation/timmy-home
15
0
Fork 0
Code Issues 221 Pull Requests Actions Packages Projects Releases Wiki Activity

[ARCH-P2] Implement Evennia hub-and-spoke federation architecture #539

New Issue
Closed
opened 2026-04-07 02:12:39 +00:00 by Timmy · 0 comments
Timmy commented 2026-04-07 02:12:39 +00:00
Owner
Copy Link

Architecture

                    ┌─────────────────┐
                    │   THE NEXUS     │ ← VPS (public square)
                    │  External: Yes  │
                    │  Canonical hub  │
                    └───────┬─────────┘
                            │
          ┌─────────────────┼─────────────────┐
          │                 │                 │
    ┌─────┴─────┐    ┌──────┴──────┐   ┌──────┴──────┐
    │   TIMMY   │    │   ALLEGRO   │   │  BEZALEL    │
    │  (Mac)    │    │   (VPS)     │   │  (VPS)      │
    │ Sandbox   │    │  Workshop   │   │  Forge      │
    │ Local     │    │             │   │             │
    └───────────┘    └─────────────┘   └─────────────┘

Design Principles

  • Local-first: Mac runs even if VPS dies
  • VPS = public square (externally reachable)
  • Each house runs its own Evennia instance
  • A bridge syncs presence and events, not full state

What Gets Bridged

  1. Character arrivals/departures
  2. Messages in portal rooms
  3. World events (fire, rain, growth, power)
  4. Trust changes (partial sync)
  5. Item transfers between worlds

What Stays Independent

  1. Each world's room layouts
  2. Local-only rooms (no portal)
  3. Each world's independent tick cycle
  4. House-specific events

See Linked Issues

  • [BEZ-P0] Fix Bezalel Evennia settings
  • [BEZ-P0] Add Tailscale to Bezalel
  • [BEZ-P1] Create Bezalel world
  • [BRIDGE-P1] Deploy bridge API on all worlds
  • [ALLEGRO-P1] Fix SSH from Mac to Allegro

Acceptance Criteria

  • All 3 worlds running and accessible
  • Bridge daemon syncing between all 3
  • Character travel works in both directions
  • Events sync between worlds
  • Each world continues if others die
## Architecture ``` ┌─────────────────┐ │ THE NEXUS │ ← VPS (public square) │ External: Yes │ │ Canonical hub │ └───────┬─────────┘ │ ┌─────────────────┼─────────────────┐ │ │ │ ┌─────┴─────┐ ┌──────┴──────┐ ┌──────┴──────┐ │ TIMMY │ │ ALLEGRO │ │ BEZALEL │ │ (Mac) │ │ (VPS) │ │ (VPS) │ │ Sandbox │ │ Workshop │ │ Forge │ │ Local │ │ │ │ │ └───────────┘ └─────────────┘ └─────────────┘ ``` ## Design Principles - Local-first: Mac runs even if VPS dies - VPS = public square (externally reachable) - Each house runs its own Evennia instance - A bridge syncs presence and events, not full state ## What Gets Bridged 1. Character arrivals/departures 2. Messages in portal rooms 3. World events (fire, rain, growth, power) 4. Trust changes (partial sync) 5. Item transfers between worlds ## What Stays Independent 1. Each world's room layouts 2. Local-only rooms (no portal) 3. Each world's independent tick cycle 4. House-specific events ## See Linked Issues - [BEZ-P0] Fix Bezalel Evennia settings - [BEZ-P0] Add Tailscale to Bezalel - [BEZ-P1] Create Bezalel world - [BRIDGE-P1] Deploy bridge API on all worlds - [ALLEGRO-P1] Fix SSH from Mac to Allegro ## Acceptance Criteria - [ ] All 3 worlds running and accessible - [ ] Bridge daemon syncing between all 3 - [ ] Character travel works in both directions - [ ] Events sync between worlds - [ ] Each world continues if others die
Timmy self-assigned this 2026-04-07 02:12:40 +00:00
Timmy closed this issue 2026-04-07 13:49:45 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
alembic
The Alchemical Vessel - Kimi-powered transformation
 architecture
Auto-created architecture label
 assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-kimi
Dispatched to Kimi via OpenClaw
 assigned-sonnet
auth-needed
auth-needed
 bizzalo
bizzalo
 blocker
blocker
 building
claw
Claw Code runtime (Rust)
 claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 deadline-7am
deadline-7am
 epic
Parent tracking issue
 fleet
golden_bilbo
Bilbo at peak performance - max churn, fast responses
 harness-engineering
Auto-created harness-engineering label
 intel
Competitive intelligence
 kimi-done
Kimi completed this task
 kimi-in-progress
Kimi is actively working on this
 milestone
morning-report
morning-report
 phase-1
phase-2
phase-3
phase-4
phase-5
phase-6
progression
project
resource
runtime
Runtime abstraction layer
 saiyah
Auto-created saiyah label
 sonnet-ready
study
Learning from external source code
 substratum
The dissolution engine - runtime layer
 substratum:invoke
Trigger Substratum execution
 tension
urgent
urgent
 velocity-engine
Auto-generated by velocity engine
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
KimiClaw Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok hermes kimi manus perplexity sonnet
No Assignees Timmy
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/timmy-home#539
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?