echo-core/MIGRATION-PLAYBOOK.md

# OpenClaw → Echo-Core Migration Playbook

> **Status: EXECUTED 2026-04-21 10:04 UTC.** See "Post-migration state" below.
> This playbook is kept as a living reference for rollback + cleanup.

Run this after the PR `feat/openclaw-consolidation-2026-04` has merged to master.
Estimated downtime: 5–10 minutes. Rollback path at the bottom.

---

## Post-migration state (reference for rollback)

**Migration date:** 2026-04-21 10:04 UTC
**Downtime window:** ~2 minutes (10:02–10:04 UTC)

### Git SHAs
- **Pre-migration master tip:** `4e78ef7` ("claude gstack") — rollback target if everything goes wrong.
- **Post-merge master tip:** `d741541` ("test(dashboard): cover constants, git helper, cron endpoint, files sandbox") — last commit of the migration PR.
- **Current origin/master:** moved forward as Marius tested dashboard commit button post-cutover.

### Backups
- **`/home/moltbot/clawd-backup-2026-04-21/`** — full copy of `clawd/dashboard` (807K) + `clawd/memory` (11M) taken during pre-flight step 3. Keep until 2026-05-21.

### Services at cutover
- `echo-core.service` — active (running), uses echo-core/.venv + echo-core paths
- `echo-taskboard.service` — active (running), new unit at `~/.config/systemd/user/echo-taskboard.service`, WorkingDirectory=`/home/moltbot/echo-core/dashboard`, ExecStart=`.venv/bin/python3 api.py`
- `echo-whatsapp-bridge.service` — active (running), unchanged
- `openclaw-gateway.service` — **inactive + disabled**, credentials stripped

### Credentials stripped from `~/.openclaw/`
- `credentials/` dir (Discord + Telegram + WhatsApp pairing) — deleted
- `identity/` dir (device auth) — deleted
- `devices/` dir (paired devices) — deleted
- `agents/*/agent/auth-profiles.json` (20 files) — deleted
- `agents/*/sessions/sessions.json` (20 files) — deleted
- **Preserved:** `cron/jobs.json` (+bak) as audit artifact; `openclaw.json` (main config, no known secrets); npm `lib/` (harmless).

### What's enabled after migration
- **Shell jobs (5):** `anaf-monitor`, `security-audit-daily`, `kb-index-refresh`, `archive-tasks-daily`, `backup-config` — all enabled
- **Claude jobs enabled (2):** `newsletter-test`, `heartbeat-2h`
- **Claude jobs disabled (13):** morning-report, evening-report, morning-coaching, evening-coaching, weekly-planning-sun, content-discovery, provocare-reminder, exercise-snack-1/2/3, grup-sprijin-5feb, grup-sprijin-pregatire — ready to enable after Marius reviews each

### Crontab
- `0 2 * * * /home/moltbot/echo-core/tools/backup_config.sh` (was clawd)
- `10 14 * * 4,5,1 ... check_newsletter_cercetasi.py` (unchanged)
- `0 9 21 5 * ...` — **May 21 2026 cleanup reminder** (writes to `$HOME/REMINDER-openclaw-cleanup.txt` and appends to `logs/migration-reminder.log`)

### Verification PASS
- ANAF `status.json.anaf.lastCheck` moved from **03 Apr 2026, 22:07** → **21 Apr 2026, 10:04** with 3 real changes detected on first manual trigger.
- `GSTACK-CRON: changes=3` marker emitted correctly; scheduler↔anaf contract verified.
- `/api/cron` returns 7 jobs (enabled shell + claude).
- `/api/agents` and `/api/activity` return 404 (removed as planned).
- Dashboard /api/status OK.

---

---

## Pre-flight (read-only)

1. Confirm clean git state on echo-core master:
   ```
   cd /home/moltbot/echo-core && git status
   ```

2. Verify tests pass:
   ```
   cd /home/moltbot/echo-core
   source .venv/bin/activate && pytest tests/ -x
   ```

