@appaflytech/zeyrek-ai-mcp 0.0.45 → 0.0.47

package/dist/resources/guides/access.md

@@ -374,7 +374,7 @@ Kompleks projede kimliği platform yönetir; uygulamanın kendi kimlik middlewar
 | `POST …/auth/refresh` | yenileme çerezi (ya da gövdede `refreshToken`) → yeni jetonlar; eski yenileme jetonu tekrar gelirse bütün aile iptal, 401 |
 | `POST …/auth/sign-out` | çerezleri siler |
 | `GET …/auth/me` | kullanıcı, roller, pozisyonlar, birimler, şirketler |
-| `GET /{proje}/runtime/{app}/access` | izin özeti: `mode`, izinli sayfa ve uç slug'ları, entity başına eylemler ve alan düzeyleri (arayüzde gizleme için; `enforce` dışında her şey açık döner) |
+| `GET /{proje}/runtime/{app}/access` | izin özeti: `mode`, izinli sayfa ve uç slug'ları, entity başına eylemler ve alan düzeyleri (arayüzde gizleme için; `enforce` dışında her şey açık döner — basit projede `off` ve listeler boş, kompleks projede `off`/`shadow` her şeyi listeler). **Runtime basit projede bu ucu çağırmaz:** tür sayfa yanıtının `project.accessModel`'inde ve `uiActions` yanıtının `accessModel`'inde gelir; özet istemcide kurulur (ADR 0021) |
 
 - Jeton önce çerezden, yoksa `Authorization: Bearer`'dan okunur. Çerezle gelen **durum değiştiren**
   istek `X-ZY-CSRF` başlığında `ZY_Csrf_{proje}` değerini ister (yoksa `403 CsrfTokenMismatch`);

package/dist/resources/guides/expressions.md

@@ -111,7 +111,7 @@ dalından devam eder.
 | `setComponentProperty(name, key, value)` / `getComponentProperty(name, key)` | fonksiyon alternatifi |
 | `resetForm(name)` | Formu sıfırlar: alanlar başlangıç değerine döner, form "gönderilmemiş" olur, doğrulama mesajları silinir. Kayıt sonrası "yeni kayıt" için alanları tek tek `null`'a çekme — gönderilmiş formda her biri "zorunlu alan" mesajı çıkarır. Ad ya da komponent değişkeni alır: `resetForm('risk_form')` / `resetForm(risk_form)`. **Yalnız UI flow kodunda** |
 | `LocalStorage` · `Widget` · `params` | yerel veri · widget bağlamı · olay parametreleri. `LocalStorage` barındırıcının deposudur, salt okunur ve değerler METİNdir: web'de uygulamanın kökenindeki `localStorage` (Studio önizlemesinde Studio'nun kendi anahtarları da görünür), cihazda akışın `storage` deposu. `storage` adımı düz bir anahtara yazınca `LocalStorage.<anahtar>` aynı akışta yeni değeri verir ve sayfanın bağları yeniden değerlendirilir (`isSelected: {{ LocalStorage['zeyrek:theme-mode'] === 'dark' }}`). `state.page\|app.<key>`'e yazan adım `LocalStorage`'a girmez (ARC-147, 2026-09-29) |
