MESA Core · v0.9.3

v0.9.3 yükseltmesi

v0.9.3 kaynak: docs/RUNBOOK.md

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.

bash
pip install --upgrade mesa-memory==0.9.3

Yü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:

bash
MESA_EMBEDDING_MODEL=local:magibu/embeddingmagibu-200m
MESA_EMBEDDING_DIMENSION=768

Baş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.

Dayanak kaynaklar
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:

bash
.venv/bin/alembic -c /srv/mesa/reviewed-staging-alembic.ini upgrade head

The 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#

  1. Drain work, stop writers and take a checksummed backup under the writer-lock boundary.
  2. Validate the backup and restore to a new empty staging root.
  3. Apply forward migrations offline with the supported release environment.
  4. Rebuild derived projections where required; check scope, provenance and parity.
  5. Rehearse start, insert, poll, search, restart and negative authorization.
  6. 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.