From 4f5a59641b2647c82e4460d0fb687c127e7352d1 Mon Sep 17 00:00:00 2001 From: Alexander Whitestone Date: Fri, 27 Mar 2026 17:15:57 -0400 Subject: [PATCH] docs: clarify active architecture and repo boundaries --- OPERATIONS.md | 19 ++++---- decisions.md | 130 +++----------------------------------------------- 2 files changed, 17 insertions(+), 132 deletions(-) diff --git a/OPERATIONS.md b/OPERATIONS.md index 33fb04e..c9a97bc 100644 --- a/OPERATIONS.md +++ b/OPERATIONS.md @@ -1,12 +1,12 @@ # Timmy Operations — What Runs the Workforce -## ACTIVE SYSTEM: Sovereign Orchestration -- **Repo:** Timmy_Foundation/sovereign-orchestration -- **Local:** ~/.timmy/sovereign-orchestration/ -- **Entry point:** python3 src/sovereign_executor.py --workers 3 --poll 30 -- **Task queue:** SQLite (crash-safe, durable) -- **Status:** Getting deployed (issues #29, #30) -- **Target repos:** Timmy_Foundation/the-nexus, Timmy_Foundation/autolora +## ACTIVE SYSTEM: Hermes + timmy-config sidecar +- **Harness:** Hermes +- **Config repo:** Timmy_Foundation/timmy-config +- **Workspace repo:** Timmy_Foundation/timmy-home +- **Orchestration:** Huey + SQLite via `timmy-config/orchestration.py` and `timmy-config/tasks.py` +- **Target repos:** Timmy_Foundation/the-nexus, Timmy_Foundation/timmy-home, Timmy_Foundation/timmy-config +- **Training data home:** `~/.timmy/training-data/` ## DEPRECATED — DO NOT RESTORE - bash loops (claude-loop.sh, gemini-loop.sh, timmy-orchestrator.sh) @@ -16,7 +16,8 @@ - All scripts in timmy-config/bin/ are LEGACY These crash-loop and produce zero work. They were restored by mistake -on 2026-03-25 causing a regression. The sovereign executor replaces them. +on 2026-03-25 causing a regression. The Hermes + timmy-config sidecar +replaces them. ## How to check what's running ```bash @@ -30,5 +31,5 @@ ps aux | grep -E "claude-loop|gemini-loop|timmy-orchestrator" | grep -v grep ## Cron Jobs (Hermes built-in) - Health Monitor: every 5m, haiku (not opus!) -- AutoLoRA training: every 45m, haiku +- DPO export / training support jobs: explicit model, explicit task, no hidden defaults - All crons MUST specify model explicitly. Never inherit default. diff --git a/decisions.md b/decisions.md index cb0cae3..ea7e757 100644 --- a/decisions.md +++ b/decisions.md @@ -44,129 +44,13 @@ This is the minimal implementation path for honest Timmy. Two key bugs identifie Priority: Fix these bugs before building the pipeline. ----## 2026-03-24 13:13 UTC — Use SQLite for storage +## 2026-03-27 — Repo boundary clarified ---- +`timmy-home` is the lived workspace: gameplay, archive reading, trajectories, +training-data exports, notes, metrics, and research. -## 2026-03-24 13:13 UTC — First decision - ---- - -## 2026-03-24 13:13 UTC — Second decision - ---- - -## 2026-03-24 13:13 UTC — Use Redis - -Fast in-memory cache - ---- - -## 2026-03-24 15:22 UTC — Use Redis - -Fast in-memory cache - ---- - -## 2026-03-24 15:22 UTC — Use SQLite for storage - ---- - -## 2026-03-24 15:22 UTC — First decision - ---- - -## 2026-03-24 15:22 UTC — Second decision - ---- - -## 2026-03-24 19:50 UTC — Use SQLite for storage - ---- - -## 2026-03-24 19:50 UTC — First decision - ---- - -## 2026-03-24 19:50 UTC — Second decision - ---- - -## 2026-03-24 19:50 UTC — Use Redis - -Fast in-memory cache - ---- - -## 2026-03-24 19:51 UTC — Use SQLite for storage - ---- - -## 2026-03-24 19:51 UTC — First decision - ---- - -## 2026-03-24 19:51 UTC — Second decision - ---- - -## 2026-03-24 19:51 UTC — Use Redis - -Fast in-memory cache - ---- - -## 2026-03-24 20:19 UTC — Use SQLite for storage - ---- - -## 2026-03-24 20:19 UTC — Use Redis - -Fast in-memory cache - ---- - -## 2026-03-24 20:19 UTC — First decision - ---- - -## 2026-03-24 20:19 UTC — Second decision - ---- - -## 2026-03-24 20:19 UTC — Use SQLite for storage - ---- - -## 2026-03-24 20:19 UTC — First decision - ---- - -## 2026-03-24 20:19 UTC — Second decision - ---- - -## 2026-03-24 20:19 UTC — Use Redis - -Fast in-memory cache - ---- - -## 2026-03-24 20:21 UTC — First decision - ---- - -## 2026-03-24 20:21 UTC — Second decision - ---- - -## 2026-03-24 20:21 UTC — Use SQLite for storage - ---- - -## 2026-03-24 20:21 UTC — Use Redis - -Fast in-memory cache - ---- +`timmy-config` is the sidecar: soul, memories, playbooks, skins, harness +configuration, and lightweight orchestration glue. +Hermes owns the harness. Training should flow from Timmy's lived work and DPO +artifacts, not from re-growing a bespoke training pipeline inside every repo.