-| `Device` | Salt okunur cihaz durumu, barındırıcı günceller: `Device.isOnline` — ağ bağlantısı var mı (bilinmiyorsa `true`). Değişince sayfanın bütün bağları yeniden değerlendirilir; çevrimdışı bandı: `isHidden: {{ Device.isOnline }}`. Cihazda `expo-network`, web'de tarayıcının `online`/`offline` olayları. `Device.biometric = { available, enrolled, kinds }` (kök ADR 0021): `available` cihaz kullanıcıyı şu an doğrulayabilir (biyometri **ya da** cihaz parolası kurulu), `enrolled` biyometri kayıtlı, `kinds` ⊆ `face · fingerprint · iris`; barındırıcı vermezse (web, derleme taşımıyor) `{ available: false, enrolled: false, kinds: [] }`, Studio önizlemesi ve kanvas senaryosu `{ true, true, ['face'] }`. Uygulama ön plana dönünce yeniden okunur. `Device` adında komponent ifade bağlamından süzülür (ayrılmış ad) |
+| `Device` | Salt okunur cihaz durumu, barındırıcı günceller: `Device.isOnline` — ağ bağlantısı var mı (bilinmiyorsa `true`). Değişince sayfanın bütün bağları yeniden değerlendirilir; çevrimdışı bandı: `isHidden: {{ Device.isOnline }}`. Cihazda `expo-network`, web'de tarayıcının `online`/`offline` olayları. `Device.biometric = { available, enrolled, kinds }` (kök ADR 0021): `available` cihaz kullanıcıyı şu an doğrulayabilir (biyometri **ya da** cihaz parolası kurulu), `enrolled` biyometri kayıtlı, `kinds` ⊆ `face · fingerprint · iris`; barındırıcı vermezse (web, derleme taşımıyor) `{ available: false, enrolled: false, kinds: [] }`, Studio önizlemesi ve kanvas senaryosu `{ true, true, ['face'] }`. Uygulama ön plana dönünce yeniden okunur. Ağ yokken okumaların ne döndüğü (`Steps.<ad>.cache.at`, `error.network`): `platform_guide('page')` §Kural 1g-4. `Device.offline` (yalnız cihazda): `{ ready, total }` — uygulamanın kaç ekranı çevrimdışı açılmaya hazır; paket inmeden ve web/önizlemede yoktur (`Device.offline?.ready`); servis yazması kuyruğu varsa `queue: { pending, rejected }` ve `rejected` (reddedilen kayıtlar) da buradadır. `Device` adında komponent ifade bağlamından süzülür (ayrılmış ad) |
 | **Ayrılmış adlar** | Bu tablodaki globallerle (ve önsözün iç adlarıyla: `payload`, `error`, `repeaterId`, `_` ile başlayanlar…) aynı `name`'i taşıyan komponent (runtime yalnız İLK `-`'yi siler: `ite-m` da `item` sayılır) ifadede kendi adıyla GÖRÜNMEZ — süzülür, uyarı loglanır (liste: `@ng-apps/flow` `EXPRESSION_PRELUDE_NAMES`). Eskiden aynı ad sayfanın BÜTÜN ifadelerini `SyntaxError`'la düşürürdü (ARC-143). Gateway artık bu adların HEPSİNİ **PAGE-009** ile sayfa/layout yazma yollarında ve `page_schema_validate`'te istek gitmeden reddeder — komponente `t`, `state`, `event`, `item`, `self`, `Page`, `Row` gibi ad verme |
 | `t(key)` | Çeviri anahtarını çözer: aktif dil → projenin varsayılan dili → anahtarın kendisi. Boş string de "eksik" sayılır. Sözlük `machine.context.state.translations`'tan gelir; dil `language-selector` ile değişince bir sonraki çağrı yeni dili görür. **Yalnız UI flow kodunda vardır** — backend ifadelerinde karşılığı `Loc()`'tur (`platform_guide('workflow')`) | `t('home.welcome')` |
 | `log(...)` | console (proxy'leri temizler) |

package/dist/resources/guides/mobile-steps.md

@@ -36,7 +36,10 @@ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `functi
 Bildirim adımları paletten yalnız mobil uygulamada sunulur. Tarif — S04 "her gün hatırlat": önce
 `notification-permission` (S03 düğmesi), sonra `timepicker`'ın değeriyle `notification-schedule`
 (`value: "<saat>.value"`, değer `HH:mm`) ve `error` dalında kullanıcıya mesaj. Çevrimdışı bandı adım değil
-ifadedir: `isHidden: {{ Device.isOnline }}` (`platform_guide('expressions')`).
+ifadedir: `isHidden: {{ Device.isOnline }}` (`platform_guide('expressions')`) — ağı CANLI izler, ekran açıkken bağlantı
+gidince çıkar. Kabuğun kendi bandı ayrıdır: yalnız sayfa isteği (açılış ya da yenileme) düşünce çıkar — ağ yoksa
+"Çevrimdışı · son güncelleme …", sunucu 5xx dönerse "Yenilenemedi". İkisi aynı anda görünebilir; sayfa bandını
+ekranın tepesine değil, anlattığı verinin yanına koyun (`platform_guide('page')` §Kural 1g-4).
 
 ## İzin tarifi
 

package/dist/resources/guides/mobile.md

@@ -562,3 +562,7 @@ yaptıkları. Derlenen uygulama
   Web'in `theme-toggle`'ı mobilde yoktur. Seçili düğme saklanan seçimi `LocalStorage`'dan okur:
   `{{ LocalStorage['zeyrek:theme-mode'] || 'light' }}` (ARC-147).
 - Dar ekran kırılımı (`hideOn: 'mobile'`) mobil uygulamada anlamsızdır: ekran zaten tek boydur.
+- Ağ yokken ekranlar ve (açıksa) son okunan veri cihazdaki kopyadan gelir: `properties.mobile.offline`
+  (MOB-033), `Steps.<ad>.cache.at`, `error.network` — `platform_guide('page')` §Kural 1g-4. Önizleme önbellek kullanmaz.
+  "Uygulama ağsızken de çalışsın" isteğinin tarifi (okuma GET, yazma kuyruğu, liste birleştirme, düğme kilidi, korumasız
+  açılış, bant kapalı): §Kural 1g-4 "Ağsızken fark göstermeyen uygulama", örnek `ngapps://examples/mobile-offline-seamless`.

package/dist/resources/guides/page.md

@@ -443,6 +443,8 @@ göstermek error flow'un işidir.
 > | `Steps.<adımAdı>.error.message` | Patlayan adımın KENDİ storage'ında ucun mesajı — `error` dalında da `always`'te de okunur, sıra aynı: `err.reason` → HTTP durum metni → `'Service request failed'` | `microservice.ts` `.catch` |
 > | `Steps.<adımAdı>.error.status` | HTTP durum KODU (sayı) — parametre ifadesi patladıysa `null` | `microservice.ts` `.catch` |
 > | `Steps.<adımAdı>.error.body` | Ucun hata gövdesi — eski `Steps.<adımAdı>.data`'nın taşındığı yer | `microservice.ts` `.catch` |
+> | `Steps.<adımAdı>.error.network` | **Yalnız mobil, veri önbelleği açıkken:** yanıt hiç alınamadı (bağlantı yok; süre sınırı yalnız saklanan okumalarda, 8 sn) — `true`; `status` yine 503. Önbellek kapalıyken ve web'de alan yoktur (Kural 1g-4) | `microservice.ts` `.catch` |
+> | `Steps.<adımAdı>.cache.at` | Hata değil, BAŞARI şekli: yanıt cihazdaki kayıttan geldi, `at` saklandığı an (ms). Ağdan gelen yanıtta `cache` yoktur (Kural 1g-4) | `microservice.ts` `.then` |
 > | `Steps.<adımAdı>.data` | **HER ZAMAN `null`**'dır — başarı gövdesi değil, hiçbir gövde değil (eskiden hata gövdesiydi) | `microservice.ts` `.catch` |
 >
 > **`alert` adımının `message`'ı ve `description`'ı METİN ŞABLONUDUR — yalnız `{{ }}` içi çözülür.**
@@ -1507,6 +1509,115 @@ Liste → ayrıntı, üç adım:
 
 Web uygulamasında alan yoktur.
 
+## Kural 1g-4 — Mobil çevrimdışı: ayar, önbellek işareti, ağ hatası
+
+Mobil uygulama ağ yokken iki şeyi cihazdaki kopyadan açar. Hangisinin açık olduğu uygulamanın ayarıdır:
+`application_update` `properties.mobile.offline` (`properties.mobile.tabs`'in yanındaki anahtar). Gövde REPLACE'tir:
+`application_get`'teki `properties`'in TAMAMI aynen gönderilir, yalnız `offline` eklenir — eksik anahtar silinir. Studio'da Nav Bar panelinin "Çevrimdışı" bölümü aynı alanı yazar.
+
+| Alan | Değer | Varsayılan | Ne saklanır |
+|---|---|---|---|
+| `screens` | boolean | `true` | Ekran tanımları: açılan ekranların kopyası + uygulama paketi (korumasız ekranların gövdesi hiç açılmadan iner, korumalı ekranlar oturumluya ön yüklenir). Ağ yokken ekran kopyadan çizilir; sayfa isteği düşünce kabuk üstte "Çevrimdışı · son güncelleme …" bandını kendisi gösterir. Hazırlık: `Device.offline` |
+| `data` | boolean | `false` | Son okunan veri: `isRaw: false` YAZILMIŞ GET `microservice` adımı ve connectData okumaları (`list`, `describe`, `lookup`). `isRaw` yazılmamış ya da `true` olan adım ve dosya/akış sonucu dönen servis saklanmaz |
+| `maxAgeDays` | `1` · `7` · `30` | `7` | İkisinin de kayıt ömrü |
+| `banner` | boolean | `true` | Kabuğun çevrimdışı bandı ("Çevrimdışı · son güncelleme", "Yenilenemedi"). `false`: uygulama ağsızken fark göstermez — kendi uyarılarını da kaldırmak yazarın işidir (kök ADR 0026). Saklama ve kuyruk değişmez |
+
+Yalnız varsayılandan ayrılan alanı yazın (`{ data: true }` yeter). Backend alanı doğrulamaz; cihaz okuyamadığı değeri
+(nesne olmayan ayar, boolean olmayan `screens`/`data`/`banner`, kümede olmayan ya da metin `maxAgeDays`, tanınmayan anahtar)
+SESSİZCE varsayılana düşürür — bunu söyleyen tek yer `application_create` / `application_update` yanıtındaki
+`platformWarnings`'tir (**MOB-033**).
+
+**Saklanmayan:** yazma servisleri (POST/PUT/DELETE) ve connectData yazmaları — önbellekten yanıt almazlar.
+Kayıtlar kullanıcıya, ortama ve veri diline bağlıdır; çıkışta ve kullanıcı değişince silinir.
+
+**Yazma kuyruğu (kök ADR 0022) — iki taraf da izin vermeli:**
+
+- **Servis:** tanımında `offlineWritable: true` (`microservice_patch` `/offlineWritable`). Anlamı: "aynı istek iki kez
+  gelirse bir kez uygulanır, çakışmada son yazan kazanır". Platform yazmayı sınıflamaz — iş akışı kaynaklı servisin
+  yazıp yazmadığını bildirimi veren söyler. Okuyan uca (tablo `get`/`count`, görünüm kaynağı) verilirse **MS-025** uyarır.
+- **Akış:** `microservice` adımına `queued` dalı (yalnız mobil). Ağ hatasında (yanıt hiç yok) dal bağlıysa, yöntem
+  yazansa (POST/PUT/DELETE) ve dosya parametresi yoksa kayıt kuyruğa girer ve `queued` koşar; `Steps.<ad>.data` `null`,
+  `Steps.<ad>.queued = { clientRequestId, at }`. Dal bağlı değilse adım bugünkü gibi `error`'a gider; dosya
+  parametresinde `Steps.<ad>.error.code = 'fileNotQueued'`. HTTP hatası — önündeki vekil sunucunun 502/503'ü dahil —
+  kuyruğa girmez. Web uygulamasında ya da bildirimsiz servise bağlanan `queued` için yazım **FLOW-043** uyarısı alır.
+- **Sunucu karar verir:** cihaz servisin bildirimini bilmez. `queued` dalı bağlı yazmanın İLK isteği de
+  `Idempotency-Key` taşır ve kuyruğa aynı kimlikle girer; aynı anahtar bir kez uygulanır, ikincisi 200
+  `{ code: "Duplicate" }` alır — yanıtı yolda kaybolan yazma iki kez uygulanmaz. Bildirimsiz servis anahtarlı isteği
+  422 `OfflineReplayNotAllowedException` ile reddeder: `queued` bağlı adım çevrimiçiyken de HER ÇAĞRIDA `error`'a gider.
+  FLOW-043 uyarısını bu yüzden geçiştirmeyin.
+- **Sınır:** kuyruktaki kayda bağlı ikinci işlem (yarat → sonra güncelle) yoktur; dönen kimliği bekleyen adım
+  (`Steps.<ad>.data.id` ile yönlendirme, bildirim kurma) çevrimdışıyken koşamaz — o akışa `queued` dalı vermeyin.
+- **Gönderim:** bağlantı dönünce, uygulama ön plana dönünce ve ağla soğuk açılışta; kuyruğa giriş sırasıyla tek tek.
+  4xx kaydı reddeder ve sıra sürer; oturum (401/403), 408, 429, 5xx ve ağ hatası sırayı durdurur. 7 günde
+  gönderilemeyen kayıt `expired` ile reddedilir. Kayıtlar kullanıcıya bağlıdır, çıkışta silinmez. Ağ açık ama
+  sunucu ulaşılmazken bağlantı dönüşü tetiği gelmez — beklemesini istemediğiniz akışta `Page.offline.sync()` çağırın.
+- **Görünürlük:** kaydın sonucu akışa dönmez. `Device.offline.queue = { pending, rejected }` ve
+  `Device.offline.rejected` (`id`, `service`, `at`, `status`, `code`, `message`); kod adımında `Page.offline.list()`,
+  `.count()`, `.sync()`, `.resolve(id, 'retry' | 'discard')`. Süresi dolan kayıt yeniden denenmez.
+- **Önizleme:** Studio ve web'de kuyruk yoktur, `queued` hiç koşmaz; `page_screenshot` ağı kesemez. Açık ekran ilk
+  çizildiği kopyayla kalır — akışa eklenen dal ekran bir sonraki açılışta etkindir.
+
+Örnek: `ngapps://examples/mobile-offline-queue` (doz işaretleme: servis bildirimi + `queued` dalı).
+
+**Veri önbelleği açıkken akış ne görür:**
+
+- Saklanan okuma 8 sn süre sınırı taşır; yanıt gelirse olduğu gibi döner ve arkada saklanır. Saklanmayan isteklerde
+  (yazmalar dahil) süre sınırı YOKTUR: yanıt vermeyen sunucuda adım bekler.
+- Yanıt gelmezse (bağlantı yok, süre doldu) ve kayıt varsa adım **başarı yolundan** sürer; storage'ı
+  `{ data, headers, error: null, cache: { at } }` olur — `at` kaydın saklandığı an (ms). Ağdan gelen yanıtta `cache`
+  alanı YOKTUR: "son güncelleme" satırını `Steps.<ad>.cache`'ten kurun, ağ varken gizli kalır.
+- Kayıt da yoksa adım hata yoluna gider: `Steps.<ad>.error.network` `true`, `status` 503. "Bağlantı yok" demek için
+  **önce `error.network`'e bakın** — 503'ü sunucu da döner (bakım, aşırı yük); sunucu arızası
+  `status == 503 && !error.network`'tür. Akış 503'ü `network`'süz karşılaştırıyorsa yazım **MOB-033** bilgi notu alır.
+  Bağlantı yoksa `network` her istekte yazılır (saklanmayanlarda da); önbellek kapalıyken hiç yazılmaz.
+- connectData bağı kayıttan dolarsa düğüme `cachedAt` yazar (`{{ <öğe>.cachedAt }}`; ağdan gelince `null`), yükleme ve
+  hata görünümü çıkmaz; bağlantı dönünce bağ sunucudan yeniden okunur. Kayıttan dönen `lookup` sonucu `cachedAt` taşır.
+- **Önbellek son başarılı yanıtı aynen verir.** Her çağrıda değişen bir GET (sayaç, saat, rastgele değer) ağ yokken
+  eski değerini döner. Parametre, sayfa, arama ve süzgeç isteğin parçasıdır: başka parametreli çağrı başka kayıttır,
+  hiç açılmamış sayfa ağ yokken gelmez.
+
+**Doğrulama sınırı:** önizleme (`/dev`, Studio kanvası) ve `page_screenshot` önbellek KULLANMAZ — ayar açık olsa da her
+okuma ağdan gider, `cache` ve `cachedAt` hiç yazılmaz. `page_screenshot` ağı kesemez; çevrimdışı davranış yalnız
+cihazda görülür (uçak modu). Ölçüldü 2026-10-20 (simülatör, mağaza kabuğu): GET servis okuması ağ varken 149 ms'de
+ağdan, sunucu yanıt vermezken 8,03 sn'de kesilip kayıttan döndü.
+
+Örnek: `ngapps://examples/mobile-offline-list` (liste + "son güncelleme" satırı + bağlantı yok uyarısı). Web
+uygulamasında alan yoktur; gateway web profilinde bu konuda bulgu üretmez.
+
+### Ağsızken fark göstermeyen uygulama (tarif)
+
+Kullanıcı "uygulama internet yokken de normal çalışsın" dediğinde hedef: ağsızken ekran, uyarılar ve akış çevrimiçiyle
+AYNI; veri bağlantı gelince Zeyrek'e kendiliğinden gider. Altı adım birlikte kurulur — biri eksikse fark görünür
+(iPhone'da uçak kipiyle ölçüldü 2026-10-22, `mobile-offline-seamless` örneğinin kaynağı):
+
+1. **Ayar:** `properties.mobile.offline = { data: true, banner: false }` — veri önbelleği açık, kabuğun
+   "Çevrimdışı · son güncelleme" bandı kapalı (kök ADR 0026).
+2. **Okuma GET:** okuyan uç `httpMethod: 'get'`, adım `isRaw: false`; uç filtreleri ve adım parametreleri
+   `source: 'query-string'` (GET'te gövde gitmez). Önbellek yalnız GET okumayı saklar; POST ile okuyan adım ağsızken
+   kayıttan dönemez ve hata yoluna düşer — **FLOW-044** uyarır (yöntem servis tanımındandır, adıma yazılan saklanmaz).
+   (Ölçüm: POST okuyan bir uygulamanın listesi ağsızken "yüklenemedi" dedi.)
+3. **Yazma kuyruğu, uyarısız:** yazan uç `offlineWritable: true`; `microservice` adımının `queued` dalı `always` ile
+   **aynı adıma** bağlanır — ağsız yazma da çevrimiçi gibi biter. Adımın `error` dalı çevrimiçi reddi uyarır; kuyruktaki
+   kayıt sonradan reddedilirse (4xx, 7 günde `expired`) bu akışa DÖNMEZ — `Device.offline.rejected` ile gösterin,
+   `Page.offline.resolve(id, 'retry' | 'discard')` ile karar verdirin; göstermemek bilinçli bir ödünleşimdir.
+4. **Liste bekleyenleri gösterir:** yükleme akışı sunucunun yanıtına `await Page.offline.list()`'teki
+   `status === 'pending'` kayıtları katar (`service` yazma ucunun slug'ı, alan değeri `parameters[].value`'dan); ağ
+   yokluğu hata metni göstermez (`Steps.<ad>.error && !Steps.<ad>.error.network`).
+5. **Düğme kilidi:** yazan düğme istek süresince `isLoading` + `isDisabled`; her dalın sonunda açılır. Kilitsiz düğmede
+   hızlı ikinci dokunuş yeni bir istek ve yeni bir `Idempotency-Key`'dir — sunucu ikisini de uygular (ölçüm: 1,6 sn'de
+   üç dokunuş, üç kayıt).
+6. **Açılış ve yenileme (geçici çareler):** açılış sayfası korumasız giriş ekranıdır; kalıcı `state.app` oturum işareti
+   (`storage: 'device'`) varsa mount akışı listeye `presentation: 'replace'` ile geçer, giriş yazar, çıkış siler —
+   korumalı açılış sayfası ağsız ilk açılışta çizilemiyor (kök ADR 0024 taslak) ve cihazda kabuk bilgisi yokken
+   middleware'in reddi girişe yönlenmiyor (zeyrek-frontend `docs/issues.md` ARC-342). Liste `scroll-view` `refreshable` +
+   `refresh` olayı yükleme akışına bağlıdır — bağlantı dönünce açık ekranın mount akışı kendiliğinden koşmaz (kök ADR
+   0025 taslak). İki karar kapanınca bu adım sadeleşir.
+
+Fark yalnız üç yerde kalır: giriş (ağ ister), hiç açılmamış ekran (cihazda kopyası yok) ve bağlantı dönünce gönderilen
+kayıt — artık bekleyen değildir, önbellekteki eski listede de yoktur; liste aşağı çekilene kadar görünmez (ADR 0025). Önizleme ve
+`page_screenshot` önbellek ve kuyruk kullanmaz — davranış yalnız cihazda görülür. Tam gövde (iki ekran, beş akış, iki
+uç, ayar ve değişken): `ngapps://examples/mobile-offline-seamless`.
+
 ## Kural 1h — Tasarım: `style` prop'u ve tema değişkenleri
 
 Her komponentin `style` prop'u vardır ve emotion `css()` bloğudur: iç seçiciler, pseudo-class'lar

package/dist/resources/guides/translation.md

@@ -351,8 +351,8 @@ yazılır ama yanıt `applicationMismatch: true` ve not taşır.
   `project_update` gerekmez; ama dil production'a da gider ve orada çeviriler deployment'la gelene
   kadar runtime varsayılan dile düşer.
 - Dosya platformda **saklanmaz**: ne dışa aktarma ne içe aktarma Sürücü'ye bir şey bırakır.
-- Studio'nun çeviri panelindeki JSON içe aktarma bundan farklıdır: o yalnız boşları doldurur ve
-  projede olmayan dili atlar.
+- Studio'nun çeviri panelindeki "Excel'e aktar" / "Excel'den içe aktar" düğmeleri (2026-10-21) aynı
+  uçları kullanır; panelin eski JSON içe / dışa aktarması kaldırıldı.
 - Sınırlar: `.xlsx` (`.xls`, csv, json reddedilir), 10 MB, 10.000 satır.
 
 ## Bilinen sınırlar

package/dist/resources/schema-fingerprint.json

@@ -1,6 +1,6 @@
 {
-  "hash": "c1fb21eeab36758c9d81fcd1b41ece1b456a514e7aa944c41e190727b5cdc0ed",
-  "generatedAt": "2026-10-21T05:42:28.082Z",
+  "hash": "5e308466bfb365d77db8b3c0e40b90d21112d560b2b6eb23053200233734e904",
+  "generatedAt": "2026-10-22T18:49:12.637Z",
   "types": 348,
   "files": 173,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",

package/dist/resources/schemas/CreateMicroserviceCommand.json

@@ -117,6 +117,9 @@
       },
       "isAnonymous": {
         "type": "boolean"
+      },
+      "offlineWritable": {
+        "type": "boolean"
       }
     },
     "additionalProperties": false

package/dist/resources/schemas/MicroserviceDto.json

@@ -144,6 +144,9 @@
       "isAnonymous": {
         "type": "boolean"
       },
+      "offlineWritable": {
+        "type": "boolean"
+      },
       "viewId": {
         "type": "string",
         "format": "uuid",

package/dist/resources/schemas/UpdateMicroserviceCommand.json

@@ -111,6 +111,9 @@
       },
       "isAnonymous": {
         "type": "boolean"
+      },
+      "offlineWritable": {
+        "type": "boolean"
       }
     },
     "additionalProperties": false

package/dist/tools/accessRuntime.js

@@ -147,7 +147,7 @@ export function registerAccessRuntimeTools(server, platform) {
                 entities: Array.isArray(data.entities) ? data.entities.length : 0
             },
             note: data.mode === 'off'
-                ? "Zorlama KAPALI: harita her şeyi açık gösterir çünkü karar motoru çalışmıyor. Gerçek kapsamı görmek için environment'ı shadow/enforce'a alın (access_enforcement_mode_set)."
+                ? "Zorlama KAPALI: karar motoru çalışmıyor, her şey açıktır. Kompleks projede listeler her şeyi sayar; basit projede listeler BOŞ döner (basit proje hep off'tur, kapsam için önce kompleks'e dönüşüm gerekir — access_model_preflight). Kompleks projede gerçek kapsamı görmek için environment'ı shadow/enforce'a alın (access_enforcement_mode_set)."
                 : "Harita bu kullanıcının o andaki yetkisidir; bir öğe eksikse nedenini access_preview söyler."
         };
     }));

