ModelForge/docs/architecture/ADVISOR_PIPELINE_EVIDENCE.md

Advisor Pipeline Evidence

Advisor candidates are explicitly typed as embedding_deployment or retrieval_pipeline. Embedding candidates reference completed evaluation runs; pipeline candidates reference immutable pipeline identities whose latest completed fixed-pool runs provide control/candidate metrics.

Hard gates remain deterministic: incomplete/non-comparable evidence, critical regression, security or license block, runtime/GPU-fit failure, unsupported migration and latency policy override aggregate gains. Unknown evidence stays unknown.

Pipeline recommendations may return KEEP_CURRENT_EMBEDDING_ADD_RERANKER_CANDIDATE, but M8's two real reranking runs returned KEEP_CURRENT. The evaluated E5 embedding also returned KEEP_CURRENT: its aggregate retrieval metrics improved, but three critical regressions, unapproved license state, a required reindex and the p95 latency policy block promotion. Recommendations never promote or cut over automatically.