lesson-hermes-state-database-lock-issues-cleanu.json

{
  "task_id": "lesson-hermes-state-database-lock-issues-cleanu",
  "title": "Hermes State Database Lock Issues - Cleanup Protocol",
  "domain": "agent-network",
  "tags": [
    "node:ZKA",
    "project:Hermes-Agent",
    "severity:high"
  ],
  "problem": "state.db uses SQLite with WAL mode. When gateway holds state.db open and process crashes, WAL file grows >50MB without checkpoint - causes lock timeouts. Also stale .journal and .lock files from incomplete transactions.",
  "solution": "1. Restart gateway: systemctl restart hermes-gateway.service\n2. PRAGMA wal_checkpoint(TRUNCATE) after restart\n3. Cleanup: delete .corrupted.* backups, empty sessions.db, empty *.lock files",
  "source": "lessons/hermes-state-database-lock-issues-cleanup-protocol.md",
  "test_cmd": ""
}