Roadmap: Uteke v0.9.0 — API Stability and Quality

[ajianaz]

Uteke v0.9.0 Roadmap

Release Timeline

Target: 2026-08 (2-4 weeks after v0.8.0)

Theme: API Stability and Quality

v0.8.0 introduced significant new features but exposed several API inconsistencies. v0.9.0 focuses on hardening the API surface, adding versioning, and fixing quality issues discovered during v0.8.0 testing.

Issues

#	Priority	Status	Description
#737	Critical	Open	API URL prefix versioning (/api/v1/, /api/v2/)
#733	High	Open	fix: PUT /room/document/add empty error body
#735	Medium	Open	refactor: rename POST /room/document to POST /room/summary
#734	Medium	Open	feat: expose trust_score in GET /memory and recall
#731	Medium	Open	configurable dream/dedup thresholds and safer defaults

Planned Features

Feature	Description	Priority
Request mutex to RwLock	Replace Mutex with RwLock for concurrent read access	Medium
Unversioned route deprecation	Log warnings when hitting unversioned routes	Medium
GET /memory doc-refs	Return linked documents in memory GET response	Low

NOT in Scope

• Feature: ship no-AVX2 Windows binary (SIGILL on CPUs without AVX2, e.g. Celeron N4020) #709 Windows no-AVX2 binary (separate release track)
• [BUG] Windows: os error 33 (LOCK_VIOLATION) reading usearch index breaks multi-process CLI / documented multi-agent workflow #732 Windows LOCK_VIOLATION (platform-specific)

Dependency Graph

#737 (API versioning)
  |-- #735 (rename room/document) — BEFORE versioning for clean v2 routes
  |-- #733 (room/document/add error) — independent but nice together
  +-- #734 (trust_score) — independent

#731 (configurable thresholds) — fully independent

Consumers to Migrate

Consumer	Current	Action
Hermes uteke-tool plugin	Flat recall parse	Migrate to /api/v2/
Hermes shell hooks	Flat recall parse	Migrate to /api/v2/
CorIn desktop	Direct API calls	Migrate to /api/v2/
MCP server	27 tools	Migrate to /api/v2/
Pi memory-provider	Direct API calls	Migrate to /api/v2/

[ajianaz]

Progress Update — 2026-07-18

Issue	Status	Notes
#735	✅ Done (PR #739)	Renamed to POST /room/summary-document (avoid collision with existing /room/summary clustering endpoint). Merged to develop.
#733	🔲 Pending	Bug fix — empty error body on room document add
#734	🔲 Pending	Enhancement — expose trust_score
#737	🔲 Pending	API versioning (/api/v1, /api/v2)
#731	🔲 Pending	Configurable dream thresholds

Next: #737 (API versioning) should land before #733/#734 so fixes go under versioned routes.

[ajianaz]

Final Update — 2026-07-18 (all v0.8.1 items complete)

Issue	Status	PR	Notes
#735	✅ Done	#739	POST /room/summary-document (renamed from /document)
#737	✅ Done	#741	URL prefix versioning /api/v1, /api/v2
#733	✅ Closed	—	Already fixed in develop
#734	✅ Closed	—	importance IS the trust_score
#731	✅ Done	#742	Configurable dream thresholds + safer defaults

All v0.8.1 roadmap items complete. Ready for tag.