release: prepare v0.3.2

[voorhs]

Summary

Prepares the v0.3.2 maintenance release (bug fixes + chores, no breaking changes). Bumps the version in pyproject.toml and docs/source/conf.py, and adds a themed CHANGELOG.md entry for the 9 commits landed since v0.3.1.

Bug fixes in this release

• Structured-output cache now keys by model identity (model_name + base_url) — no cross-model cache hits (fix(cache): include model identity in structured-output cache key (#334) #336)
• Structured-output cache eager-load/eviction fixed to treat entries as directories; eviction uses rmtree (fix(cache): handle directory cache entries (#326, #327) + tests (Tier D) #331)
• Offline embedding cache key reads the SHA from the local HF ref file and now includes the model name (fix(embedder): stabilize offline embedding cache key, prevent cross-model collision (#321) #337)
• basic-aug / evolution-aug console scripts repointed to the correct _basic / _evolution module paths (test: cover augmentation CLIs + fix broken console-script entry points (Tier B) #330)

Tooling / CI / tests

• 85% combined-coverage regression floor (ci: gate combined coverage against an 85% regression floor (Tier E) #333)
• Manual coverage dispatch + coverage config fix (ci: add manual coverage dispatch and fix broken coverage config #325)
• Windows test jobs fixed (ci: fix Windows test jobs broken by bash-only shell step #328)
• Added tests: Generator dump/load + async empty-response guard (test: cover Generator dump/load + async empty-response guard (Tier C) #332), augmentation CLIs (test: cover augmentation CLIs + fix broken console-script entry points (Tier B) #330), JSONFormatter + macro retrieval metrics (test: cover JSONFormatter and macro retrieval metrics (Tier A) #329)

Notes

• docs/_static/versions.json has unrelated uncommitted local edits (promoting v0.3.0 to stable in the docs dropdown) and is intentionally not part of this PR — matching how v0.3.1 was released.

Test plan

• CI green on this branch
• Confirm CHANGELOG.md 0.3.2 entry reads correctly
• Tag v0.3.2 after merge

🤖 Generated with Claude Code