MESA Core · v0.9.3
v0.9.3 yükseltmesi
Bu rehberin Türkçe ve İngilizce sürümleri aynı konuyu açıklar. Bu sayfayla ilgili kaynak bölümleri en altta yer alır.
Sürüm geçişinden önce yedek alın#
Sistemi çevrimdışına alıp yedekleyin. V4 tek combined süreciyle çalışır; modeller isteğe bağlıdır. Geri dönüş için sakladığınız yedeği yeni ve boş bir dizine yükleyin; dönüştürülen dizinin sürümünü yerinde düşürmeyin.
v0.9.3 geçişini hazırlayın#
Eski kökün şema ve embedding kimliğini kaydedip v0.9.3’nin kilitlenmiş ortamını kullanın. Aşağıdaki kaynak eki önceki v0.8.0 yükseltmesini anlatır; tarihsel geçiş rehberidir. Yükseltmeden önce yerel kimlik bilgilerini, isteğe bağlı model/çizge ayarlarını ve tam belge sürüm davranışını inceleyin. İşletim, API ve sürüm sınırları belgelerine bakın.
Mevcut v0.9.1 veri alımı indeksleri#
Normal başlangıç e6f7a8b9c0d1 migration’ını uygular. Yükseltmeden önce tek depolama sahibini durdurun ve tam çevrimdışı yedek alın. Yedek ve geri yükleme ile tek sahipli kurtarma prosedürünü izleyin. Doğrulanmış PyPI paketiyle pip install --upgrade mesa-memory==0.9.3 kullanarak yükseltin; kuruluma bakın. Yeni sürümlerde önceki parçalama planı için MESA_CHUNKING=plain, önceki vektör ağırlığı için MESA_RRF_VECTOR_WEIGHT=1 kullanın. Mevcut ACTIVE sürümler değişmez.
pip install --upgrade mesa-memory==0.9.3Yükseltirken değişen varsayılanları inceleyin#
MESA_EXTRACTION_ENABLED, artık modellerden bağımsız olarak varsayılan false değerindedir. Açık uçlu model tabanlı SPO çıkarımını sürdürmek için açıkça true yapın. Hukuk kuralları varsayılan true değerindedir; MESA_LEGAL_RULES_ENABLED=false, kayıtlı kimlik/anlık görüntüleri silmeden yeni hukuki zenginleştirme ve arama eklerini kapatır. Ayar değişikliği mevcut ACTIVE sürümleri yeniden çıkarmaya başlamaz. Tek depolama sahibini yeniden başlatmadan yapılandırmayı ve yayın sınırlarını inceleyin.
v0.9.3 embedding kimliği ve başlangıç#
Varsayılan MESA_EMBEDDING_MODEL=local:BAAI/bge-m3, MESA_EMBEDDING_DIMENSION=1024 ve normalizasyon açıktır. Modeller varsayılan kapalı kalır. Yerel modeli açmadan önce indirin. Önceki varsayılanla oluşturulmuş eski depoda aşağıdaki iki ayarı birlikte koruyun veya kimliği değiştirmeden önce yeniden oluşturun:
MESA_EMBEDDING_MODEL=local:magibu/embeddingmagibu-200m
MESA_EMBEDDING_DIMENSION=768Başlangıç, etkin consolidation döngüsü olmadan MESA_TIER3_MODE=1/2 ayarını reddeder; çıkarım açık olmalıdır. . içeren başlangıç MESA_API_KEY değerleri de başlangıçta reddedilir.
Kaynak belgedeki ilgili bölümler
Bu bölüm, kaynak belgenin bu sayfayla ilgili kısımlarını değiştirmeden gösterir. Kaynak içindeki bir bölüme giden bağlantıyı açtığınızda metin otomatik olarak görünür.
Upgrading to v0.8.0#
Current package metadata is 0.9.3. The v0.8.1 publication was owner-approved with the limitations in
the release notes; it does not certify production
readiness. Confirm actual tags in GitHub Releases. This guide describes changes
since v0.7.1, not a completed production migration.
v0.8.1 retains the v0.8.0 schema head below. It adds storage/retrieval hardening
and developer-experience fixes; it introduces no new schema migration. The
existing embedding identity, offline upgrade and backup requirements still apply.
Preconditions and changed contracts#
Use a stopped, backed-up storage root and rehearse on a new disposable root.
Record source commit, lockfile, provider/model/revision/dimension/normalization,
Alembic head, artifacts and rollback path. RBAC has its own schema version.
Since v0.7.1, the tree includes immutable revision manifest activation, opaque
physical catalog identity, declared/manifest/chunk hash separation, durable
rebuild operations/generations, provider identity, assertion FTS/representation
and typed legal identity migrations. Current source expects Alembic head
d5e6f7a8b9c0. Do not assume an old database is compatible just because the
package version stayed 0.7.1 throughout the development branch.
New insertion/reprojection uses assertion-semantic-v1; migrated old vectors
are legacy-v0 and cannot contribute as current semantic evidence. Reindex via
the supported full offline rebuild. Unknown legacy provider
identity can be adopted only with external proof and a fresh unclaimed pending
operation. Matching dimensions alone do not prove matching embedding spaces.
Search/context carry temporal and jurisdiction filters; graph ON/OFF ablation
and bounded diagnostics are available. Context has atomic proof packing and an
opt-in adaptive mode. HTTP insert supports typed legal identity, while SDK
insert does not currently expose it. Invalid/frozen/idempotency-conflicting
source identity fails rather than silently overwriting. Semantic REJECTED
replay returns 409 NON_REPLAYABLE.
Migration configuration#
mesa_storage/alembic.ini owns the migration database URL.
MESA_STORAGE_ROOT alone does not change that URL. With all writers stopped,
prepare a reviewed copy of the Alembic configuration with an absolute staging
SQLite URL and absolute script_location pointing to this release's migrations:
.venv/bin/alembic -c /srv/mesa/reviewed-staging-alembic.ini upgrade headThe path is an operator example, not a configuration supplied by the repository.
Use a verified restored staging root and the matching release environment.
This migrates canonical V4 schema; the projection runner
rebuilds its derived stores. Neither procedure is a general V3 content converter.
V3 content needs explicit source/catalog mapping and V4 ingestion into a separate root.
Upgrade and rollback sequence#
- Drain work, stop writers and take a checksummed backup under the writer-lock boundary.
- Validate the backup and restore to a new empty staging root.
- Apply forward migrations offline with the supported release environment.
- Rebuild derived projections where required; check scope, provenance and parity.
- Rehearse start, insert, poll, search, restart and negative authorization.
- Cut over only with full release evidence and retain previous roots/generations.
Alembic downgrade is not the rollback strategy. Restore a verified prior backup
into a new empty root using the matching prior code/config, then validate before
switching traffic. V3 and V4 never share writable physical storage. Do not alter
official certification evidence as part of upgrade verification.
