MESA CORE v0.9.3 · ÇEKİRDEĞİN İÇİNDE

Bilgi, Mesa’nın içinde nasıl ilerler?

İ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Ş

Uygulama dışarıda, depolama tek sürecin yönetiminde.

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.

UML · Bileşen şemasıCore içindeki modüller, arayüzler ve depolar
MESA Core · tek birleşik süreç «component»UygulamanızPython SDK · HTTPveya MCP istemcisi «component»mesa_api · mesa_mcpkimlik · oturum · kabul «component»mesa_workerskalıcı kuyruk işçileri «component»mesa_memoryçıkar · doğrulavektörle · bağlam kur «component»mesa_storageMemoryDAO cephesiasıl yazma · arama «database»SQLiteasıl kayıt «database»LanceDBvektör görünümü «database»Kùzuçizge görünümü «component»Model sağlayıcıLLM + embeddingharici REST /v4 · MCP kuyruk kullanır oku · kabul yaz çağrı 1 · SQL2 · vektör3 · çizge Üç depoya yalnızcabu süreç yazar. İkincibir yazıcı aynı kökükullanamaz.

Ç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).

NEDEN

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

Özgün kaynak metinden kullanılabilir hafızaya.

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.

UML · Sıralı etkileşim şemasıYazma yolu: hemen kabul, arka planda işleme, sonucu sorgulama
«actor»Uygulamanız«boundary»API«entity»SQLite günlüğü«control»İşçi«external»Model«entity»LanceDB · Kùzu insert(kaynak parça) hukuki öğe + değişiklik + iş mutation_id 202 · mutation_id 202 = kabul edildi, işlenmedi.İşleme aşağıda sürer. işi sahiplen (süreli) kaynak parça SPO ayrıca açıksa 0..N bilgi doğrula (mod 0–2) kabul / ret alt[kabul] bilgiler · SQL_APPLIED VECTOR_APPLIED / SKIPPED GRAPH_APPLIED / SKIPPED state = COMMITTED [ret] state = REJECTED loop[son duruma kadar 2 sn’de bir] GET /v4/mutations/{id} durumu oku state son durum

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.

Geliştirici ayrıntısı · altı adım ve kod adları
  1. 01

    Oturumu ve kaynağı kontrol et

    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/insert
  2. 02

    İşi kalıcı olarak kabul et

    Bir 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_runs
  3. 03

    Hukuki öğeleri sakla; isteğe bağlı bilgi çıkar

    Kabul 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=false
  4. 04

    Seçilen doğrulamayı uygula

    Mod 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 / 2
  5. 05

    Depolara sırayla yaz

    Ası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
  6. 06

    Tamamlanmayı doğrula

    İ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?

Her değişiklik görebileceğiniz bir durumda biter.

Üç 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.

UML · Durum makinesiBir değişikliğin QUEUED’dan son duruma yolu
QUEUEDRUNNINGEXTRACTEDVALIDATEDPROJECTINGCOMMITTEDDLQRETRY_PENDINGREJECTEDEKSİKLER NEDENİYLE BEKLİYORROLLED_BACK işçi alırbilgi veya kaynakkontrol geçtiSQL yazıldıadımlar tamam geçici hata (herhangi adım) [doğrulama reddeder] yeniden dene deneme hakkı bitti yeniden kuyruk geri alma[temizlik bitti] geri alma [temizlik bitmedi] REJECTED denetim kaynağını tutar, arama verisi oluşturmaz.

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.

NEDEN

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

Bir sorudan kaynağına bağlı kanıta.

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.

UML · Etkinlik şemasıOkuma yolu: dört paralel kanal, tek birleşik sonuç
Oturumu çözyetkili veri kümeleri Uygunları süzkurum · zaman · tamamlanmış VektörLanceDB · anlamBM25SQLite FTS5 · sözcükBilgi kaydıSQLite · düzenli bilgiÇizge yoluKùzu · ≤ 3 adım Birleştir / sıralaRRF · hukuk · yeniden sıra Tam eşleşme baştahukuk açıksa · ≤ 3 Kanıtı paketle≤ 2048 token çatal: her kanal aynı uygun küme üzerinde çalışır · birleşim: aday başına kanal başına bir oy

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.

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.