3. Backup:
   ```
   cp -rp /home/moltbot/clawd/dashboard /home/moltbot/clawd-backup-$(date +%Y-%m-%d)/
   cp -rp /home/moltbot/clawd/memory   /home/moltbot/clawd-backup-$(date +%Y-%m-%d)/memory
   ```

## Legacy consumer grep (decide on compat symlink)

4. Check whether anything still reads clawd/memory:
   ```
   grep -rn 'clawd/memory' /home/moltbot/{bin,.config,.openclaw} 2>/dev/null
   grep -rn 'clawd/memory' /home/moltbot/echo-core 2>/dev/null
   ```
   - If empty → skip **step 11** (no compat symlink needed).
   - If non-empty → keep **step 11**.

## Stop services

5. ```
   systemctl --user stop echo-core echo-taskboard echo-whatsapp-bridge openclaw-gateway
   ```

## Copy ANAF live state

6. ```
   cp -rp /home/moltbot/clawd/tools/anaf-monitor/{hashes.json,versions.json,monitor.log} \
          /home/moltbot/echo-core/tools/anaf-monitor/ 2>/dev/null
   cp -rp /home/moltbot/clawd/tools/anaf-monitor/snapshots \
          /home/moltbot/echo-core/tools/anaf-monitor/
   diff -r /home/moltbot/clawd/tools/anaf-monitor/snapshots \
           /home/moltbot/echo-core/tools/anaf-monitor/snapshots
   ```
   Diff should be empty (or only show new snapshots echo-core captured during testing).

## Dashboard migration

7. Delete echo-core dashboard placeholder content if any collisions, then:
   ```
   cp -rp /home/moltbot/clawd/dashboard/{habits,issues,status,todos}.json \
          /home/moltbot/echo-core/dashboard/
   cp -rp /home/moltbot/clawd/dashboard/tests/ \
          /home/moltbot/echo-core/dashboard/tests/
   # Recreate the 4 dashboard symlinks pointing into echo-core:
   ln -sfn /home/moltbot/echo-core/memory           /home/moltbot/echo-core/dashboard/memory
   ln -sfn /home/moltbot/echo-core/conversations    /home/moltbot/echo-core/dashboard/conversations   # create conversations/ first if you want this
   ln -sfn /home/moltbot/echo-core/memory/kb        /home/moltbot/echo-core/dashboard/notes-data
   ln -sfn /home/moltbot/echo-core/memory/kb/youtube /home/moltbot/echo-core/dashboard/youtube-notes
   ```

## Memory inversion

8. `rm /home/moltbot/echo-core/memory`  *(removes symlink only, not target)*
9. `cp -rp /home/moltbot/clawd/memory /home/moltbot/echo-core/memory`
10. `diff -rq /home/moltbot/clawd/memory /home/moltbot/echo-core/memory` *(verify identical)*
11. *(only if step 4 found consumers)*
    ```
    mv /home/moltbot/clawd/memory /home/moltbot/clawd/memory.old-2026-04
    ln -s /home/moltbot/echo-core/memory /home/moltbot/clawd/memory
    ```
12. `rm -rf /home/moltbot/echo-core/memory.bak` *(leftover, safe to delete)*

## Systemd

13. Copy the template into place:
    ```
    cp /home/moltbot/echo-core/dashboard/echo-taskboard.service \
       /home/moltbot/.config/systemd/user/echo-taskboard.service
    systemctl --user daemon-reload
    ```

## Crontab

14. ```
    bash /home/moltbot/echo-core/scripts/update_crontab.sh
    ```

## Decommission OpenClaw

15. `systemctl --user stop openclaw-gateway`
16. `systemctl --user disable openclaw-gateway`
17. Strip credentials from `~/.openclaw/` but keep `jobs.json.bak`:
    ```
    cd /home/moltbot/.openclaw
    find . -name 'auth*' -o -name '*token*' -o -name '*.secret' | xargs rm -v 2>/dev/null
    ls -la agents/*/   # inspect for any remaining secrets, delete manually
    ```
