Arama kanıt döndürür
Sonuçlar bilgi kaydı, belge, sürüm, parça ve kanal kimliğini korur. Çizge yolu dayanak kayıtlarını ve yönlerini taşır.
MESA CORE v0.9.3 · ÇEKİRDEĞİN İÇİNDE
İki yol var: bir kaynağı hafızaya yazmak ve uygulama soru sorduğunda dayanak bilgiyi bulmak. Aşağıdaki her bölümde bir UML şeması, tasarımın gerekçesi ve ilgili karar kaydının bağlantısı yer alır.
BÜTÜN SİSTEME TEK BAKIŞ
Desteklenen V4 kurulumunda tek bir birleşik süreç; API’yi, arka plan işçilerini ve üç depoyu birlikte yönetir. Kutular ayrı sunucular değil, bu sürecin içindeki modüllerdir.
Çağrılar yalnızca aşağı yönlüdür: API/MCP → işçiler → hafıza → depolama (ADR 0013). Kararı SQLite verir; LanceDB ve Kùzu ondan sonra sırayla yazılan görünümlerdir (ADR 0009).
SQLite, LanceDB ve Kùzu tek bir işlemi paylaşamaz; aynı dosyalara iki yazıcı kurtarmayı belirsizleştirir. Bu yüzden tek süreç yazar, SQLite her adımı kaydeder, diğer depolar onu izler.
ADR 0009 · Günlük ve tek sahip →01 · YAZMA YOLU
Uygulamanız özgün metni belge, sürüm ve parça kimliğiyle gönderir. API işi kalıcı olarak kabul edip 202 döndürür; işleme arka planda sürer. Tam belge kabulü parça planını koruyarak kısa süre kuyruk kapasitesi bekleyebilir. Uygulamanız durum son hâline ulaşana kadar sorgular.
Kabul, hukuki öğeleri SPO kayıtlarından ayrı saklar. Hukuk kuralları varsayılan açık, model tabanlı SPO çıkarımı kapalıdır. Etkin depolar sırayla yazılır; yeniden denemeler aynı kimlikleri kullanır. Mutation sorgusu 2 sn, sürüm etkinleşmesi 1 sn aralıklıdır.
Sunucu erişim kapsamını kimliği doğrulanmış oturumdan alır. İstek; veri kümesini, belgeyi, sürümü ve özgün metin parçasını belirtir.
POST /v4/memory/insertBir aday kayıt, değişiklik günlüğü ve işlem hattı çalışması oluşturulur. HTTP 202, kabulü bildirir; işlemenin tamamlandığını bildirmez.
MemoryCandidate · memory_mutations · pipeline_runsKabul sırasında varsayılan açık hukuk kuralları, özgün parça konumlarıyla sürümlü öğeleri saklar. Model tabanlı özne–ilişki–nesne çıkarımı varsayılan kapalıdır; MESA_EXTRACTION_ENABLED ayrıca açılır. Modelsiz yazmalar BM25 ile aranabilir.
legal_items ≠ SPO · MESA_EXTRACTION_ENABLED=falseMod 0 kurala dayalı kontrolleri kullanır; mod 1 bir model doğrulayıcı ekler; mod 2 farklı iki sağlayıcı/model çiftinin uzlaşmasını ister.
MESA_TIER3_MODE = 0 / 1 / 2Asıl kayıtlar SQLite’a yazılır. Etkin vektör ve çizge adımları ardından LanceDB ve Kùzu’ya yazar; kapalı adımlar SKIPPED olur ve sonradan tamamlanabilir.
SQL_APPLIED → VECTOR_APPLIED → GRAPH_APPLIEDİstemci kalıcı değişiklik kaydının durumunu sorgular. Başarılı son durum COMMITTED’dır.
GET /v4/mutations/{id}BİR ADIM BAŞARISIZ OLURSA?
Üç depo tek bir veritabanı işlemini paylaşmaz. Kalıcı iş kayıtları, süreli iş sahipliği ve tekrarı güvenli kılan alındılar; yarım kalan işin başarı sayılmadan yeniden denenmesini veya uzlaştırılmasını sağlar.
COMMITTED, gerekli adımların tamamlandığını gösterir; kapalı vektör/çizge adımları SKIPPED olabilir. Yeniden denemeler sınırlıdır; sonuçlanmayan iş, biri yeniden kuyruğa alana kadar hata kuyruğunda (DLQ) bekler. Hata gizlenmez, görünür kalır.
Başarısız bir görünüm yazması, telafi edici bir yazmanın arkasına saklanmak yerine retry, DLQ veya BLOCKED olarak görünmelidir.
ADR 0009 · Günlük ve tek sahip →02 · OKUMA YOLU
Oturum hangi veri kümelerinin okunabileceğini sabitler. Uygunluk kuralları sıralamadan önce geri kalan her şeyi eler. Dört kanal uygun kümede arar ve sıralamaları birleştirilir. Hukuk kuralları açıkken kapsamlı atıf katsayıları, isteğe bağlı yeniden sıralama ve sınırlı tam eşleşme önceliği son sırayı belirler.
Kapsam sıralamadan önce uygulanır. Birleştirmeyi hukuk katsayıları ve isteğe bağlı yeniden sıralama izler; tam kanun/madde veya kararın kendi ilk parça referansı en fazla üç sonucu başa alabilir. Diğer sonuçların düzeni korunur. Hukuk kuralları kapalıysa hukuki aşamalar atlanır; PageRank izleme verisi kalır.
Sonuçlar bilgi kaydı, belge, sürüm, parça ve kanal kimliğini korur. Çizge yolu dayanak kayıtlarını ve yönlerini taşır.
Bağlam uç noktası kanıtı bir kez token bütçesine yerleştirir. Çizge ispatı ya bütün olarak sığar ya hiç; ardından uygulamanızın modeli yanıtı yazar.
Vektör, sözcük ve çizge skorları farklı ölçeklerdedir; bunları toplamak anlamsızdır. Sıra konumlarını birleştirmek bu sorunu önler; düşük çizge merkeziliği bir bilginin yanlış olduğuna kanıt sayılmaz.
ADR 0010 · RRF ve PageRank →Arama ve bağlam varsayılan olarak tek sorgu kullanır. Uyarlanabilir bağlam açıkça istendiğinde, boş sonuç veya yetersiz çok kanallı destek bir planlayıcı çağrısını ve en fazla iki yeniden yazımı tetikleyebilir. Her arama özgün kapsamı korur; bu adım yanıt üretmez.
ADR 0015 · Uyarlanabilir sorgu planlama →KİM NEYİ OKUYABİLİR?
Kurumlar çalışma alanlarına, çalışma alanları veri kümelerine, veri kümeleri belgelere sahiptir. Bir belgenin özgün metin parçalarından oluşan değişmez sürümleri vardır ve her bilgi kaydı onu destekleyen parçalara bağlanır.
Dolu elmas sahipliği (bileşim) gösterir: veri kümesi silinince belgeleri de gider. Role, Principal–Tenant bağındaki ilişki sınıfıdır ve çalışma alanlarına, veri kümelerine miras kalır. Oturumu sunucu oluşturur ve veri kümesi setini sabitler. LegalItem anlık görüntüleri kaynak parçalarına aittir; SPO kayıtlarından ayrıdır ve hukuk kuralları kapalıyken sonuç kopyalarında gizlenir.
Ajan kimliği bir kişiliği tanımlar, sahibi değil. İstemcinin gönderdiği kimliği sınır saymak sahipliği belirsizleştiriyordu; bu yüzden zinciri sunucu kendisi çözer.
ADR 0011 · Kurum/veri kümesi yetkilendirmesi →NEREDE ÇALIŞIR?
Depolar tek depolama kökü altında gömülüdür ve tek combined sürece aittir. MESA_GRAPH_ENABLED=false, Kùzu’nun açılmasını önler; modeller kapalıyken BM25 araması çalışır. Ayrı veritabanı sunucusu gerekmez.
Üç depo tek kök altındaki gömülü dosyalardır; birlikte yedeklenir ve geri yüklenir. Modeller kapalı combined çalışma belgeleri kabul eder ve BM25 araması sunar. Hukuk kuralları model istemez; açık uçlu SPO çıkarımı ayrıca açılır.
v0.9.3 yapılandırma sınırları. Ayrı DEV ölçümleri ve CPU/GPU koşulları sürüm notlarındadır; üretim kapasitesini onaylamaz.
03 · KOD NASIL BİR ARAYA GELİR?
mesa_api / mesa_mcpHTTP veya MCP isteklerini alır, kimliği doğrulanmış oturuma bağlar.
mesa_workersKalıcı veri alımı, depolama görünümü ve bakım işlerini yürütür.
mesa_memoryBilgi çıkarımını, doğrulamayı, sayısal temsilleri ve bağlam hazırlamayı yönetir.
mesa_storageMemoryDAO üzerinden asıl SQLite kayıtlarını, kaynak sahipliğini, arama görünümlerini ve aramayı yönetir.
mesa_clientHTTP API’sine bağlanan senkron ve asenkron Python istemcilerini sağlar.
İçe aktarmalar yalnızca katmanlarda aşağı yönlü olabilir. CI kontrolü ters yönlü içe aktarmayı reddeder; depolama kodu API’ye hiçbir zaman bağımlı olamaz.
ADR 0013 · Üretim bağımlılıkları →docs/architecture-v4.mddocs/concepts-and-ingestion.mdmesa_memory/extraction/service.pymesa_workers/projection_worker.pymesa_storage/dao.pymesa_storage/retrieval_scope.pymesa_storage/legal_rules.pymesa_storage/legal_identity.pymesa_memory/context_builder.pyDoğrulanan kaynak temeli: Core v0.9.3. Şemalar çalışma zamanını sadeleştirir.