Repository navigation
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
ı→ivariants, soYARGITAY
andyargıtayfind text writtenYARGITAY 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 optionalanthropic
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/1input, 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-200mand
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/2has no active
consolidation loop; extraction must be enabled for these modes. - Bootstrap
MESA_API_KEYsecrets containing.are rejected at startup.
Placeholder API keys and principal IDs in.env.exampleare 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
yargitaystill does not match text writtenYargıtay;
index-side Turkish folding remains deferred.
Install and upgrade
pip install --upgrade mesa-memory==0.9.3Follow the upgrade procedure when upgrading an existing store. Embedding identity migration requirements are listed above.
Validation
- Tag-triggered CI, build and PyPI publication.
- Round 20 changes.
- Logging test isolation fix, checked with five ordered local test runs and full PR CI on Python 3.11 and 3.13.
- Release commit:
531209bc45805b478264f6dfa8a9e40a94e345cb.
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.