Bağlam modelin girdisine sığar

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.

NEDEN

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 →
İsteğe bağlı uyarlanabilir arama: soru ne zaman yeniden yazılır?

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 →
Sıralama formülü ve arama sınırları

KİM NEYİ OKUYABİLİR?

Kapsamı sunucu belirler. Her bilgi kaynağını gösterir.

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.

UML · Sınıf şemasıKim neyi okuyabilir, her bilgi nereden gelir
Erişim kimliği+ principal_id+ anahtar (scrypt özeti) Üst erişim alanı+ tenant_id Çalışma alanı+ workspace_id Veri kümesi+ dataset_id+ purge, rollback izni «enumeration»RolOWNERWRITERREADER Oturum+ session_id+ dataset_ids {sabit} Ajan+ agent_idkişilik, sınır değil Document+ document_id+ title «immutable»Sürüm+ revision_id SourceChunk+ chunk_id+ özgün metin «snapshot»LegalItem+ version, type+ start, end+ kaynak alıntısı 0..* Bilgi kaydı+ özne+ yüklem+ nesne+ state 1..* 1..* 0..* 1..* 1..* **rol 10..*başlatır *1adına «kapsam» 1..* veri kümesi 1..*0..*kanıt Roller aşağı doğru miras kalır.İstek verisi hiçbir zamanyetki vermez (ADR 0011).

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.

NEDEN

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?

Tek süreç, tek veri klasörü.

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.

UML · Dağıtım şemasıTek süreç, tek depolama kökü, isteğe bağlı model sağlayıcılar
«device»Sunucu · VM veya Docker Compose servisi «execution environment»Python 3.11–3.13 · uvicorn «artifact»mesa · birleşik çalışmaAPI + işçiler + MemoryDAO {replicas = 1} «volume»MESA_STORAGE_ROOT «artifact»SQLite«artifact»LanceDB«artifact»Kùzu sahip «device»İstemci uygulama · ajan · SDK HTTP APIX-API-Key «external»Model sağlayıcıları yalnız model açıksa çıkarım · doğrulama · embedding «device»Yedek hedefi çevrimdışı İki süreci aynı depolamaköküne bağlamayın.Kabulü ölçekleyin, yazıcıyı değil.

Üç 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.

Yapılandırılmış sınırlar

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.

Bağlam bütçesi
varsayılan 2048 token
Çizge araması
≤ 20 başlangıç · ≤ 3 adım · ≤ 500 sonuç
Çizge zaman aşımı
varsayılan 15 sn
Sıra birleştirme
RRF, k = 60, vektör 8.0; diğer kanallar 1.0
Mutation durum sorgusu
varsayılan 2 sn’de bir
Sürüm etkinleşme sorgusu
beklerken 1 sn’de bir
Depolama yazıcısı
her depolama kökünde tam bir süreç

03 · KOD NASIL BİR ARAYA GELİR?

Ayrı modüller, açık sorumluluklar.

mesa_api / mesa_mcp

Giriş kapıları

HTTP veya MCP isteklerini alır, kimliği doğrulanmış oturuma bağlar.

mesa_workers

Arka plan işleri

Kalıcı veri alımı, depolama görünümü ve bakım işlerini yürütür.

mesa_memory

Bilgiyi işleme

Bilgi çıkarımını, doğrulamayı, sayısal temsilleri ve bağlam hazırlamayı yönetir.

mesa_storage

Kayıtlar ve arama

MemoryDAO üzerinden asıl SQLite kayıtlarını, kaynak sahipliğini, arama görünümlerini ve aramayı yönetir.

mesa_client

Uygulama bağlantısı

HTTP API’sine bağlanan senkron ve asenkron Python istemcilerini sağlar.

NEDEN

İç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ı →
Bu şemaların dayandığı gerçek Core kaynakları

Doğrulanan kaynak temeli: Core v0.9.3. Şemalar çalışma zamanını sadeleştirir.

SONRAKİ ADIM

Buradan nereye?