package/dist/tools/applications.js

@@ -3,6 +3,7 @@ import { handle } from '../platform/responses.js';
 import { forgetApplication, readApplicationPlatform, resolveApplication } from '../knowledge/platform/resolve.js';
 import { mobileTabsProblems, readMobileTabs } from '../knowledge/platform/mobileTabs.js';
 import { mobileTransitionProblems } from '../knowledge/platform/pageTransition.js';
+import { mobileOfflineProblems } from '../knowledge/platform/mobileOffline.js';
 import { findingLine } from '../knowledge/platform/profile.js';
 import { listComponents } from './components.js';
 import { z } from 'zod';
@@ -51,6 +52,19 @@ export function mobileTransitionWarnings(properties) {
         guide: "platform_guide('page') §Kural 1g-2"
     }));
 }
+/**
+ * MOB-033 (çevrimdışı ayarı) — `properties.mobile.offline` yazan mobil uygulama çağrısının denetimi. Yazım platforma
+ * YİNE gider (backend `properties`'i doğrulamaz); cihaz okuyamadığı değeri sessizce varsayılana düşürdüğü için bulgunun
+ * söylendiği tek yer `platformWarnings`'tir.
+ */
+export function mobileOfflineWarnings(properties) {
+    return mobileOfflineProblems(properties).map(message => findingLine({
+        code: 'MOB-033',
+        severity: 'warn',
+        message,
+        guide: "platform_guide('page') §Kural 1g-4"
+    }));
+}
 function withPlatformWarnings(response, warnings) {
     if (warnings.length === 0 || !response || typeof response !== 'object' || Array.isArray(response))
         return response;
@@ -91,7 +105,7 @@ export function registerApplicationTools(server, platform) {
         annotations: writes
     }, handle(config, async ({ projectId, ...body }) => {
         const warnings = readApplicationPlatform(body.type) === 'mobile'
-            ? [...await mobileTabsWarnings(platform, undefined, undefined, undefined, body.properties), ...mobileTransitionWarnings(body.properties)]
+            ? [...await mobileTabsWarnings(platform, undefined, undefined, undefined, body.properties), ...mobileTransitionWarnings(body.properties), ...mobileOfflineWarnings(body.properties)]
             : [];
         const response = await platform.org('POST', `/applications/${projectId}`, { body });
         forgetApplication(platform);
@@ -114,7 +128,7 @@ export function registerApplicationTools(server, platform) {
     }, handle(config, async ({ id, ...body }) => {
         const current = await resolveApplication(platform, id);
         const warnings = current?.platform === 'mobile'
-            ? [...await mobileTabsWarnings(platform, id, current.projectSlug, body.homepageId, body.properties), ...mobileTransitionWarnings(body.properties)]
+            ? [...await mobileTabsWarnings(platform, id, current.projectSlug, body.homepageId, body.properties), ...mobileTransitionWarnings(body.properties), ...mobileOfflineWarnings(body.properties)]
             : [];
         const response = await platform.org('PUT', `/applications/${id}`, { body });
         forgetApplication(platform, id);

package/dist/tools/flows.js

@@ -16,6 +16,8 @@ import { existingMatch, ifExistsParam, platformRename, withRename } from '../pla
 import { randomUUID } from 'node:crypto';
 import { flowProfileWarnings } from './profileWrite.js';
 import { enforceTextHooks } from './textHookGuard.js';
+import { readMobileOffline } from '../knowledge/platform/mobileOffline.js';
+import { resolveProfile } from '../knowledge/platform/resolve.js';
 import { jsonArray } from '../platform/jsonArray.js';
 import { z } from 'zod';
 /**
@@ -38,7 +40,7 @@ async function flowWriteDrops(platform, host, project, environment, applicationI
         return emptyWriteDiff();
     }
 }
-const stepsParam = jsonArray(z.array(z.record(z.unknown()))).describe("Adım listesi (StepManagementSchema: { stepId, name, type, kind, args, branches }). DİKKAT: branches[].nextStepId bir GUID değil, hedef adımın stepId STRING'idir; dal ADI motorun anahtarıdır ve start/setter/code/function adımlarında 'always' olmak zorundadır. Tam şablon: ngapps://examples/flow-load-table (ya da flow_get çıktısı); adım tipleri ve setter/parameters şekli platform_guide('page') Kural 1c. Kullanıcı fonksiyonu çağırmak için 'function' adımı: { type:'function', args:{ functionId:'<function_list id>', functionName:'<ad>', parameters:[{ name:'<bildirimdeki ad>', value:{ type:'static'|'property'|'storage'|'state'|'code', ref } }] } } → çıktı Steps.<adımAdı>.data (ngapps://examples/flow-call-function, platform_guide('functions')).");
+const stepsParam = jsonArray(z.array(z.record(z.unknown()))).describe("Adım listesi (StepManagementSchema: { stepId, name, type, kind, args, branches }). DİKKAT: branches[].nextStepId bir GUID değil, hedef adımın stepId STRING'idir; dal ADI motorun anahtarıdır ve start/setter/code/function adımlarında 'always' olmak zorundadır. Tam şablon: ngapps://examples/flow-load-table (ya da flow_get çıktısı); adım tipleri ve setter/parameters şekli platform_guide('page') Kural 1c. Kullanıcı fonksiyonu çağırmak için 'function' adımı: { type:'function', args:{ functionId:'<function_list id>', functionName:'<ad>', parameters:[{ name:'<bildirimdeki ad>', value:{ type:'static'|'property'|'storage'|'state'|'code', ref } }] } } → çıktı Steps.<adımAdı>.data (ngapps://examples/flow-call-function, platform_guide('functions')). Mobilde çevrimdışı yazma: 'microservice' adımına 'queued' dalı, servis offlineWritable olmalı (platform_guide('page') Kural 1g-4).");
 const policyOverrideParam = z.boolean().optional();
 const patchOperationsParam = jsonArray(z.array(z.record(z.unknown())).min(1)).describe("RFC 6902 JSON Patch işlemleri; yolları flow_get çıktısıyla keşfedin. Dizi öğelerinde indeks yerine seçici kullanılabilir: '/steps[stepId=paint]/args/iteratees[element=tbl_recruiters]/mapping/source' — seçici gövde platforma gitmeden indekse çevrilir, çözülemezse istek hiç gönderilmez.");
 const flowIdParam = guid.describe("Akış id'si; şemadaki events[].value bu id'dir");
@@ -323,6 +325,80 @@ async function functionWarnings(platform, host, project, environment, applicatio
     }
     return [...warnings];
 }
+/** Bir yazım boyunca servis tanımı okuyucusu: FLOW-043 ve FLOW-044 aynı servisi bir kez okur; okunamayan `undefined`. */
+function serviceDefinitionReader(platform, project, environment, applicationId) {
+    const cache = new Map();
+    return microserviceId => {
+        if (!cache.has(microserviceId)) {
+            cache.set(microserviceId, platform.tenant('GET', project, `/microservices/${applicationId}/${microserviceId}`, { environment })
+                .then(payload => unwrap(payload))
+                .catch(() => undefined));
+        }
+        return cache.get(microserviceId);
+    };
+}
+/**
+ * FLOW-043 (kök ADR 0022, plans/mobil-cevrimdisi-calisma g-02). `microservice` adımının bağlı `queued` dalı yalnız
+ * mobil kabuklarda ve yalnız `offlineWritable` serviste koşar (ağ hatasında kayıt kuyruğa girer). İkisi tanımda yok:
+ * uygulama türü org'dan (`resolveProfile`), bildirim servis tanımından okunur. Okunamayan uygulama ya da servis
+ * uyarı üretmez — bilmediğimizi uyarı diye söylemeyiz.
+ */
+async function queuedBranchWarnings(platform, applicationId, steps, errorSteps, readService) {
+    const queuedSteps = [...(Array.isArray(steps) ? steps : []), ...(Array.isArray(errorSteps) ? errorSteps : [])].filter(isRecord)
+        .filter(step => String(step.type ?? '') === 'microservice')
+        .filter(step => (Array.isArray(step.branches) ? step.branches : []).filter(isRecord).some(branch => String(branch.name ?? '') === 'queued' && Boolean(branch.nextStepId)));
+    if (queuedSteps.length === 0)
+        return [];
+    const label = (step) => String(step.stepId ?? step.name ?? '?');
+    const resolved = await resolveProfile(platform, applicationId);
+    if (resolved.known && resolved.profile.platform !== 'mobile') {
+        return queuedSteps.map(step => `FLOW-043: '${label(step)}' adımının 'queued' dalı bu web uygulamasında hiç koşmaz — yazma kuyruğu yalnız mobil kabuklardadır; ağ hatası 'error' dalına gider.`);
+    }
+    const warnings = [];
+    for (const step of queuedSteps) {
+        const microserviceId = step.args?.microserviceId;
+        const definition = typeof microserviceId === 'string' ? await readService(microserviceId) : undefined;
+        // Alanı hiç taşımayan tanım (alan öncesi backend imajı) bilinmiyordur, "bildirimsiz" değil.
+        if (!definition || typeof definition.offlineWritable !== 'boolean' || definition.offlineWritable)
+            continue;
+        warnings.push(`FLOW-043: '${label(step)}' adımının 'queued' dalı bağlı ama '${String(definition.slug ?? microserviceId)}' servisi offlineWritable değil — 'queued' dalı bağlı yazmanın ilk isteği Idempotency-Key taşır, bildirimsiz servis onu 422 OfflineReplayNotAllowedException ile reddeder: adım çevrimiçiyken de HER ÇAĞRIDA 'error' dalına gider. Servis tekrarı kaldırıyorsa microservice_patch ile '/offlineWritable' true yapın; değilse 'queued' dalını kaldırın.`);
+    }
+    return warnings;
+}
+/**
+ * FLOW-044 (plans/mobil-cevrimdisi-calisma g-03, telefon turu 2026-10-22). Veri önbelleği yalnız GET okumayı saklar
+ * (frontend `isCacheableMethod`): okuyan uca (görünüm kaynağı ya da tablo `get`/`count` — MS-025 ile aynı tanım) GET dışı
+ * yöntemle giden mobil adım ağsızken kayıttan dönemez, hata yoluna düşer. Yöntem servis tanımındandır: backend adımın
+ * `httpMethod`'unu her okumada servisten üretir (`StepManagementSchema`), adıma yazılan saklanmaz. Veri önbelleği kapalı
+ * uygulamada hiçbir okuma saklanmadığı için susar. İş akışı ve sorgu kaynaklı uç okuma mı yazma mı bilinmez (kök ADR 0022
+ * Y1) — susar; okunamayan uygulama ya da servis de uyarı üretmez.
+ */
+async function uncachedReadWarnings(platform, applicationId, steps, errorSteps, readService) {
+    const serviceSteps = [...(Array.isArray(steps) ? steps : []), ...(Array.isArray(errorSteps) ? errorSteps : [])].filter(isRecord)
+        .filter(step => String(step.type ?? '') === 'microservice')
+        .filter(step => typeof step.args?.microserviceId === 'string');
+    if (serviceSteps.length === 0)
+        return [];
+    const resolved = await resolveProfile(platform, applicationId);
+    if (!resolved.known || resolved.profile.platform !== 'mobile' || !readMobileOffline(resolved.application?.properties).data)
+        return [];
+    const warnings = [];
+    for (const step of serviceSteps) {
+        const args = step.args;
+        const definition = await readService(args.microserviceId);
+        if (!definition)
+            continue;
+        const source = String(definition.source ?? '').toLowerCase();
+        const operation = String(definition.sourceParameters?.operation ?? '').toLowerCase();
+        if (source !== 'view' && !(source === 'table' && (operation === 'get' || operation === 'count')))
+            continue;
+        const method = String(definition.httpMethod ?? 'get').toLowerCase();
+        if (method === 'get')
+            continue;
+        warnings.push(`FLOW-044: '${String(step.stepId ?? step.name ?? '?')}' adımı '${String(definition.slug ?? args.microserviceId)}' servisinden ${method.toUpperCase()} ile okuyor — veri önbelleği yalnız GET okumayı saklar: ağsızken bu adım kayıttan dönemez, hata yoluna düşer. Okuyan ucu GET yapın (microservice_patch '/httpMethod' 'get'; adımın yöntemi servisten gelir) ve gövdeden okunan parametreleri query-string'e taşıyın — uç filtrelerinin ve adım parametrelerinin source'u 'query-string' olmalı, GET'te gövde gitmez.`);
+    }
+    return warnings;
+}
 /**
  * FLOW-038 (g-02, ADR 0004 — ZM-07). `microservice.ts` `.finally` üç yoldan birini dener: adımın
  * kendi `error` dalı bağlıysa oradan sürer, yoksa flow `errorSteps`'i (`engine.onError`) devralır,
@@ -457,12 +533,15 @@ export function registerFlowTools(server, platform) {
             hostTree: async () => hostNodes(hostRecord),
             where: `akış '${name}'`
         }, policyOverride);
+        const readService = serviceDefinitionReader(platform, project, environment, applicationId);
         const parameterWarnings = [
             ...await requiredParameterWarnings(platform, project, environment, applicationId, steps),
             ...await functionWarnings(platform, host, project, environment, applicationId, hostId, steps),
             ...flowBodyWarnings(steps),
             ...unknownSetterTargetWarnings(steps, errorSteps ?? [], hostNodes(hostRecord)),
-            ...microserviceAlwaysDataWarnings(steps, errorSteps ?? [])
+            ...microserviceAlwaysDataWarnings(steps, errorSteps ?? []),
+            ...await queuedBranchWarnings(platform, applicationId, steps, errorSteps ?? [], readService),
+            ...await uncachedReadWarnings(platform, applicationId, steps, errorSteps ?? [], readService)
         ];
         // Gövde yalnız akıştır (designer-partial-update K1): barındırıcı zarfı platformda hâlâ isteğe bağlı
         // ama gönderilirse okunan tam kaydı yeniden yazar, açık Studio designer'ının kayıtlı tabanını
@@ -544,12 +623,15 @@ export function registerFlowTools(server, platform) {
                 where: `akış '${String(flow.name ?? flowId)}'`
             }, policyOverride)
             : [];
+        const readService = serviceDefinitionReader(platform, project, environment, applicationId);
         const parameterWarnings = [
             ...await requiredParameterWarnings(platform, project, environment, applicationId, flow.steps),
             ...await functionWarnings(platform, host, project, environment, applicationId, hostId, flow.steps),
             ...flowBodyWarnings(flow.steps),
             ...unknownSetterTargetWarnings(flow.steps, flow.errorSteps, hostNodes(hostRecord)),
-            ...microserviceAlwaysDataWarnings(flow.steps, flow.errorSteps)
+            ...microserviceAlwaysDataWarnings(flow.steps, flow.errorSteps),
+            ...await queuedBranchWarnings(platform, applicationId, flow.steps, flow.errorSteps, readService),
+            ...await uncachedReadWarnings(platform, applicationId, flow.steps, flow.errorSteps, readService)
         ];
         await platform.tenant('PUT', project, flowPath(host, applicationId, hostId, flowId), { environment, body: { flow } });
         // Kısmi güncellemede yalnız GÖNDERİLEN alanlar karşılaştırılır; verilmeyen alan için
@@ -607,12 +689,15 @@ export function registerFlowTools(server, platform) {
                 where: `akış '${String(current.name ?? flowId)}'`
             }, policyOverride)
         ];
+        const readService = serviceDefinitionReader(platform, project, environment, applicationId);
         const parameterWarnings = [
             ...await requiredParameterWarnings(platform, project, environment, applicationId, flow.steps),
             ...await functionWarnings(platform, host, project, environment, applicationId, hostId, flow.steps),
             ...flowBodyWarnings(flow.steps),
             ...unknownSetterTargetWarnings(flow.steps, flow.errorSteps, hostNodes(hostRecord)),
-            ...microserviceAlwaysDataWarnings(flow.steps, flow.errorSteps)
+            ...microserviceAlwaysDataWarnings(flow.steps, flow.errorSteps),
+            ...await queuedBranchWarnings(platform, applicationId, flow.steps, flow.errorSteps, readService),
+            ...await uncachedReadWarnings(platform, applicationId, flow.steps, flow.errorSteps, readService)
         ];
         // Gövde değil FARK gönderilir; platform PATCH ucu akışı tek başına yazar. Net diff okunan kayıt ile son hâl arasından hesaplanır.
         const netOps = fastJsonPatch.compare(current, flow);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.45",
+  "version": "0.0.47",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",
@@ -60,4 +60,4 @@
     "typescript": "^5.7.2",
     "vitest": "^3.0.0"
   }
-}
+}