Skip to content

MESA v0.8.1 — MVP hardening and developer experience

Choose a tag to compare

@Yasou13 Yasou13 released this 17 Oct 22:17

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 from tests/; removed their stale collection exclusions.
  • Removed the unused dashboard/showcase frontend, its npm dependencies and build
    configuration, and the obsolete run_demo_rag.py launcher. 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_identity parity 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 health now checks the running API's readiness and authenticated health
    using MESA_BASE_URL and MESA_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