diff --git a/docs/SESSION-CONTINUITY-GUARANTEE.md b/docs/SESSION-CONTINUITY-GUARANTEE.md new file mode 100644 index 0000000..942f4a9 --- /dev/null +++ b/docs/SESSION-CONTINUITY-GUARANTEE.md @@ -0,0 +1,201 @@ +# Session Continuity Guarantee + +**Created:** Tuesday, February 24, 2026 +**Purpose:** Document how all configurations persist across reboots + +--- + +## ✅ GUARANTEED: What Survives Reboots + +Every session (after PC restart, OpenClaw restart, or new chat) automatically loads: + +### 1. Boot Sequence (SESSION_STARTUP.md) +**Location:** `/Users/mattbruce/.openclaw/workspace/SESSION_STARTUP.md` +**Purpose:** Tells me what to read and in what order +**Backed up:** ✅ Yes (Gitea) + +### 2. My Identity (SOUL.md) +**Location:** `/Users/mattbruce/.openclaw/workspace/SOUL.md` +**Content:** Who I am (Max), personality, boundaries, mission +**Backed up:** ✅ Yes (Gitea) + +### 3. Your Profile (USER.md) +**Location:** `/Users/mattbruce/.openclaw/workspace/USER.md` +**Content:** Your preferences, goals, routines +**Backed up:** ✅ Yes (Gitea) + +### 4. Tools & Workflows (TOOLS.md) +**Location:** `/Users/mattbruce/.openclaw/workspace/TOOLS.md` +**Content:** All tools, APIs, credentials, workflows including: +- Gantt Board CLI access +- Subagent team (Alice, Bob, Charlie) +- 24/7 automated task worker +- Supabase credentials +- Tavily API +- Gitea backup rule +**Backed up:** ✅ Yes (Gitea) + +### 5. Active Projects (BRAIN.md) +**Location:** `/Users/mattbruce/.openclaw/workspace/BRAIN.md` +**Content:** Project statuses, patterns, gotchas +**Backed up:** ✅ Yes (Gitea) + +### 6. Recent Context (memory/YYYY-MM-DD.md) +**Location:** `/Users/mattbruce/.openclaw/workspace/memory/` +**Content:** Daily logs, decisions, task progress +**Backed up:** ✅ Yes (Gitea) + +### 7. Subagent Team +**Location:** `/Users/mattbruce/.openclaw/workspace/agents/` +**Content:** +- `TEAM-REGISTRY.md` - Master registry +- `alice-researcher/SOUL.md` - Alice's personality +- `alice-researcher/AGENTS.md` - Alice's role +- `bob-implementer/SOUL.md` - Bob's personality +- `bob-implementer/AGENTS.md` - Bob's role +- `charlie-tester/SOUL.md` - Charlie's personality +- `charlie-tester/AGENTS.md` - Charlie's role +**Backed up:** ✅ Yes (Gitea) + +### 8. Cron Jobs & Automation +**Stored in:** OpenClaw cron scheduler (persistent) +**Active jobs:** +- Gantt Board Task Worker (24/7) - Job ID: `b9f3bbe6-bcb5-4483-8816-d044fd91c58a` +- Daily Digest (7am CST) - Job ID: `69fb35d3-f3be-4ed2-ade0-3ab77b4369a9` +**Backed up:** ✅ Stored in OpenClaw config (survives restarts) + +--- + +## 🔒 Protection Mechanisms + +### Git Repository +- **Local:** `~/.openclaw/workspace/.git/` +- **Remote:** http://192.168.1.128:3000/TopDogLabs/test-repo.git +- **Commits:** Every significant change +- **Pushes:** After every major update + +### Gitea Remote Backup +- **Server:** 192.168.1.128:3000 +- **Organization:** TopDogLabs +- **Repo:** test-repo.git +- **Access:** ai-agent / !7883Gitea +- **Contains:** Full git history, all files + +### File Locations (All Persistent) +All files stored in: +``` +/Users/mattbruce/.openclaw/workspace/ +├── SESSION_STARTUP.md +├── SOUL.md +├── USER.md +├── TOOLS.md +├── BRAIN.md +├── AGENTS.md +├── agents/ +│ ├── TEAM-REGISTRY.md +│ ├── alice-researcher/ +│ ├── bob-implementer/ +│ └── charlie-tester/ +├── memory/ +│ └── 2026-02-24.md +└── .git/ (repository) +``` + +--- + +## ⚠️ What Could Break (And Fixes) + +### Scenario 1: Workspace Folder Deleted +**Problem:** Someone deletes `~/.openclaw/workspace/` +**Fix:** +```bash +cd /Users/mattbruce/.openclaw +git clone http://192.168.1.128:3000/TopDogLabs/test-repo.git workspace +cd workspace +# All files restored +``` + +### Scenario 2: OpenClaw Reinstalled +**Problem:** OpenClaw app deleted and reinstalled +**Fix:** Files are on disk, not in app. Just restart OpenClaw. + +### Scenario 3: Gitea Server Down +**Problem:** 192.168.1.128 unavailable +**Impact:** Can't push new changes, but local files still work +**Fix:** Local files remain functional; restore Gitea when possible + +### Scenario 4: File Corruption +**Problem:** Files become unreadable +**Fix:** +```bash +cd /Users/mattbruce/.openclaw/workspace +git checkout HEAD -- filename.md +# File restored from last commit +``` + +--- + +## ✅ Verification + +**To verify everything is working after reboot:** + +1. Check files exist: + ```bash + ls /Users/mattbruce/.openclaw/workspace/TOOLS.md + ls /Users/mattbruce/.openclaw/workspace/agents/TEAM-REGISTRY.md + ``` + +2. Check git status: + ```bash + cd /Users/mattbruce/.openclaw/workspace + git log --oneline -3 + ``` + +3. Check cron jobs: + ```bash + openclaw cron list + ``` + +4. Ask me: "Verify your memory" - I should know about: + - Alice, Bob, Charlie subagents + - 24/7 task worker + - Gantt Board CLI access + - Recent tasks created + +--- + +## 📋 Backup Checklist (After Major Changes) + +- [ ] New subagent created +- [ ] TOOLS.md updated +- [ ] New cron job added +- [ ] Significant memory updates +- [ ] New project scaffolding +- [ ] AGENTS.md or SOUL.md changed + +**Command:** +```bash +cd /Users/mattbruce/.openclaw/workspace +git add -A +git commit -m "Description" +git push origin master +``` + +--- + +## 🎯 The Guarantee + +**YES - Everything persists across reboots because:** + +1. ✅ Files are on **disk** (not in memory) +2. ✅ Boot sequence is **deterministic** (same files, same order) +3. ✅ Everything is **git tracked** (full history) +4. ✅ **Remote backup** exists (Gitea) +5. ✅ **Cron jobs** stored in OpenClaw config (survives restarts) +6. ✅ **Mandatory push rule** added to TOOLS.md + +**Unless:** The entire hard drive fails (then restore from Gitea on new machine) + +--- + +Last updated: 2026-02-24