Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Integrity and repair

verify

memo-mcp verify
memo-mcp verify --repair
CheckProblem reported--repair does
Every live document has passagesN live document(s) have no chunksReports only; re-ingest the source
Vectors point at existing passagesN vector(s) point at missing chunksReports only
Facts point at existing evidenceN fact(s) point at missing evidence chunksReports only
Every live passage has a vector for the current modelN live chunk(s) have no vector for model XQueues an embed job; run memo-mcp backfill
FTS5 index integrity<index> failed integrity-checkRebuilds the index

The command prints ok: no problems found, or one problem: line per finding and one repaired: line per fix.

backfill and reindex

CommandEmbedsWhen
memo-mcp backfillPassages queued for vectors, from --embed=false, a degraded write or verify --repairAfter bulk loads, or after the model was unavailable
memo-mcp reindex [--model id]Every live passage lacking a vector for the modelAfter switching models

Both are resumable and safe to interrupt. The server runs both in the background at start.

SQLite-level checks

sqlite3 ~/.memo-mcp/kb/my-project.db 'PRAGMA integrity_check'   # expect: ok
sqlite3 ~/.memo-mcp/kb/my-project.db 'PRAGMA user_version'      # schema version

When to run what

After…Run
A crash or power lossverify, then PRAGMA integrity_check
Restoring a backupverify
Bulk ingest with --embed=falsebackfill
Changing MEMO_MODELreindex --model <id>
Upgrading across 1.0 to 1.1graph rebuild
Large redactionsVACUUM with no process attached