18. **Note:** schedule a reminder for 2026-05-21 to `rm -rf /home/moltbot/.openclaw`
    entirely if nothing was restored.

## Restart

19. `systemctl --user start echo-core echo-taskboard echo-whatsapp-bridge`
20. `systemctl --user status echo-core echo-taskboard echo-whatsapp-bridge` — all **active (running)**.
21. `systemctl --user status openclaw-gateway` — **inactive (dead)**.

## Verification

22. `curl -s http://localhost:8088/api/status` → `{"status":"ok",...}`
23. Visit `https://moltbot.tailf7372d.ts.net/echo/` — home page loads.
24. `/api/cron` panel populated with echo-core jobs (anaf-monitor, morning-report, etc).
25. `/api/agents` returns 404 (removed).
26. Click **Commit** in `index.html` — creates commit on echo-core repo.
27. Manually trigger anaf monitor:
    ```
    cd /home/moltbot/echo-core && .venv/bin/python3 tools/anaf-monitor/monitor_v2.py
    ```
    Verify `status.json` updates **and** stdout ends with
    `GSTACK-CRON: changes=N`.
28. Wait for first scheduled anaf-monitor trigger (10:00 or 16:00 Mon-Fri).
    Check `echo-core.log` for execution.

---

## Rollback path (if anything breaks badly)

**Concrete values for this migration (executed 2026-04-21):**

```
# Stop current services
systemctl --user stop echo-core echo-taskboard echo-whatsapp-bridge

# Restore memory directory
rm -rf /home/moltbot/echo-core/memory
cp -rp /home/moltbot/clawd-backup-2026-04-21/memory /home/moltbot/clawd/memory
ln -s /home/moltbot/clawd/memory /home/moltbot/echo-core/memory

# Restore dashboard source (symlinks will come back with it)
cp -rp /home/moltbot/clawd-backup-2026-04-21/dashboard /home/moltbot/clawd/dashboard

# Restore old systemd unit (paths back to clawd/dashboard + /usr/bin/python3)
cat > ~/.config/systemd/user/echo-taskboard.service <<'EOF'
[Unit]
Description=Echo Task Board API
After=network.target

[Service]
Type=simple
WorkingDirectory=/home/moltbot/clawd/dashboard
ExecStart=/usr/bin/python3 /home/moltbot/clawd/dashboard/api.py
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
EOF

# Revert git to pre-migration state
git -C /home/moltbot/echo-core reset --hard 4e78ef7

# Restore crontab backup_config line (sed in reverse)
crontab -l | sed -E 's#/home/moltbot/echo-core/tools/backup_config\.sh#/home/moltbot/clawd/tools/backup_config.sh#g' | crontab -

# Re-enable openclaw (credentials are GONE — you'll need to re-pair Discord/Telegram/WhatsApp)
systemctl --user enable openclaw-gateway
systemctl --user daemon-reload

# Restart everything
systemctl --user start echo-core echo-taskboard echo-whatsapp-bridge openclaw-gateway
```

**Note:** After rollback, OpenClaw credentials are gone (stripped during migration). Re-pairing requires going through OpenClaw's pairing flows for Discord/Telegram/WhatsApp. If you want clean rollback without losing pairing, do the rollback within the 30-day window **before** running the May 21 cleanup reminder.

---

## Notes

- **Cron schedules are Bucharest local time**, not UTC.
- **Most imported claude jobs arrive DISABLED** — enable them via `eco` / dashboard
  once you've verified each one produces the expected output.
- `heartbeat-2h` is the **only imported claude job that stays enabled** (preserving
  its state from OpenClaw).
- The 5 shell jobs (anaf-monitor, security-audit-daily, kb-index-refresh,
  archive-tasks-daily, backup-config) start **enabled** on day one.