Phase 4: Uteke Integration Upgrade

[ajianaz]

Phase 4: Uteke Integration Upgrade

Scope

• Uteke HTTP client for cross-project recall (http://uteke:8767)
• cora brain --learn — push review patterns/findings to uteke room
• Cross-project recall enrichment in cora brain (optional, graceful degradation)
• graph.db.zst export/import for team sharing
• MCP tool upgrade: brain_search with uteke enrichment

Architecture

cora brain <query>
  ├─ Local search (usearch + FTS5 + graph) ← Phase 3
  └─ [optional] uteke HTTP /search → cross-project patterns
  → Merge results, present with provenance

cora review --learn
  └─ Extract findings → POST /api/rooms/cora-code/memories (namespace: cto)

Integration Method

• HTTP API only — usearch vectors live in .usearch file (not SQLite), so ATTACH cannot access them
• Graceful degradation: if uteke unreachable, skip enrichment silently

Implementation Checklist

• Create src/uteke/client.rs — UtekeClient (search, remember, is_available)
• Wire cora brain with optional uteke enrichment
• Implement cora brain --learn pattern extraction + uteke push
• cora export --zstd — compress graph.db + .usearch → .db.zst
• cora import --zstd — decompress .db.zst → restore
• Upgrade MCP tool brain_search with uteke results
• Tests: uteke client (mock), cross-project recall, export/import
• Manual test: review --learn, cross-project recall

Effort

~590 lines

Depends On

• Phase 3 (brain search, usearch index) — this issue

Depends on: #359 (Phase 3)