Skip to content

Feature: Cora + Uteke cross-product integration bundle #235

Closed

Description

@ajianaz

Feature: Cross-Product Integration — Cora + Uteke Bundle

Problem

Cora and Uteke are separate tools with no integration. The most compelling value prop — "code review that remembers and learns" — requires both to work together.

Dependency Graph

UTEKE (foundation)          CORA (consumer)
├── v0.0.11 (stability)     ├── v0.4.x (standalone, today)
├── v0.0.12 (FTS5+metadata) ├── v0.5 (quality profiles, MCP, security scanner)
├── v0.1.0 (MCP, graph)     └── v0.5 (Uteke integration ← needs stable Uteke)
└── published to crates.io       └── v0.6 (cross-product bundle ← THIS ISSUE)

Key constraint: Cora does NOT depend on Uteke. Integration is feature-gated and graceful.

Integration Design

3 Levels of integration (from #232):

Level Uteke Required? Value
None (default) ❌ Standalone AI review, like eslint
Context (--memory) ✅ Smarter reviews with project history
Learning (--memory --learn) ✅ Reviews improve over time

Implementation: src/engine/memory.rs via subprocess calls to uteke CLI. No Rust library dep.

Cross-Selling Funnel

Free: Cora CLI (standalone AI code review)
  → User discovers Uteke through Cora docs/README
Free: Uteke CLI (standalone semantic memory)
  → User discovers Cora through Uteke docs/README

Combined (both installed):
  cora review --memory --learn
  → "Your code review gets smarter every sprint"

Positioning:
  "Cora = AI reviewer with optional memory (Uteke)"
  "Uteke = AI memory with optional code-awareness (Cora)"

Priority

This is v0.6 — requires both products mature:

  • Uteke: v0.0.12 complete + published to crates.io
  • Cora: v0.5 features complete (quality profiles, MCP, security scanner)
  • Both have documentation and onboarding experience

Bundle Features

  • Single install script for both
  • Shared config (~/.config/cora-uteke/ or similar)
  • Dashboard showing review history + memory stats
  • cora-uteke init — setup both with optimal defaults

Acceptance Criteria

  • cora review works without Uteke installed (zero regression)
  • cora review --memory --learn works when Uteke installed
  • Documentation covers both standalone and combined usage
  • Install script sets up both tools
  • Cross-referencing README mentions in both repos

Activity

  1. reopened this on Jun 9, 2026
  2. ajianaz commented on Jun 10, 2026

    @ajianaz
    CollaboratorAuthor

    Uteke v0.0.13 Released — Ready for Integration

    Uteke Foundation is now stable enough for Cora integration:

    What's Ready

    • FTS5 Hybrid Search + RRF — vector + full-text search merged via Reciprocal Rank Fusion, gives better recall accuracy for both semantic and keyword queries
    • Metadata Enrichment — --entity, --category, --meta key:value,... on every memory. Cora can store review findings with structured metadata (e.g. --entity cora --category finding --meta "severity:critical,file:src/main.rs")
    • Concurrent Reads — RwLock<VectorIndex> handles multiple parallel recall requests without blocking
    • Server Mode — uteke-serve with ~42ms warm recall. Cora can call via HTTP API instead of subprocess for lower latency
    • Stable Schema v2 — auto-migration, zero data loss
    • HTTP API — /remember, /recall, /search endpoints with CORS enabled
    • GitHub Secrets — no more Infisical dependency, clean CI integration

    Integration Surface

    cora review --memory
      → uteke recall "project patterns" --namespace cora --json
      → enrich system prompt with project context
    
    cora review --memory --learn
      → uteke remember "Found missing error handling in auth flow" \
          --namespace cora --entity cora --category finding \
          --meta "severity:major,file:src/auth.rs,rule:error-handling"
      → future reviews recall this pattern and prioritize similar code paths
    

    API for Integration

    Endpoint Method Body Use Case
    /recall POST {query, limit, namespace} Load project context before review
    /remember POST {content, tags, entity, category, meta, namespace} Save findings after review
    /search POST {query, namespace} Keyword search for specific patterns
    /stats GET — Check if uteke is available

    All endpoints return JSON. Server mode recommended for CI (subprocess also works).

    Blockers: None

    The dependency graph from the issue description showed:

    UTEKE v0.0.12 (FTS5+metadata) ✅ Done + v0.0.13 released
    CORA v0.5 (Uteke integration) ← ready to start
    

    Repo: https://github.com/codecoradev/uteke
    Release: https://github.com/codecoradev/uteke/releases/tag/v0.0.13

  3. ajianaz commented on Jun 14, 2026

    @ajianaz
    CollaboratorAuthor

    Shipped in PR #294.

    All acceptance criteria met:
    ✅ cora review works without Uteke (zero regression)
    ✅ cora review --memory --learn works when Uteke installed
    ✅ Documentation covers both standalone and combined usage
    ✅ Install script (install-bundle.sh) sets up both tools
    ✅ Cross-referencing README mentions

    Bundle installer: curl -fsSL https://raw.githubusercontent.com/codecoradev/cora-cli/main/install-bundle.sh | sh

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions