docs/MIGRATION_1.5.2.md

Migration to RAGForge v1.5.2

v1.5.2 is a narrow hotfix over v1.5.1.

Fixed

Quick, Standard and Deep evaluation could fail while processing generated answers with:

NameError: name 'repair_missing_citations' is not defined

src/ragforge/pipeline.py called citation helpers moved into src/ragforge/citations.py, but the v1.5.1 package omitted the explicit module import. v1.5.2 restores:

from .citations import normalize_citation_syntax, repair_missing_citations

Compatibility

• No dependency changes.
• No corpus/index format changes.
• No retrieval-policy changes.
• No evaluation-scoring changes.
• The demo benchmark remains version 1.5.1, so saved reports are semantically compatible while the same server-side workspace exists.

Regression coverage

The test suite now checks the import wiring without optional dependencies and invokes the citation-repair pipeline helper when LangGraph is available.