v0.6.0

0.6.0 (2026-05-31)

Added

• bench: MIRACL-es harness with ranx metrics and Pyserini-2cr report (c21fd96)
• chunkers: add Chunker protocol and RecursiveCharacterChunker (49ad485)
• coverage: add PgVectorStore helper unit tests and Codecov upload (unit+integration flags) (ff514d5)
• demos: add quickstart demo and README quickstart (b79d3a6)
• docs: add mkdocs-material site with auto-generated API reference and GH Pages deploy (1546afd)
• embedders: add Embedder protocol and unit-norm MockEmbedder (c112565)
• embedders: add EmbeddingCache protocol, InMemoryCache, CachedEmbedder (71267c6)
• embedders: add VoyageEmbedder and CohereEmbedder (multilingual) (1cbbc85)
• errors: add CenoteError hierarchy and replace bare ValueError raises (ffdf25d)
• eval: RetrievalBenchmark + bundled datasets + baseline scaffold (M1.1 phase 4) (3269cf3)
• examples: add custom_embedder and pgvector_setup cookbook examples (73151dd)
• future-API stubs (Reranker, Tracer, eval metrics) (1718579)
• llm: LLMClient Protocol + AnthropicLLM with prompt caching (M1.2 phase 3+4) (5b1336a)
• logging: add structured logging across all cenote modules (589b58a)
• M1.1 phase 1 — get_all_chunks, SpanishTokenizer, MarkdownChunker (c1f4916)
• M1.1 phase 2 — BM25Retriever + Voyage/Cohere rerankers via shared _HTTPReranker (916ef42)
• M1.2 phase 1 — Tracer Protocol v2 + SqliteCache with WAL + set_many bulk API (761d98b)
• models: add Document, Chunk, EmbeddedChunk, RetrievalResult (9bb50df)
• observability: OTel + Langfuse adapters + Traced wrappers (M1.2 phase 2) (f17b4bc)
• phase 4 primitives — TracedVectorStore + IndexingPipeline (7679b89)
• project scaffolding (uv, ruff, mypy, pytest, pre-commit, CI matrix, Apache-2.0) (fe8951c)
• release: add PyPI release workflow with OIDC trusted publishing (e4a5086)
• retrievers: add Retriever protocol and VectorRetriever (00c4d8c)
• retrievers: HybridRetriever with Reciprocal Rank Fusion (M1.1 phase 3) (6bf94dc)
• stores: add PgVectorStore with transactions, migrations tracking, HNSW tuning, CI integration job (986c861)
• stores: add VectorStore protocol and InMemoryVectorStore (280cf10)
• types: add cenote.types aliases and adopt Vector in public signatures (969ea4b)

Fixed

• ci: adapt migrations test to read disk + drop pycenote from pip-audit (8b85f51)
• ci: isolated venv for release verify + auto-enable GH Pages in docs deploy (35a91cf)
• ci: unblock CI on main (lint import order, pip-audit hashed deps, pgvector PK) (4835281)
• ci: use uv export --no-emit-project to exclude pycenote from pip-audit (787303d)
• compose: pin project name to cenote (was deriving from dir) (b9f5b66)
• embedders: honor Retry-After header, raise default max_retries to 6 (e867653)
• phase 4 bug fixes — HNSW tx wrap, hybrid resilience, BM25 LRU+invalidate (fedf797)
• tokenizers: make SpanishTokenizer pickle-safe via getstate (c734dfa)
• verify: correct grep pattern in phase2.sh check 3 (pytest --quiet output) (4c91dcc)
• verify: remove hardcoded user PATH from phase verify scripts (154c960)

Changed

• phase 4 retry+rate-limit — stamina with jitter + aiolimiter wrapper (30fccf2)

Documentation

• add CONTRIBUTING.md with dev setup and release process (7ae078e)
• adrs: add foundational ADRs 0001-0008 (05e8558)
• adrs: document release-please PR-create prerequisite in 0005 (0c1dc7d)
• adrs: document v0.4.0 release lessons in 0005 (2b9e362)
• adrs: expand 0008 monorepo with bench/rerankers/llm packages (1514bc9)
• adrs: note Phase 1 corrections (OSV reusable wf, Sigstore auto via pypa-publish) (4cacf97)
• adrs: note Phase 3 mike deferral to Phase 5 in ADR-0004 (88815b8)
• adrs: phase 5 implementation notes in 0004 and 0005 (2d0c9d3)
• bench: add ADR-0009 + benchmarks.md scaffold + README row (c2c77d2)
• changelog: expand SqliteCache entry with WAL + set_many (63a4832)
• changelog: record M1.0 future-API stubs entries (9b2f774)
• milestone: mark M1.0 closed with acceptance criteria and deliverables note (9f11e58)
• phase 3 — Definition of Done + ADRs index pages in mkdocs nav (f8f80d3)
• plan: add diagrams and skip other docs (e4516b3)
• project context, milestone brief, implementation plan, claude code config (793100d)
• proofs: add phase 4 + 5 practical proof report (a09fa7e)
• proofs: add v0.4.0 ship report (71d482b)
• refresh README to v0.5.0 + add internal docs (b09f664)
• rewrite README with positioning, module status, extension guide, and roadmap (fc9a973)