# v0.41.0 — Embedding Pipeline Infrastructure & ANN Maintenance

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

**Status: Planned** | **Scope: Medium**

> After the v0.38.0-v0.40.0 hardening arc, the roadmap resumes the deferred
> embedding programme with post-refresh actions, drift-based ANN maintenance,
> vector-aware monitoring, AI/RAG cookbooks, and a bundled `pg_trickle` +
> `pgvector` + `pgai` developer image.

---

## What is this?

v0.37.0 introduced pgVectorMV. v0.38.0-v0.40.0 then deliberately prioritized
correctness, operational truthfulness, diagnostics, and platform trust before
new AI surface area. v0.41.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.41.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 + pgai integration

This release also adds the documentation and packaging needed for a serious
self-hosted RAG workflow: a full cookbook for always-fresh embedding pipelines
and a Docker image variant that bundles `pg_trickle`, `pgvector`, and `pgai`
for fast experimentation and demos.

---

## Also in v0.41.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.41.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.40.0 must complete their correctness,
> diagnostics, and operator-trust exit criteria before this embedding work
> starts.

---

*Previous: [v0.40.0 — Operator Trust, Maintainability & Release Confidence](v0.40.0.md)*
*Next: [v0.42.0 — Hybrid Search & Sparse Vector Aggregates](v0.42.0.md)*
