khive v0.2.2 — lattice-embed 0.2.4 bump

khive v0.2.2 — lattice-embed 0.2.4 bump

Patch release bundling the lattice-embed 0.2.4 dep bump so consumers of khive-runtime, khive-retrieval, and khive-hnsw resolve directly against the new lattice version.

Changes since v0.2.1

• Workspace dep: lattice-embed = "0.2.3" → "0.2.4" (lattice-inference also pulls to 0.2.4 transitively)
• Workspace version: 0.2.1 → 0.2.2 across 32 files (23 crate Cargo.toml, cli/deno.json, npm/package.json + 6 platform shims, umbrella optionalDependencies)
• Publish chain: khive-pack-comm, khive-pack-schedule, khive-pack-template added to scripts/publish.sh (these are required by khive-mcp but were missing in v0.2.1's first attempt)
• CI: removed dead check-proof-references.sh call from scripts/ci.sh

No API changes. Pure version + dep bump.

Crates published at v0.2.2 (20 total)

Foundation: khive-types, khive-score, khive-fold
Storage / query: khive-storage, khive-db, khive-query
Auth: khive-gate, khive-gate-rego
Runtime: khive-runtime, khive-request
Packs: khive-pack-kg, khive-pack-gtd, khive-pack-brain, khive-pack-memory, khive-pack-comm, khive-pack-schedule, khive-pack-template
VCS: khive-vcs
Binaries: khive-mcp, kkernel

---

Full changelog: v0.2.1...v0.2.2

khive v0.2.1 — ADR v1 alignment

khive v0.2.1 — ADR v1 alignment

This release lands the ADR v1 alignment — 24 ADR-aligned clusters merged into main (PR #349, 125 commits, 24K LOC, 205 files), bringing the runtime, storage, query, pack, and CLI surfaces into compliance with the ADR-001 through ADR-046 specifications.

Crates published (20 total at v0.2.1)

Foundation: khive-types, khive-score, khive-fold
Storage / query: khive-storage, khive-db, khive-query
Auth: khive-gate, khive-gate-rego
Runtime: khive-runtime, khive-request
Packs: khive-pack-kg, khive-pack-gtd, khive-pack-brain, khive-pack-memory, khive-pack-comm, khive-pack-schedule, khive-pack-template
VCS: khive-vcs
Binaries: khive-mcp, kkernel

Highlights

Entity / note / edge model

• EntityKind extended from 6 → 8 closed base kinds (Artifact, Service added) — ADR-001
• entity_type promoted to first-class SQL column with composite index — ADR-001/008
• Edge ontology aligned with ADR-002: 13 typed relations, lifecycle states, endpoint contracts
• Note kinds + curation per ADR-013/014: kind-routed CRUD, Page pagination, tri-state nullable patches
• Pack-extensible edge endpoints — ADR-031

Storage capability traits + sparse vector — ADR-005/011

• Trait-only SqlAccess, VectorStore, TextSearch boundary
• Sparse vector contract; vec0 schema detection via pragma_table_info
• V14 embedding model registry migration — ADR-043

Auth and namespace isolation — ADR-007

• NamespaceToken minted at the dispatch boundary; sealed constructors
• build_edge / link_many take &NamespaceToken as first param (no caller-supplied namespace)
• All ID-based runtime ops verify record.namespace == caller_namespace
• Cross-tenant security: client lambda_id / namespace stripped when auth supplies it

Runtime backend and SubstrateCoordinator — ADR-003/009/028/029 (phase 1)

• Composable Service API
• Substrate-level kind dispatch (entity / note / edge ↔ granular concept / task / etc.)

Query layer — ADR-008/041

• GQL + SPARQL parsers + SQL compiler with proper synthetic edge wiring to events/notes tables
• OR-spanning variable-length WHERE rejected (no leaf-AND flatten)

Pack model — ADR-017/023/025/027/040

• HandlerDef pack contract: VerbCategory, ValidationRule, SchemaPlan
• Pack verb registry, wire names, introspection
• Dynamic pack loading from optional packs (KHIVE_PACKS env)

Request execution and presentation envelope — ADR-016/045

• Function-call + JSON DSL forms
• Execution modes (single / batch / chain)
• Standard envelope {ok, tool, result | error}

Event model — ADR-004/009/014/022/032/041/042/046

• Curation payloads carry full ADR-014 fields
• Event-sourced proposals (propose / review / withdraw) with V15 migration
• Brain profile orchestration; unbind AND-semantics; archived-default resolution

Memory recall + rerank pipeline — ADR-021/033 (phase 1)

• Decay-weighted ranking
• Hybrid FTS + vector with RRF fusion

Retrieval checkpoints + proof references — ADR-030

• Checkpoint protocol implementation; BLAKE3 integrity checks

GTD pack — ADR-004 (phase 1)

• NoteKindSpec schema plan + lifecycle audit; transition validation

VCS git-native — ADR-010/020

• Snapshots, branches, three-way merge

kkernel engine + admin commands — ADR-034/035/043/044 (phase 1)

• engine list / status working; unimplemented destructive commands return honest Err("not yet implemented (track #380/#381)…") instead of fake "accepted"

Import / export / remote resolver / sync — ADR-035/036/037 (phase 1)

• Schema layer + scaffold; run_sync remote fetch and kg:// resolver deferred (issues #363/#364)

Schema migration ledger — ADR-015

• ADR-015 process; full ledger backfilled through V15

npm packaging — ADR-026

• Per-platform Rust binary via optionalDependencies

Security fixes during integration

• CRIT-1: build_edge / link_many no longer accept client-supplied namespace — sealed behind verified NamespaceToken
• CRIT-2: pack-kg propose / review / withdraw no longer accept client-supplied actor — uses verified token

CI cleanup

• Removed dead check-proof-references.sh call from scripts/ci.sh (script was deleted but reference remained)

Known scope deferrals

• c16 ([ADR-011] retrieval / embed / lattice boundary, 10 CRITs) — issue #326 remains open
• Multi-actor security follow-ups #394-#396 — gate when khive moves beyond single-user OSS
• 30+ phase-2 follow-ups filed across the cluster series — see issue labels follow-up, adr-alignment

Deferred but unblocked

• Frontend / dashboard / kg-site work
• LNDL workstation port
• iPhone bridge

---

Full PR: #349
Commits since v0.2.0: 125
Cluster index: c01-c25 (except c16) — see PR description for per-cluster PR references

v0.2.0

What's New

Major: New kkernel admin binary (ADR-076) — real SQLite sync, pack introspection, future home of kkernel mcp.

81-issue sweep: Resolved 77 issues across 12 parallel plays, verified by parallel Opus auditors, corrected where the initial sweep missed.

13 new ADRs (065-077): plugin intent routing, cross-plugin workflows, marketplace adaptation, communication/schedule packs, KG swarm self-correction, agent-driven PR workflow, kernel/MCP split, native binary packaging.

Highlights

• kkernel sync --repo . --db .khive/state/working.db — builds a real SQLite DB from NDJSON
• kkernel pack list --human — introspect all registered packs
• Search responses now include entity_kind / note_kind per hit
• Neighbor/traverse responses include name + kind per node
• FTS5 score normalization fixed (linear rescaling replaces collapsed formula)
• DispatchHook + PackTunable wired end-to-end with regression tests
• Flaky tracing test properly fixed (global subscriber + impl-name filter)
• 25+ new regression tests from the audit-correction round

Breaking Changes

• neighbors / traverse JSON response uses id instead of node_id (legacy node_id accepted as input alias)
• Search response field: note_id → id (per #148 normalization)

Install

cargo install khive-mcp   # MCP server
cargo install kkernel     # Admin binary

Full Changelog

v0.1.4...v0.2.0

v0.1.4

What's New

ADR Implementations

• ADR-036 — Memory pack with decay-aware ranking (khive-pack-memory crate)
• ADR-037 — Inter-pack vocabulary dependencies (Kahn's topo-sort, cycle/missing-dep detection)
• ADR-038 — Events surface: public list+get over EventStore, immutable-event enforcement
• ADR-042 — KG versioning implementation (khive-vcs crate: snapshots, branches, checkout)
• ADR-043 — KG merge algorithm (khive-merge crate: 3-way merge, LCA, conflict detection)

Features

• KG versioning + merge — full implementation with SHA-256 content-addressed snapshots, branch CRUD, 3-way merge with field-level property conflict resolution (#1, #2)
• Deno CLI — import/export + graph traversal commands (builds on ADR-011 scaffold) (#81)
• Link name resolution — link verb now resolves entity names to UUIDs automatically (#65)
• Import validation — import_kg validates edge endpoints, rejects dangling references (#28)
• Marketplace — kg-swarm plugin with 4 workflow skills + researcher agent (#75)

Fixes

• update(properties=...) now merges instead of replacing (#71, #74)
• Contract test flake fixed (tracing subscriber race serialized via LazyLock)
• Compact output reverted from MCP response layer (display formatting belongs in CLI)
• Publish script updated with 3 new crates (16 total)

Breaking Changes

• VerbRegistryBuilder::build() now returns Result<VerbRegistry, RuntimeError> (was infallible)

Stats

• 9 PRs merged, 5 ADRs implemented, 3 new crates, ~8K LOC added
• 551 tests pass, 7/7 contract tests pass
• Version: 0.1.3 → 0.1.4 across all 16 crates

v0.1.2 — Pack Architecture

What's new

Pack-based verb dispatch — the MCP server is now a thin dispatch shell. All business logic lives in composable packs registered via VerbRegistry.

Claude Code marketplace plugin — marketplace/kg ships 4 workflow skills (digest, explore, connect, polish) + a researcher agent. Install with /plugin install kg.

Architecture

khive-mcp (transport) → VerbRegistry → khive-pack-kg (handlers) → khive-runtime (storage)

Changes

• khive-pack-kg — new crate: KG vocabulary (6 entity kinds, 5 note kinds) + 11 verb handlers with kind validation, UUID resolution, and edge relation parsing
• khive-mcp rewritten from 851 → 306 lines: each tool handler is now 3 lines (serialize → dispatch → format)
• khive-runtime gains VerbRegistry + PackRuntime trait for object-safe async dispatch
• khive-types gains Pack trait (no_std, zero-cost const metadata)
• Runtime no longer hardcodes EntityKind/NoteKind validation — packs own their vocabulary
• marketplace/kg plugin: 4 intent-shaped workflow skills + researcher agent for Claude Code

For users

No breaking changes to the MCP surface. Same 11 tools, same params, same behavior.

New: install the KG plugin in Claude Code for guided research workflows:

/plugin install kg

For extension authors

Implement Pack + PackRuntime on your struct, register it in the VerbRegistryBuilder, and your vocabulary + handlers are live. See ADR-025 for the full spec.

Crates published

Crate	Version
khive-types	0.1.2
khive-score	0.1.2
khive-storage	0.1.2
khive-db	0.1.2
khive-query	0.1.2
khive-runtime	0.1.2
khive-pack-kg	0.1.2
khive-mcp	0.1.2

Full Changelog: v0.1.1...v0.1.2

khive v0.1.1

Release: khive v0.1.1

Date: 2026-05-16
Tag: v0.1.1
Crates: https://crates.io/crates/khive-mcp

---

Highlights

Short UUID prefix resolution and GQL property projections make the MCP surface more ergonomic for agents. Agents can now use 8-char ID prefixes instead of full 36-char UUIDs, and GQL queries can project specific properties (RETURN a.name) instead of returning all columns.

Breaking changes

• None.

New features

• Short UUID prefix resolution: All UUID-accepting parameters accept 8+ hex-char prefixes. Namespace-scoped, with explicit ambiguity errors. (ADR-023)
• GQL RETURN projections: RETURN a.name, b.name emits only the specified column. Unknown properties produce compile errors listing valid options.
• sqlite-vec enabled by default: The vectors feature is now always active on khive-db, fixing "no such module: vec0" on fresh databases.

Bug fixes

• Fixed resolve_prefix querying non-existent edges table (correct table: graph_edges).
• Fixed silent wrong-answer bug where unknown GQL projections mapped to name column.

Crates published

Crate	Version	crates.io
khive-types	0.1.1	link
khive-score	0.1.1	link
khive-storage	0.1.1	link
khive-db	0.1.1	link
khive-query	0.1.1	link
khive-runtime	0.1.1	link
khive-mcp	0.1.1	link

Install

```bash
cargo install khive-mcp@0.1.1
```

MCP configuration

```json
{
"mcpServers": {
"khive": {
"command": "khive-mcp",
"args": []
}
}
}
```

Migration notes

No schema changes from v0.1.0. Drop-in upgrade — cargo install khive-mcp picks up the new version.

Known issues

• GQL does not support RETURN a.* (wildcard projection) — use RETURN a for all columns.
• SPARQL does not support property projections (only variable-level: SELECT ?a ?b).

What's next

• Python behavioral contract test suite (#21)
• Plugin/marketplace for easier agent installation (#19)
• request batch DSL (ADR-020)

khive v0.1.0

The first public release of khive — a research knowledge graph runtime.

Highlights

A single 7.7MB Rust binary (khive-mcp) serves a complete research knowledge graph over MCP stdio. Typed entities, closed edge ontology, hybrid search with local embeddings, GQL/SPARQL queries — ready for Claude Code and any MCP-compatible agent.

What's included

• 7 Rust crates published on crates.io: types, score, storage, db, query, runtime, mcp
• 11 MCP tools: create, get, list, update, delete, merge, search, link, neighbors, traverse, query
• Hybrid search: FTS5 trigram (CJK-safe) + sqlite-vec embeddings + reciprocal rank fusion
• GQL + SPARQL: two query syntaxes, one SQL compiler
• Closed taxonomies: 6 entity kinds, 13 edge relations, 5 note kinds — enforced at compile time
• Cross-substrate links: notes annotate entities via the same edge system
• Namespace isolation: tenant scoping on every operation

Install

cargo install khive-mcp

Configure for Claude Code

Add to .mcp.json:

{
  "mcpServers": {
    "khive": {
      "command": "khive-mcp",
      "args": []
    }
  }
}

What's next

• HTTP gateway + CLI (Deno)
• Visual KG explorer (Next.js)
• supersede verb, request batch DSL, note merge