mycel v0.20.0

mycel v0.20.0

Mycel v0.20.0 delivers the neutral internal architecture, native query planner/executor, lexical correctness and scaling work, and durable graph transaction commit idempotency completed since v0.19.

Highlights

• Added durable, principal/space/domain-scoped graph commit idempotency with canonical mutation binding, original-result replay, bounded retention/capacity, delivery repair, diagnostics, and Raft snapshot preservation.
• Replaced daemon-owned query planning/execution with a transport-neutral logical model, shared binder, rule-based physical planner, real physical-plan Explain output, and bounded native operators for indexed, semantic, traversal, broad, mutation, and script execution.
• Preserved transaction snapshot/overlay semantics while adding finite work and memory budgets, view-bound cursors, rollback journals, lifecycle revalidation, and fail-closed resource handling.
• Made lexical indexing/rebuild domain-revision-aware and durable across restart/replay, and made lexical/hybrid pagination candidate-aware and request-bound.
• Removed broad-term BM25 quadratic posting-list rescans by reusing each unique term's live document frequency.
• Replaced subsystem service coupling with neutral contracts and consumer-owned narrow ports across graph, blob, inference, semantic, and automation composition.

Compatibility and upgrade notes

• Use mycel-api, Go SDK, and Rust SDK v0.20.1 for commit-idempotency fields, diagnostics, and corrected repeatable-read contract documentation. The v0.20.1 correction is wire-compatible with v0.20.0. Existing commits without idempotency keys remain supported.
• Graph Raft snapshots advance to V2 and retain live durable idempotency bindings. v0.20 reads V1 and V2 snapshots; pre-v0.20 daemons are not expected to read V2.
• Before upgrading clustered PVCs, retain a validated pre-upgrade cluster backup/PVC snapshot set. Downgrade requires restoring compatible pre-upgrade storage or rebuilding a fresh older cluster through export/import; do not start an older daemon against upgraded PVCs.
• Query compatibility remains governed by the documented QRX0/QRX4 gates. Continuations are accepted only for compatible source-safe plans and unchanged requests, schemas, revisions, and transaction views.

Images

• myceldb/mycel:v0.20.0
• myceldb/mycel:latest
• Platforms: linux/amd64, linux/arm64
• Multi-architecture digest: sha256:3681716762f0e40054f4fe9f22766ed3ed8810d9b20b2116a3ba0ddd2799e90e

Validation

• make test
• make build
• make docs-check
• daemon-only and public-surface architecture checks
• GitHub tag CI and SonarCloud
• independent exact-head release review
• verified v0.20.0 and latest resolve to the same published multi-architecture index and passed a pulled-image CLI smoke test
• Mycel Lab cluster release gate, backup/restore, Raft snapshot/PVC rejoin, identity replay recovery, hard restart soak, and deterministic CommonFolio stale-replay recovery validation

Full details and downgrade guidance are in CHANGELOG.md and docs/operations/procedures/raft-cluster-operations.md.