Skip to content

v0.12.0 β€” Junction Tools, Full-Text Content Search & Stability Fixes

Choose a tag to compare

@ajianaz ajianaz released this 05 Aug 06:55
· 161 commits to develop since this release

🧠 Your AI's memory just got sharper

v0.12.0 ships 5 bug fixes, 4 new tools, a Windows installer, and a search upgrade that makes document content actually searchable.


πŸ” Search inside documents (not just titles)

Before v0.12.0, uteke search could find documents by title and slug β€” but not by what's inside them. If you wrote a 2,000-word architecture spec and searched for a phrase buried in paragraph 14, you'd get nothing.

Now FTS5 indexes the full content body. Every word in every document is searchable. Migration is automatic β€” existing databases are detected and upgraded on first run, no manual steps.

# This now works (previously: no results)
uteke doc search "rate limiting strategy"

πŸ”— Room ↔ Document links (finally in CLI & MCP)

The HTTP API had endpoints for linking documents to rooms since v0.11, but MCP and CLI users were left out. Not anymore.

Four new tools β€” available everywhere:

What MCP tool CLI command
Link a doc to a room uteke_room_add_document uteke room add-document
Unlink a doc uteke_room_remove_document uteke room remove-document
List docs in a room uteke_room_list_documents uteke room list-documents
List rooms for a doc uteke_doc_list_rooms uteke room list-rooms

Build a room for "sprint-planning", link your architecture spec and API design docs, then recall across all of them with one query.


πŸͺŸ Windows PowerShell installer

Native Windows installation is now one command:

irm https://raw.githubusercontent.com/codecoradev/uteke/main/install.ps1 | iex

Contributed by @KazamiHazaki in #779.


πŸ› Stability fixes

Five bugs squashed β€” each one could silently corrupt data or make config changes invisible:

  • Config merge ate 5 of 12 sections β€” [embed_fallback], [extraction], [recall] weights, and more were silently ignored when loading from uteke.toml. Your config file said one thing, uteke did another.
  • Orphaned vector index entries β€” doc_upsert double-deleted chunks, leaving ghost entries in the usearch index. Over time this caused index bloat and stale search results.
  • Dangling roomβ†’document links β€” Deleting a document left orphaned junction rows. Rooms would reference docs that no longer existed.
  • Incomplete config template β€” uteke init generated a config with only 5 of 12 sections. New users had no reference for embedding fallback, extraction rules, or recall weights.
  • Confusing tool name β€” uteke_room_document sounded like a CRUD operation. Renamed to uteke_room_summary_document (old name still works as alias β€” zero breakage).

πŸ“¦ Downloads

Each archive contains three binaries + ONNX Runtime shared library:

Binary Description
uteke CLI tool
uteke-serve HTTP server daemon
uteke-mcp MCP server (stdio + HTTP)
libonnxruntime.so* / libonnxruntime*.dylib / onnxruntime*.dll ONNX Runtime
Platform File
Linux x86_64 (AVX2) uteke-x86_64-unknown-linux-gnu-v0.12.0.tar.gz
Linux x86_64 (Legacy, SSE4.2) uteke-x86_64-unknown-linux-gnu-legacy-v0.12.0.tar.gz
Linux ARM64 uteke-aarch64-unknown-linux-gnu-v0.12.0.tar.gz
macOS Apple Silicon uteke-aarch64-apple-darwin-v0.12.0.tar.gz
Windows x86_64 uteke-x86_64-pc-windows-msvc-v0.12.0.zip

Legacy Bundle (Linux only) β€” Includes a SSE4.2-only ORT sidecar (ort-legacy/) for CPUs without AVX2 (Intel Celeron J4125/N4020). Use this bundle to avoid SIGILL crashes on older hardware.


πŸ“Š By the numbers

Metric Value
Tests 432 passing (up from 431)
MCP tools 35 (up from 31)
HTTP endpoints 61
CLI commands 75 (38 + 37 subcommands)
Binary size ~12 MB (no change)

⬆️ Upgrade

# Existing install β€” re-run installer
curl -fsSL https://raw.githubusercontent.com/codecoradev/uteke/main/install.sh | sh

# Or if building from source
git pull && cargo build --release --workspace

No manual migration needed. Schema upgrades run automatically on first launch.


πŸ‘₯ Contributors

Contributor PRs
@ajianaz #846 #847 #848 #854 #855 #863 #864 #865 #866 #867 #868 #869 #871 #872
@KazamiHazaki #779 (Windows PowerShell installer)
@dependabot #850 #851 #852 #853

πŸ”— Issues & PRs in this release

Issues closed: #843 #844 #845 #856 #857 #858 #859 #860 #861 #862

Merged PRs: #779 #846 #847 #848 #850 #851 #852 #853 #854 #855 #863 #864 #865 #866 #867 #868 #869 #871 #872 #874


Full changelog: https://github.com/codecoradev/uteke/blob/main/CHANGELOG.md