docs/MIGRATION_1.2.md

Migration from 1.1

SQLite schema and snapshot v2 remain unchanged. Both checkpoints and the topic-map contract are unchanged. Existing data and supported APIs continue to work. No automatic reindex, vocabulary merge, memory deletion or new glossary is inserted.

New APIs: remember_bridge, recall_grounded, verify_grounded, query, verify_query, pack_grounded, pack_query, and RecallClient. prepare_recall_prompt(..., grounded=True) uses the explicit grounded read path.

The default pack_evidence now optimizes over complete proof choices. Applications must inspect optimization.optimal and handle search_exhausted in addition to budget_exceeded. The packed evidence schema stays v1; selected proofs can change because shared support is now considered globally. No numeric policy is edited.

Do not enable the new bridge write endpoint for unauthenticated callers. It is a normal memory-write privilege. Keep application namespaces separate to avoid silently importing one project's terminology into another.