test-repo/docs/SESSION-CONTINUITY-GUARANTEE.md

# 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