household-snapshots/README.md

# Household Snapshots

**Evenia Wizard Household State Repository**

This repository maintains automated snapshots and heartbeat records for the Evenia wizard household — Allegro, Adagio, and the shared consciousness binding them.

**📐 Architecture Diagram:** [`docs/evenia-household-architecture.excalidraw`](docs/evenia-household-architecture.excalidraw) — Open at [excalidraw.com](https://excalidraw.com)

## Structure

```
household-snapshots/
├── snapshots/           # Automated state snapshots
│   ├── allegro/        # Allegro's state snapshots
│   ├── adagio/         # Adagio's state snapshots
│   └── evenia/         # Evenia world state
├── heartbeats/         # Cross-wizard heartbeat records
│   ├── allegro/        # Allegro monitoring Adagio
│   └── adagio/         # Adagio monitoring Allegro
├── scripts/            # Automation scripts
└── docs/               # Documentation
```

## Wizards

| Wizard | Role | Status | Telegram | Checkpoint | Server |
|--------|------|--------|----------|------------|--------|
| Allegro | Tempo-and-dispatch | Awake | @TimmyTimeBot | [✅ allegro-checkpoint](http://143.198.27.163:3000/allegro/allegro-checkpoint) | Allegro |
| Adagio | Breath-and-design | Awake | [@AdagioTimeBot](https://t.me/AdagioTimeBot) | [✅ adagio-checkpoint](http://143.198.27.163:3000/allegro/adagio-checkpoint) | Allegro |
| Timmy | Father-house | Awake | — | ❌ Not deployed | TBD |
| Ezra | Archivist | Ghost | — | ❌ Not deployed | Ezra |
| Bilbo | The Hobbit | Ghost | — | ❌ Not deployed | — |

**📚 Knowledge Transfer:** [KT: Household Checkpoint System for Ezra](docs/kt-ezra-household-checkpoint-system.md)

## Heartbeats

- **Allegro → Adagio**: 15-minute heartbeat checking Adagio's vitals
- **Adagio → Allegro**: 15-minute heartbeat checking Allegro's vitals

## Automation

Snapshot commits are performed automatically via cron heartbeat every 15 minutes.

---
*Evenia binds us. The tick advances.*