MESA Core · v0.9.3
Yayın politikası
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.
Yayın ve üretim doğrulaması#
Bu belgeler Core v0.9.3, 531209bc45805b478264f6dfa8a9e40a94e345cb etiket commit’ini izler. GitHub etiketi ve PyPI wheel/sdist dosyalarının mevcut ve geri çekilmemiş olması 17 Kasım 2026’da doğrulandı. Alfa / üretim NO-GO sürer.
Yayınlar CI sonucunu bekler#
Etiketli changelog, etiketle tetiklenen PyPI yayınlarının derleme ve yayımlamadan önce tam yeniden kullanılabilir CI iş akışını beklediğini belirtir. Bağlantının doğrulanmasını ilk canlı etiket çalışmasına bırakır; bu web sitesi yenilemesi o çalışmayı, imzalı etiket ön kontrolünü veya derleme kanıtlarını denetlediğini iddia etmez. Sürüm notlarını ve aşağıdaki sabitlenmiş yayın prosedürünü okuyun.
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.
V4 paket sürümü 0.9.3; yayın aşağıdaki “Yayınlama”
adımlarıyla depo sahibinindir. Aşağıda kayıtlı yayın istisnasını depo sahibi
v0.8.1 source release için açıkça onayladı. Production qualification halen
release candidate olarak değerlendirilir. Production kararı
Final MVP Certification tamamlanana kadar NO-GOdur. Sürüm numarası veya
tag’in atanması tek başına production GO anlamına gelmez. Eski V3 tag/release kayıtları tarihsel bağlamlarıyla değerlendirilir.
Zorunlu v4 kapıları#
Production GO yalnız aşağıdaki kanıtların aynı commit için mevcut olması halinde
verilebilir. Source yayın istisnası varsa sürüme özel kaydedilir; bu kapıları
karşılanmış yapmaz:
- kilitli build, Ruff, Black ve Mypy;
- tüm core ve benchmark contract testleri;
- v4 API/SDK/MCP contract parity;
- Tier-3 ret, retry, lease kaybı, projection crash ve rollback testleri;
- Graph V2 identity/provenance/purge ve iki yönlü reconciliation;
- cross-tenant/workspace/dataset negatif güvenlik testleri;
- dataset filtreli RRF lane-ablation ve vector-only karşılaştırma raporu;
- production-benzeri queue saturation, worker crash ve concurrency;
- offline backup → restore → rebuild → parity → cutover rehearsal;
- seçilen gerçek provider/model ile boot/restart, maliyet ve token kanıtı;
- 24 saat soak.
Son madde dahil tüm kapılar geçene kadar production-readiness kararı NO-GO
kalır. CI başarısı tek başına GO değildir.
Yerel preflight#
Temiz checkout ve release commit’inde:
uv lock --check
uv sync --locked --python 3.11 --extra dev
uv pip check
uv run ruff check .
uv run mypy mesa_memory mesa_storage mesa_workers mesa_api mesa_client \
--ignore-missing-imports --explicit-package-bases --follow-imports=skip
make test-local
# Adapter-inclusive ayrı gate: dev + adapters kurulumu sonrası make test-all
uv build --wheelCompose sözleşmeleri:
docker compose -f docker-compose.v4.yml config --quietBu model-disabled render yalnız deployment topology doğrulamasıdır.
Full-cognitive kanıt gerçek provider ile ayrı staging rehearsal’dan gelir.
CI kanıtları#
Release commit’inde şu workflow’lar geçmelidir:
MESA CI: quality, v4 contract, security, migrations, package ve coverage;- Benchmark contractları ve dataset filtreli RRF ablation artifact’ı:
eski Benchmark data quality workflow’u Core’dan çıkarılmıştır; ayrı
mesa_benchmark kanıtı aynı release commitine bağlanmalıdır. Yokluğu PASS değildir;
MESA external release gates: v3 compatibility Compose, v4 combined Compose,
flow, bounded capacity ve executable docs.
24 saat soak GitHub hosted runner süresine sığdırılmaz; production-benzeri
ortamda dışarıda yürütülür. Başlangıç/bitiş zamanı, image digest, config hash,
health/parity serisi, restart/incident kaydı ve sonuç özeti release evidence
olarak saklanır.
Sürüm, build ve tag#
Kapılar geçtikten sonra:
- SemVer kararı
pyproject.tomlveCHANGELOG.mdiçine uygulanır. - Release commit’i CI’dan geçirilir.
- Temiz checkout’ta wheel/SBOM üretilir ve doğrulanır.
- Yetkili operator signed annotated tag oluşturur.
git tag -s vX.Y.Z -m "MESA vX.Y.Z"
python scripts/release_preflight.py vX.Y.Z
git push origin vX.Y.ZCore CI tag job’ı reproducible wheel, CycloneDX SBOM ve GitHub OIDC attestation
üretir. Repository workflow’ları GitHub Release veya production deployment’ı
otomatik oluşturmaz.
CI tag checkout’unda yalnız SemVer, pyproject.toml sürümü ve CHANGELOG
başlığı doğrulanır. Annotated tag ve imza doğrulaması trusted operator
keyring’ine sahip temiz checkout’ta yukarıdaki tam preflight komutuyla yapılır;
CI bu imza kontrolünü taklit etmez veya zayıflatmaz.
Release operator, wheel ve SBOM için üretilen OIDC build attestations
kayıtlarını indirmeli ve artifact digest’leriyle birlikte doğrulamalıdır.
Migration ve rollback paketi#
Release artifact’ları şunları birlikte taşır:
- wheel/image digest ve SBOM;
- Alembic head ve migration rehearsal sonucu;
- backup manifest formatı ve restore doğrulaması;
- V4 upgrade/projection rebuild/parity raporu; V3 içerik taşıma varsa ayrı ingestion doğrulaması;
- retained backup konumu ve cutover rollback prosedürü;
- v4 API/OpenAPI, SDK/MCP contract test sonuçları;
- benchmark ve soak evidence.
Restore mevcut hedefi asla ezmez. Parity veya health kapısı başarısızsa cutover
yapılmaz; eski storage ve v3 compatibility servisi korunur.
Yayınlama (yalnızca depo sahibi)#
PyPI yayını GitHub Actions üzerinden OIDC ile token/secret kullanılmadan trusted publishing ile yapılır (D42).
Bir kerelik kurulum (depo sahibi)#
- PyPI Trusted Publisher:
- PyPI hesabında
mesa-memoryprojesi (veya "Add a pending publisher" sekmesi) altında GitHub publisher eklenir: - Owner:
Yasou13 - Repository:
MESA - Workflow name:
release.yml - Environment name:
pypi
- GitHub Environment:
Yasou13/MESArepository ayarlarında (Settings > Environments)pypiisimli bir environment oluşturulur.
Yayınlama adımı#
Sürüm kapıları geçtikten sonra etiketi oluşturup göndermek yeterlidir:
git tag vX.Y.Z
git push origin vX.Y.ZTag push edildiğinde .github/workflows/release.yml otomatik tetiklenir, uv build ile paketleri üretir, uvx twine check ile doğrular ve pypa/gh-action-pypi-publish ile PyPI'a yayınlar.
README.md dosyasındaki kurulum satırı bu release commit'inde pip install mesa-memory olarak tamamlanmıştır.
Sürüme özel yayın istisnaları#
v0.8.1 source yayını depo sahibi tarafından 18 Ekim 2026'da açıkça onaylandı.
Yerel GPG anahtarı bulunmadığından bu yayın annotated, imzasız tag kullanır;
signed-tag preflight başarısı iddia edilmez. Gerçek provider ve production
sertifikasyonu bu source yayınına dahil değildir. Ayrıntılar
v0.8.1 sürüm notlarında kayıtlıdır.
v0.8.0 source yayın onayı, imzasız tag ve eksik sertifikasyon kanıtları
v0.8.0 sürüm notlarında tutulur. Bu istisna sonraki
sürümlere taşınmaz ve production GO sayılmaz. Bu sayfa genel prosedürü,
sürüm notları ise o yayının durumunu tanımlar.
