# v0.47.0 — Embedding Pipeline Infrastructure & ANN Maintenance

> **Full technical details:** [v0.47.0.md-full.md](v0.47.0.md-full.md)

**Status: Released** | **Scope: Medium**

> After the v0.38.0-v0.45.0 hardening arc, the roadmap resumes the deferred
> embedding programme with post-refresh actions, drift-based ANN maintenance,
> vector-aware monitoring, and AI/RAG cookbooks.

---

## What is this?

v0.37.0 introduced pgVectorMV. v0.38.0-v0.45.0 then deliberately prioritized
correctness, operational truthfulness, diagnostics, and platform trust before
new AI surface area. v0.47.0 picks the embedding roadmap back up once those
foundations are in place.

---

## Embedding pipeline operational hardening

When a vector stream table refreshes, it often needs follow-up housekeeping:
statistics refresh, ANN maintenance, or drift-aware reindexing. v0.47.0 adds
explicit post-refresh actions, per-table drift thresholds, and a
`pgtrickle.vector_status()` view so operators can see embedding lag, index age,
and reindex pressure instead of inferring those signals indirectly.

---

## pgvector integration & RAG cookbook

This release adds the documentation needed for a serious self-hosted RAG
workflow: a full cookbook for always-fresh embedding pipelines using
`pg_trickle` + `pgvector`, with embeddings generated at the application layer.

---

## Also in v0.47.0

- Citus vector-aggregate cases integrated into the v0.39 distributed test rig
- Vector-specific options and monitoring integrated into the generated reference
  docs added during the hardening arc

---

## Scope

v0.47.0 is a medium release. The work is primarily scheduler options,
monitoring, cookbook material, and packaging, rather than DVM-core changes.
That is exactly why it belongs after the hardening arc, not before it.

> **Hard prerequisite:** v0.38.0-v0.45.0 must complete their correctness,
> diagnostics, and operator-trust exit criteria before this embedding work
> starts.

---

*Previous: [v0.45.0 — Operational Readiness, Scalability & CI Completeness](v0.45.0.md)*
*Next: [v0.47.0 — Hybrid Search & Sparse Vector Aggregates](v0.47.0.md)*
