cxpak 3.0.0 — Deterministic Code + Data Knowledge Graph

A major release. cxpak now models your data layer as a first-class part of the knowledge graph, consolidates the MCP surface into a handful of intent-driven tools, and makes startup non-blocking so editors and agents get an instant handshake. Every default path is deterministic, OpenSSL-free, and runs no LLM anywhere.

Highlights

🧠 MCP surface: 26 tools → 5 intent tools

The Model Context Protocol surface is now five intent-parameterized tools — cxpak_context, cxpak_graph, cxpak_data, cxpak_review, cxpak_insight — each dispatching on an op argument. A hard gate keeps the tool count ≤ 8. All 26 legacy tool names continue to resolve as aliases, so existing integrations keep working.

⚡ Non-blocking MCP startup (ADR-0185)

initialize now returns in milliseconds instead of blocking behind a full index build. Tool calls made during indexing get a graceful "indexing in progress" response rather than hanging the client. This fixes the startup stall that could time out MCP clients on larger repositories.

🗄️ Live database knowledge graph

Read-only introspection of a running Postgres or MySQL instance, reflected from the catalog and merged into the dependency graph alongside your code schema. Pure-Rust/rustls drivers only (no OpenSSL). The DSN is never logged, persisted, or echoed, and all queries are read-only.

🎯 Semantic relevance on by default (ADR-0187 / 0190)

Active Reciprocal Rank Fusion is now the default ranking mode, with competition ("1224") ranking so a uniform signal stays inert and can't leak weight as alphabetical path bias. Gated recall improved measurably over the previous default.

🔎 Opt-in embeddings (ADR-0186)

Query-time embedding is gated on an available embedding index — no silent cost, clean fallback to the deterministic signals.

Invariants (verified this release)

• No OpenSSL — every target builds a static, portable binary
• No LLM in any code path
• DSN never logged / persisted; DB access is read-only
• MCP ≤ 8 tools
• Within-platform byte-identical determinism on the default path (guarded by a cross-process golden)

⚠️ Breaking changes

• The MCP tool surface is consolidated to intent tools with an op discriminator. Legacy tool names still work via aliases, but the canonical shape has changed — update integrations to the new op-parameterized form when convenient.

Install

cargo install cxpak            # crates.io
brew install cxpak             # Homebrew (formula updated by this release)

Prebuilt binaries for Linux (x86_64 / aarch64), macOS (x86_64 / aarch64), and Windows (x86_64) are attached below.

Supported platform: macOS (Apple Silicon) is the primary supported target today; Linux/Windows binaries are provided and on the roadmap for first-class support.

What's Changed

• docker: add Dockerfile.standalone for self-hosted / air-gapped deployments by @everapp-org in #13
• v3.0.0: Deterministic Code + Data Knowledge Graph by @lyubomir-bozhinov in #14

Full Changelog: v2.3.0...v3.0.0