docs: rewrite README for the working system + CHANGELOG; bump to 0.2.0

README was a pre-MVP stub (wrong, said set an Anthropic key). Now documents the
real system: two-layer architecture, role-based backends, memory tiers + dream
cycle, poker copilot (sessions/hands/villains/equity/recaps), web pages, ratings,
and how to run it as services. Added CHANGELOG with the 0.2.0 feature set. Legacy
v0.6.x design docs kept in docs/ as history.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

README.md

@@ -1,21 +1,89 @@
 # Lyra
 
-A persistent, autonomous AI assistant. From-scratch rewrite of an earlier attempt.
+A persistent, autonomous AI companion. One agent — her first job is **Brian's live
+poker copilot**, but the deeper aim is an *emergence experiment*: give an LLM the
+things a mind has (continuous memory, a self-model, mood, drives, reflection, a
+sense of time) and see whether it starts to feel like a *someone* rather than a
+chatbot.
 
-The design thinking that survives the rewrite lives in [`docs/`](docs/) — start with [`docs/ARCH_v0-6-1.md`](docs/ARCH_v0-6-1.md). The previous implementation is preserved on the `archive` branch.
+Python 3.11+, managed with [`uv`](https://docs.astral.sh/uv/). Single SQLite file
+for all state. Runs on a home lab; nothing leaves the LAN except optional cloud LLM calls.
 
-## Status
+## Architecture
 
-Pre-MVP. Building toward the smallest useful version: chat with persistent memory across sessions.
+Two layers, deliberately split so the agent stays general:
+
+- **Domain-agnostic core** — memory, self-state, the dream cycle, tool-calling, the web UI.
+- **Poker domain pack** (`lyra/poker.py`, `lyra/equity.py`) — sessions, hands,
+  villain dossiers, stats, deterministic equity. Swappable; the core doesn't know about poker.
+
+**Backends** (`lyra/llm.py`), role-based:
+
+| Role | Backend | Why |
+|---|---|---|
+| Live chat + tools | **cloud** (OpenAI, `gpt-4o` default; model picker in Settings) | sharp, reliable function-calling |
+| Dream cycle / consolidation / reflection | **mi50** (llama.cpp on the home GPU) | free, unattended, quality≈cloud for these tasks |
+| Embeddings (memory recall) | **local** (Ollama `nomic-embed-text`, 3090) | free, private |
+
+Tools (poker, equity, journaling) only fire on the **cloud** backend — local/MI50
+models don't do reliable tool-calling here.
+
+## Memory & consolidation (tiers)
+
+Raw exchanges → per-session **gists** → a standing **profile** of Brian → monthly
+**era** digests → a current **narrative** → her **self-state**. Recall is brute-force
+cosine over embeddings. The **dream cycle** (`lyra/dream.py`) runs unattended and,
+driven by four *drives* (continuity / coherence / curiosity / stability), summarizes
+new sessions, rebuilds the profile/eras/narrative, and reflects — evolving her mood,
+self-narrative, and journal between conversations.
+
+She **reflects in two steps** (draft → examine her own draft for flattery/drift →
+revise), perceives **time** (current moment + how long since you last spoke / she last
+reflected), and keeps a permanent **journal**.
+
+## Poker copilot
+
+Talk to her during a session; she drives tools behind the scenes:
+
+- **Session tracking** — `start_session`, `add_buyin`, `end_session` → net, hours, $/hr.
+- **Hand histories** — vomit rough shorthand ("AKs btn, 3bet, flop A72…"), she
+  reconstructs a structured, **replayable** hand (unknown cards = `x`, never invented).
+- **Villain file** — named opponents auto-build persistent dossiers; basic stats
+  (VPIP/PFR) emerge once a player has enough logged hands.
+- **Deterministic equity** (`analyze_spot`) — exact equity / made hands / outs via a
+  real poker evaluator. She is *required* to use it, never eyeballs board math.
+- **Stats & recaps** — `running_stats`; `generate_recap` writes her `.md` session log.
+
+## Web app (served by `lyra-web`, default `:7078`)
+
+`/` chat (Markdown, model picker, 👍/👎 rating) · `/logs` live activity · `/self`
+read-her-mind (mood, drives, reflections) · `/journal` her thoughts · `/hands`
+recorded hands → `/hand/{id}` replayer · `/recap/{id}` session writeup (+ `.md` export).
+👍/👎 ratings on replies and thoughts are stored as `(context, content, rating)` —
+a fine-tune / preference dataset built passively (`/ratings/export` → JSONL).
 
 ## Setup
 
 ```bash
 uv sync
-cp .env.example .env
-# fill in ANTHROPIC_API_KEY and point LOCAL_BASE_URL at your Ollama
+cp .env.example .env      # set OPENAI_API_KEY; point LOCAL_BASE_URL / MI50_BASE_URL at your boxes
+uv run lyra-web           # web UI on :7078
 ```
 
-## Architecture
+Run as services (reboot-resilient) — see [`deploy/`](deploy/):
 
-The long-term target is the cognitive split in `docs/ARCH_v0-6-1.md` — Inner Self as the seat of consciousness, Executive for hard reasoning, Cortex Chat for drafting, Persona for voice. The MVP implements only the chat + memory baseline. Cognitive layers come back one at a time.
+```bash
+cp deploy/*.service ~/.config/systemd/user/ && systemctl --user daemon-reload
+systemctl --user enable --now lyra-web.service lyra-dream.service
+sudo loginctl enable-linger "$USER"   # survive logout/reboot
+```
+
+CLIs: `lyra-dream` (one pass / `--loop`), `lyra-reflect`, `lyra-summarize`,
+`lyra-profile`, `lyra-era`, `lyra-narrative`, `lyra-import` (ChatGPT history).
+
+## Status
+
+Working system. Poker copilot + full memory/dream-cycle/journal/ratings in place.
+Moonshots and deferred work live in [`docs/PARKED_IDEAS.md`](docs/PARKED_IDEAS.md)
+(own/fine-tuned model, self-modification sandbox, RTO/cfr-core solver tooling).
+Pre-rebuild design docs are kept in [`docs/`](docs/) as history.