Skip to content

MESA v0.9.3 — ingestion and parser improvements

Latest

Choose a tag to compare

@Yasou13 Yasou13 released this 17 Nov 03:32
531209b

MESA 0.9.3 improves bulk ingestion and legal parsing, updates the default embedding model, and fixes session, projection, and retrieval edge cases. Existing V4 HTTP routes remain compatible.

Fixed

  • MCP session creation now provisions the workspace and dataset when a fresh
    store reports them missing, then retries once. If catalog creation fails,
    callers receive the original session-start error rather than the create error.
  • Ending a session in default Mode 0 now processes deferred records without a
    consolidation loop, allowing finalization to complete.
  • Turkish legal rule comparisons and date lookups handle uppercase İ/I
    consistently with lowercase text. Original text, offsets and rule versions
    are preserved.
  • Scoped FTS queries include deduplicated ı → i variants, so YARGITAY
    and yargıtay find text written YARGITAY KARARI.
  • Context requests reject timestamps without timezone offsets with HTTP 422
    before comparing ranges. Fact validation treats date-only values as UTC
    when comparing them with timezone-aware timestamps, preventing datetime errors.
  • Gateway circuit breakers release half-open probes after permanent errors or
    cancellation. Non-retryable bridge writes enter a terminal failed state
    instead of being sent again on every drain.
  • Projection rebuild smoke checks use the same assertion text, including the
    evidence span, as vector replay.
  • Duplicate or stale projection completion calls preserve committed artifacts;
    artifact compensation remains restricted to fenced mutations.
  • SDK quickstart examples wait for ingestion before requesting context and close
    document files. Documentation links and the architecture version are corrected,
    and embedding setup notes explain downloading the model before enabling it.
  • Parser regression checks retain their 200 ms budget using thread CPU time,
    with a 2 s hang guard. Claude adapter tests skip when the optional anthropic
    package is absent.
  • Legal rule extraction skips impossible decision-reference scans and delays
    law-name cleanup until an attached article is found. On the API-limit
    TCK/1 input, best-of-five local thread CPU fell from 129.861 ms to
    52.330 ms (2.48x faster), with identical saved outputs and spans. The
    isolated 200 ms CI CPU-budget check is blocking again; the full local
    suite retains its 2 s hang guard.

Changed

  • Bulk ingestion batches SQL and graph projections and outbox completion in
    the existing worker pass. The measured 4,999,000-byte document reached full
    readiness in 245.20 s versus 718.27 s before (2.93x faster), with all 4,882
    mutations COMMITTED, SQL and GRAPH COMPLETED, VECTOR SKIPPED, and lossless
    chunk readback. Durability and fencing behavior are preserved.
  • The default embedding model is now local:BAAI/bge-m3, with 1024 dimensions
    and normalization enabled, including the Compose model default. Models remain
    off by default. Stores created with the old default must keep both
    MESA_EMBEDDING_MODEL=local:magibu/embeddingmagibu-200m and
    MESA_EMBEDDING_DIMENSION=768, or rebuild before switching embedding identity.
  • Tag-triggered PyPI releases wait for the complete reusable CI workflow before
    building and publishing.
  • Startup fails with a clear error when MESA_TIER3_MODE=1/2 has no active
    consolidation loop; extraction must be enabled for these modes.
  • Bootstrap MESA_API_KEY secrets containing . are rejected at startup.
    Placeholder API keys and principal IDs in .env.example are commented out.
  • Antigravity bridge write spools are isolated per workspace. Entries in the old
    shared spool are left in place and are not migrated automatically.

Known issues

  • Kuzu 0.11.3 can write uninitialized memory into graph page tails, so raw graph files may contain fragments of text the process handled; MESA never stores memory text in the graph (checked by query), and the graph directory should be treated as sensitive like the SQLite file.
  • Per-minute and daily rate limits are not enforced for /v4/* and /control/*
    in this version; the API documentation now states this limitation.
  • The ASCII query yargitay still does not match text written Yargıtay;
    index-side Turkish folding remains deferred.

Install and upgrade

pip install --upgrade mesa-memory==0.9.3

Follow the upgrade procedure when upgrading an existing store. Embedding identity migration requirements are listed above.

Validation

Full comparison.

Published artifacts

The attached wheel and source distribution match the files published on PyPI by SHA256. SHA256SUMS also covers the locked-runtime CycloneDX SBOM generated by the tag CI. A temporary install of the PyPI wheel passed API, SDK, storage, worker, and configuration imports plus mesa --help.