Repository navigation
MESA v0.8.1 — MVP hardening and developer experience
Publication status
The repository owner authorized this v0.8.1 source release on 2026-10-18.
It includes the MVP hardening and developer-experience changes merged in PR #112.
Production qualification remains NO-GO pending the normal release gates;
real LLM/embedding integration and a production-like 24-hour soak are not certified.
No local GPG signing key is available, so the annotated release tag is unsigned.
Signed-tag preflight success is not claimed. CI, wheel/SBOM artifacts and OIDC
attestations are verified separately for the release commit and tag.
Removed
- Removed the obsolete standalone raw-log agent-ID backfill script.
- Removed obsolete manual backup/restore, MCP spoofing, Mem0 smoke and async I/O
benchmark scripts fromtests/; removed their stale collection exclusions. - Removed the unused dashboard/showcase frontend, its npm dependencies and build
configuration, and the obsoleterun_demo_rag.pylauncher. MCP control APIs
and operator approval CLI remain available; see control API.
Fixed
- Scoped BM25 corpus statistics, pre-rank audit queries and audit metadata to
authorized tenant/dataset scope; unrelated data no longer influences results. - Protected projection completion with claim/fencing ownership checks; prevented
cross-dataset repair deletions and false invalidation when vector lookups fail. - Kept Kùzu caches consistent after delete and transaction rollback, including
composite assertion IDs; graph commit failures retry and cancellations roll back. - Surfaced vector backend and embedding failures explicitly; removed the legacy
raw-memory fallback to an unrelated eight-dimensional embedding. - Rejected reserved
_mesa_metadata and non-finite RRF weights while preserving
explicit zero confidence. Mapped context, catalog chunk and rollback errors
to actionable API responses instead of generic server errors. - Added optional
legal_identityparity to synchronous and asynchronous V4 SDK
insertion; slowed default status polling to fit the shared minute request budget. - Returned field-specific validation errors without echoing rejected input or
internal route paths, and retained startup error logging after migrations. - Corrected standalone runtime defaults and documented a minimal supported
Python install. Updated CI import checks, documentation contracts and SQLite
fault-injection test doubles. make healthnow checks the running API's readiness and authenticated health
usingMESA_BASE_URLandMESA_API_KEY, without opening local databases.
Unhealthy responses and connection/authentication failures return a nonzero exit.
Documentation
-
Clarified provider prerequisites, immutable embedding identity, asynchronous
projection status, source evidence, session finalization and client cleanup.
The V4 quickstart displays assertion/source references. Models-disabled startup
is described as a health check; V3 ingestion still requires embeddings. -
Verified small SQLite/LanceDB/Kùzu flows, restart, populated tenant isolation
and completed rollback with explicitly controlled model boundaries. These
checks do not establish real-model quality or production-size capacity. -
Consolidated 37 Markdown pages into 20 maintained guides and decision records;
merged overlapping guides, retired obsolete ADR files and repaired document
contracts and links. Release-specific exceptions remain in this changelog. -
Consolidated documentation ownership and navigation; replaced the root V3
whitepaper with a current architecture entry point. -
Removed obsolete Colab guidance, the retired architecture/audit/benchmark
documents and their archive indexes. Merged the external benchmark ownership
note into the ecosystem guide and repaired incoming documentation links. -
Removed duplicated setup/recovery guidance, corrected MCP authorization and
rebuild/migration wording, and clarified ADR applicability. These documentation
changes do not certify a new release; prior tracked records remain in Git history.
Release verification
- Release commit:
d394784. - Local: 108 focused tests, repository-wide Ruff, scoped CI Black, Mypy across 138 production files, lock/metadata/documentation checks and an isolated installed-wheel smoke passed.
- Passed same-commit workflows: MESA CI and external release gates.
- Tag package/provenance job succeeded; downloaded artifact hashes and provenance subject digests were matched to the release commit.
- Assets contain the CI-built 0.8.1 wheel, runtime CycloneDX SBOM, GitHub OIDC provenance bundles and SHA256 checksums.
- Real-provider integration, production-size capacity and a 24-hour soak remain outside this source release.
Full changelog: v0.8.0...v0.8.1