Add Session Continuity Guarantee documentation
This commit is contained in:
parent
1e9e4d9a43
commit
1acecad5f2
201
docs/SESSION-CONTINUITY-GUARANTEE.md
Normal file
201
docs/SESSION-CONTINUITY-GUARANTEE.md
Normal file
@ -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
|
||||
Loading…
Reference in New Issue
Block a user