migrated core_nest to mainroom

README.md

@@ -27,15 +27,25 @@ python main.py
 spr/
 ├── schema.json        # Model definitions (source of truth)
 ├── config/            # Framework configuration
-├── artery/            # Connectors (source)
-├── atlas/             # Documentation (source)
-├── station/           # Tools (source)
+├── ctrl/              # Soleprint room ctrl
+│
+├── artery/            # Connectors (versioned)
+├── atlas/             # Documentation (versioned)
+├── station/           # Tools (versioned)
 │   └── tools/
-│       ├── generator/ # Generates models & structure
+│       ├── generator/ # Generates models from schema
 │       ├── datagen/   # Test data generation
-│       └── tester/    # Test runner
-├── data/              # Content (JSON)
-└── gen/               # Runnable instance (run from here)
+│       └── tester/    # BDD/contract test runner
+│
+├── data/              # JSON content
+├── hub/               # Base files (main.py, dataloader, etc.)
+├── gen/               # Runnable instance (symlinks + generated models)
+│
+└── mainroom/          # Orchestration: soleprint ↔ managed room
+    ├── ctrl/          # Orchestration commands
+    ├── sbwrapper/     # Sidebar wrapper UI
+    ├── link/          # Adapters for managed apps
+    └── soleprint/     # Docker configs
 ```
 
 ## Components
@@ -62,21 +72,40 @@ cd gen
 python main.py
 ```
 
-### Regenerate models (when schema.json changes)
+### Regenerate models (one-time / rare)
 ```bash
 cd station/tools/generator
 python -m generators.orchestrator --output ../../../gen
 ```
 
+### Run with Docker (via mainroom)
+```bash
+cd mainroom/soleprint
+docker compose up -d
+```
+
 ## Ports
 
 | Service | Port |
 |---------|------|
-| Hub | 12000 |
+| Hub (soleprint) | 12000 |
 | Artery | 12001 |
 | Atlas | 12002 |
 | Station | 12003 |
 
+## Architecture
+
+```
+hub/           →  Versioned base files (main.py, dataloader)
+gen/           →  Runnable instance (symlinks to hub/ + systems)
+gen/models/    →  Generated once per client (like install)
+
+mainroom/      →  Orchestration layer
+├── sbwrapper  →  UI overlay for managed apps
+├── link       →  Data adapters (no modification to either side)
+└── soleprint  →  Docker for soleprint services
+```
+
 ## Background
 
 Born from the friction of: