@appaflytech/zeyrek-ai-mcp 0.0.52 → 0.0.53

package/dist/resources/guides/microservice.md

@@ -186,6 +186,13 @@ DTO'dan süzülmez (WF-026 — `platform_guide('workflow')` §Hata yolu). Sözle
   `filters`'a `source: "body"` + `isRequired: false` bir id filtresi; gövdede id **varsa** eşleşen
   satır güncellenir, **yoksa** yeni satır açılır. `isRequired: true` yaparsan "yeni kayıt" yolu
   kapanır (id gelmeyince uç reddeder).
+- **İstemcinin ürettiği kimlik korunur** (çevrimdışı not, telefonda üretilen UUID): upsert'te `uuid` PK'nın `eq`
+  filtresi eşleşme bulamazsa yeni satır **o kimlikle** açılır (filtre kökte ya da tek `and` grubundaysa; `or` varken ve
+  sayı kimlikte taşınmaz — zeyrek-backend incident-log #190). Sonraki eşitleme aynı satırı bulur; ayrı `client_id` kolonu gerekmez. Aynı kural
+  workflow table adımının upsert'inde de geçerlidir. `properties.generationType: 1` (ByDefault) PK'ya create'te kimlik
+  `fields`'tan da yazılabilir; `0` (Always) PK'ya yazmak `AlwaysGeneratedFieldCantBeWritten` alır
+  (`platform_guide('entity')`). Aynı anahtarla aynı anda gelen iki upsert'in ikisi de create yoluna düşebilir; ikincisi
+  PK çakışmasıyla hata alır (#191, açık) — çevrimdışı kuyruk kayıtları tek tek gönderir.
 
 > **Upsert'te üretilen alan tuzağı.** `operation: 'upsert'` UPDATE yolunda da alan ifadelerini
 > yeniden değerlendirir; sicil/kod gibi üretilen bir değeri `source: 'expression'` ile yazarsan
@@ -380,7 +387,12 @@ döner, hata vermez. Karmaşık erişim modelinde platform sahip koşulunu satı
 AND'ler (`platform_guide('access')`); orada bu grup gereksizdir ama zararsızdır. AND/OR filtrenin
 kendinde değil **bir öncekine bağlantısındadır**: `or` taşıyan çocuk, ilk çocuk bile olsa hedefi
 genişletir. Kural yalnız kayıtta uygulanır; 2026-10-15'ten önce kaydedilmiş uyumsuz uç yeniden
-kaydedilince reddedilir. Workflow table adımı bu kuralı uygulamaz.
+kaydedilince reddedilir. Workflow table adımı bu kuralı uygulamaz; ama grubu korur: `owner = X AND (id = A OR
+client_id = A)` gibi iç içe grup update/delete/upsert'te olduğu gibi gider (2026-10-30'a dek grup düşüyor, çocukları kendi
+bağlacıyla düz listeye katılıyordu ve sahiplik koşulu atlanabiliyordu — zeyrek-backend incident-log #189).
+
+**Okumada VE/VEYA gruplaması serbesttir:** `get`/`count` ucunda `filterType: 'group'` + `children` ile
+`durum = 'açık' AND (sahip = ben OR paylaşılan = true)` kurulur; tek kök kuralı yalnız yazan uçlar içindir.
 
 ### Toplu güncelleme FİLTREYLE kurulmaz
 

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

@@ -129,8 +129,10 @@ açılmaz, yükleme `mobile_asset_create { path: files[i].path }` ile yapılır.
 
 ## Hedefler
 
-`build` (iki platform, yalnız derler) · `testflight` (yalnız iOS) · `internal` (yalnız Android, Play
-iç test). Android paketi `packageType`: `aab` (varsayılan, mağaza) · `apk` (yalnız `build`; telefona doğrudan
+`build` (iki platform, yalnız derler; iOS'ta imzalama kimliği yokken imzasız **simülatör** `.app.zip`'i — uygulamanın
+kendi derlemesini bilgisayarda denemenin yolu; kimlik tamsa imzalı `.ipa` çıkar ve simülatörde açılmaz, yarım kimlik
+`secrets_missing`) · `testflight` (yalnız iOS) · `internal` (yalnız Android, Play iç test). Sayfa değişikliğini telefonda
+ya da kendi Mac'inde görmek için derleme gerekmez: `platform_guide('mobile')` §Cihazda dene → Senin Mac'inde. Android paketi `packageType`: `aab` (varsayılan, mağaza) · `apk` (yalnız `build`; telefona doğrudan
 kurulur, mağazaya **gitmez** — indirme bağlantısı Studio'da). Runner verilmezse backend seçer: kurumun kendi
 Mac'i çevrimiçiyse o, değilse Zeyrek'in runner'ı; yanıtta `runnerKind` (`own` · `zeyrek`). TestFlight'ta runner yükledikten sonra iş `running` + `store_processing` kalır (`awaitingStore`),
 Apple işleyince `completed` (en çok 60 dk); bu durumda iptal 409. İptal 409'unun mesajı nedeni söyler (iş zaten

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

@@ -11,10 +11,10 @@ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `functi
 
 | Adım | Mobilde |
 |---|---|
-| `redirect` | yığına iter (göreli yol) ya da dışarıda açar (tam adres) |
+| `redirect` | yığına iter (göreli yol) ya da dışarıda açar (tam adres); sekme sayfası hedefi sekmeye geçer, bulunulan sekmenin kökü yığını köke indirir (`platform_guide('mobile')` §Gezinme) |
 | `navigate` | eski mobil şemaların adı — `redirect`'in takma adıdır; gateway `redirect`'e çevirir |
 | `alert` | tipli uyarı (`success`/`error`/`info`/`warning`) toast'tur ve beklemez; düz uyarı onay bekler. `message`/`description` metin şablonudur (`"{{ t('kayit.tamam') }}"`; `platform_guide('page')` §alert). Eylem düğmeli bildirim ("Silindi · Geri al") `alert`le kurulmaz: sayfaya bir `toast` bileşeni koyun (`actions: [{ text, flow }]`, gerekirse `keepOpen`), akış setter'la `isOpen: true` yazar; basış eylemin kendi akışını koşar (`actionClick { text, index }`) |
-| `confirm` | `yes` / `no` dalları; `message`/`title`/`confirmText`/`cancelText` metin şablonudur (`{{ }}`, çeviri `t('anahtar')`) |
+| `confirm` | `yes` / `no` dalları; `message`/`title`/`confirmText`/`cancelText` metin şablonudur (`{{ }}`, çeviri `t('anahtar')`). `page_screenshot`'ta pencere `awaiting-user`'dır: `preview-dialog__confirm` → `yes`, `preview-dialog__cancel` → `no` (SCR-023) |
 | `download` | adres cihazın açma sayfasında açılır; ikili gövde (JSON değil) önbelleğe dosya olarak yazılıp paylaşım sayfasında (`expo-sharing`) açılır, Studio mobil önizlemesi dosyayı indirir (`MOB-005`, bilgi) |
 | `storage` | `args.name` `state.page.<key>` / `state.app.<key>` ise o state'i yazar (`platform_guide('mobile')` §Kalıcı state), değilse cihaz deposuna |
 | `setcookie` | güvenli cihaz deposuna (SecureStore) yazar; değer sonraki her istekte `X-Flow-Cookie` başlığıyla gider ve middleware/workflow onu web'deki gibi `cookie.<ad>` olarak okur — `Cookie` başlığıyla gitmez, çünkü iOS onu yerel çerez kavanozuyla virgülle birleştirip bozuyordu (`MOB-005`, bilgi); aynı adlı sunucu çerezi varsa o kazanır. Studio paleti mobilde de sunar |
@@ -26,7 +26,7 @@ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `functi
 | `notification-cancel` | `args.name` kimlikli planlı bildirimi siler (planlamadaki gibi metin şablonu: `'ilac-{{ item.id }}-0800'`), `'*'` hepsini; hep `always` |
 | `permission` | bir cihaz iznine bakar ya da ister. `args.value` izin türü, **düz metin — ifade olamaz** (mağaza derlemesinin taşıyacağı izinler bu değerden, akış koşmadan hesaplanır; `FLOW-038`); `args.name` kip: `check` yalnız okur (sistem penceresi açılmaz), `request` verilmemiş ve hâlâ sorulabilen izni ister (boş → `request`). Sonuç `Steps.<adım>.data = { status, canAskAgain }`: `granted` · `denied` · `undetermined` · `unavailable` (derleme bu izni taşımıyor ya da web önizlemesi); `canAskAgain: false` → yalnız Ayarlar'dan değişir. `tracking` (iOS App Tracking Transparency) sonucu ayrıca `advertisingId` taşır: izin `granted` iken IDFA (iOS) / AAID (Android), değilse `null`; oynatıcı `tracking`'i hiç taşımaz (`unavailable`). Red hata değildir, hep `always`. Türler: `mobile_store_get { detail: ['permissions'] }` (`support: supported` satırlarının `key`'i) |
 | `open-settings` | uygulamanın sistem ayar sayfasını açar; `Steps.<adım>.data.opened`. Argüman almaz |
-| `back` | gezinme yığınında bir geri (iOS geri kaydırmasıyla aynı sonuç; kök ADR 0013). Argüman almaz (yazılan okunmaz), sonuç yazmaz, hata üretmez, hep `always`. Yığının ilk ekranında hiçbir şey yapmaz; Studio önizlemesinde runtime'ın kendi gezinmesi yoksa yine hiçbir şey, web uygulamasında tarayıcının geri'sidir. Formu kaydedip önceki ekrana dönmek için `redirect` yerine bunu kullanın: `redirect` yığına yeni ekran iter, geri kaydırması kaydedilen forma döner. 2026-10-08 öncesi runtime ve backend `back`'i tanımaz |
+| `back` | gezinme yığınında bir geri (iOS geri kaydırmasıyla aynı sonuç; kök ADR 0013). Argüman almaz (yazılan okunmaz), sonuç yazmaz, hata üretmez, hep `always`. Yığının ilk ekranında hiçbir şey yapmaz ve telefonun defterine `back-unavailable` düşer (`mobile_error_list`); oynatıcıda ve mağaza kabuğunda aynı çalışır (eski mağaza kabuğu sürümlerinde boştu). Studio önizlemesinde runtime'ın kendi gezinmesi yoksa yine hiçbir şey, web uygulamasında tarayıcının geri'sidir. Sekme sayfasına dönmek için `redirect` de olur: hedef sekme sayfasıysa sekmeye geçer, bulunulan sekmenin köküyse yığın köke iner (kopya itmez). Formu kaydedip önceki ekrana dönmek için `redirect` yerine bunu kullanın: `redirect` yığına yeni ekran iter, geri kaydırması kaydedilen forma döner. 2026-10-08 öncesi runtime ve backend `back`'i tanımaz |
 | `ad-show` | tam ekran reklam (kök ADR 0012). `args.value` mağaza ayarındaki yerleşimin **adı**, düz metin (`FLOW-039`); biçimi `interstitial` · `rewarded` · `rewardedInterstitial` olmalı. Reklam yüklenip gösterilir, kullanıcı kapatınca `Steps.<adım>.data = { shown: true, reward }` ile sürer — `reward` ödüllü reklamı sonuna kadar izleyende `{ type, amount }`, değilse `null` (ödül ayrı dal değil, `condition` ile okunur). 10 sn'de reklam yoksa, SDK hata verirse, derleme reklam taşımıyorsa ya da rıza yoksa `error.status: 'unavailable'`; tanımsız ya da banner yerleşimi `invalid`: `error` dalı → hata akışı → `always`. Oynatıcı ve web önizlemesi her zaman `unavailable` — reklamsız dalı orada sınayın. Paletten yalnız mobilde |
 | `biometric-auth` | kullanıcıyı Face ID / parmak izi (yedekle cihaz parolası) ile doğrular (kök ADR 0021). `args.title` sistem penceresindeki gerekçe, `args.cancelText` vazgeç düğmesi — ikisi metin şablonu, boşsa uygulama dilindeki varsayılan; `args.value` yedek, düz metin: `device` (biyometri olmazsa cihaz parolası; boşsa bu) ya da `none` (`FLOW-042`; `fallback` / `reason` / `cancelLabel` anahtarı sessizce düşer). Başarı: `Steps.<adım>.data = { verified: true }` → `always`. **Vazgeçmek hatadır**: `error.status` `cancelled` · `not-enrolled` · `lockout` · `failed` · `unavailable` (donanım yok ya da derleme taşımıyor) · `unsupported` (web uygulaması, production `/view`) · `invalid`; `error` dalı → hata akışı → **o da yoksa akış bu adımda biter**, `always`'e bağlı adım koşmaz. Yerel bir kapıdır, sunucu için kanıt değildir. Paletten yalnız mobilde |
 | `scan-code` | tam ekran kod tarayıcı (kök ADR 0017): tek kod okur ve kapanır. `args.value` izinli türler, **virgüllü düz metin** (`FLOW-042`): `aztec` · `codabar` · `code39` · `code93` · `code128` · `datamatrix` · `ean8` · `ean13` · `itf14` · `pdf417` · `qr` · `upc_e`; boş → hepsi. `upc_a` yok: UPC-A etiketi `ean13` ve on üç haneyle (başında `0`) döner. `args.title` ekrandaki yönerge, metin şablonu (`{{ t('anahtar') }}`). Sonuç `Steps.<adım>.data`: `{ value, type, source }` — `source` `camera` ya da `manual` (ekrandaki "elle gir"; tür bilinmiyorsa `type: null`). `error` dalı: `status` `cancelled` (kullanıcı kapattı — **vazgeçme bir hatadır, `error` dalını bağla**) · `denied` (kamera izni yok) · `unavailable` (derleme kamerayı taşımıyor ya da tarayıcı zaten açık) · `unsupported` (web uygulaması) · `invalid`. Kamera izni kendiliğinden derlemeye girer (adım production'daysa). Önizleme (`/dev`, `page_screenshot`) kamera açmaz, "kod gir" penceresi çizer: `__scan-value`'ya yaz, `__scan-confirm` ya da `__scan-cancel` (çok türde `__scan-type-<tür>`). `page_screenshot` pencereyi yalnız `captureUnready: true` ile sürer (akış pencereyi beklerken "koşuyor" sayılır; her eylem 15 sn bekler). Tam gövde: `ngapps://examples/mobile-scan-code` |
@@ -34,6 +34,43 @@ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `functi
 | `restore-purchases` | mağaza hesabındaki satın almaları geri getirir (telefon değişti, uygulama yeniden kuruldu); argümansız. Başarı `Steps.<adım>.data = { entitlements }` — geri gelecek bir şey yoksa da başarıdır, sonucu hakka bakarak söyleyin. Hata sözlüğü `purchase`'la aynı ve o da kapıdır. Satın alma ekranında bir "Satın almaları geri yükle" düğmesi beklenir (`MOB-034`); yalnız tüketilen ürün satan ekranda beklenmez, tüketilen ürün geri yüklenmez |
 | `balance-spend` | tüketilen ürünün bakiyesinden harcar (kredi, jeton; kök ADR 0027 bakiye bölümü). `args.value` bakiyenin **adı**, `args.title` **miktar** — ikisi de metin şablonu: düz `kredi` / `10` ya da `{{ adet.value }}` (`FLOW-046`: boş değer 422; katalogda tüketilen ürünün `balance`'ı olmayan düz ad yazılmaz; `{{ }}` dışındaki ifade harfi harfine metin sayılır; `balance`/`amount` anahtarı sessizce düşer). Harcama sunucuda atomiktir (aynı sahibin eşzamanlı harcaması sıralanır, bakiye aşılamaz). Başarı `Steps.<adım>.data = { balances }` → `always`; `Balances` kendiliğinden güncellenir, ayrıca okumayın. **Kapıdır**: `error.status` `insufficient` (bakiye yetmiyor — negatif bakiye de bu) · `unavailable` (çevrimdışı ya da sunucuya ulaşılamadı; çevrimdışı yazma kuyruğuna GİRMEZ) · `unsupported` (web uygulaması, production `/view`, kabuk satın almayı taşımıyor) · `invalid` (ad ya da miktar geçersiz; miktar 1 ve üstü tam sayı) · `failed`; `error` dalı → hata akışı → **o da yoksa akış bu adımda biter**. Başarılı her tıklama ayrı harcamadır; sonucu belirsiz kalan (`unavailable`) harcamanın anahtarı cihazda durur, aynı bakiye ve miktarla yeniden dokunuş iki kez düşmez. Anahtarı akışın verdiği harcama workflow `balance` adımındadır. Paletten yalnız mobilde |
 
+## Sayfa kapanınca
+
+Sayfa söküldüğünde (geri, yığının köke inmesi, çıkış — sekme değişimi sayfayı sökmez) açık akış yarıda kalmaz (kök ADR 0030): yeni koşum başlamaz, açık
+koşumlar telefona yazan adımlarla sonuna kadar sürer. 30 sn'de bitmeyen koşum kapatılır.
+
+| Adımlar | Sayfa kapalıyken |
+|---|---|
+| `microservice`, `storage`, `setcookie`, `code`, `function`, `condition`, `validation`, `query`, `flow-trigger`, `bpm`, `notification-schedule`, `notification-cancel`, `haptic`, `balance-spend` | koşar |
+| `setter`, `alert`, `confirm`, `navigate`, `redirect`, `back`, `share`, `download` | atlanır; akış `always`'tan (`confirm`'de `no`) sürer |
+| `scan-code`, `location`, `permission`, `notification-permission`, `open-settings`, `ad-show`, `purchase`, `restore-purchases` | `error.status: 'page-unmounted'` ile hata yolu |
+| `biometric-auth` | hata yolu; hata yolu yoksa akış biter (kapı doğrulamasız açılmaz) |
+
+Atlanan her adım telefonun defterine `page-unmounted` kaydı düşer (`mobile_error_list`). `state.*` yazımı `storage` ya da
+`code` adımıyla yapılır — `setter` atlanır. "İsteği göndermeden önce ekranı değiştir", "önce yaz sonra çık" gibi geçici
+çözümler gerekmez. Studio mobil önizlemesi ve `/view` de sayfa geçişinde boşaltır; "Dene"nin yeniden başlatması ve
+önizlemenin kapanması akışı keser. Web (Svelte) uygulaması akışı sayfayla birlikte keser.
+
+## Önizlemede çekim hedefleri
+
+Bileşenin iç kontrolü `<elementId>__<rol>` ile hedeflenir; rol görünen metinden değil kayıttaki anahtardan türer.
+Mobil roller `component_get` çıktısının mobil notlarındadır (`internalRoles` ve bulunamayan hedefin notu yalnız web
+rollerini sayar):
+
+| Kimlik | Ne |
+|---|---|
+| `<id>__press` | tek basışlı denetimin basış yüzeyi (kök kendisi basılabilir değilse `click` buna basar) |
+| `<id>__row-<i>`, `<id>__row-<i>__handle` | liste satırı, sürükleme tutamacı (`swipe` hedefi) |
+| `<id>__chip-<değer>` | çip seçeneği; tablonun filtre çipi `__chip-<kolon>` |
+| `<id>__tab-<anahtar>` | `tabs` bileşeninin sekmesi (`tab` eylemi) |
+| `<id>__day-<yyyy-MM-dd>`, `<id>__prev`, `<id>__next` | `calendar`/`datepicker` günü ve ay oku (`click`) |
+| `__tabs`, `__tabs__item-<sayfa slug'ı>` | kabuğun sekme çubuğu ve öğesi |
+| `preview-dialog__confirm`, `preview-dialog__cancel` | `confirm`/`alert` penceresi (SCR-023) |
+| `preview-biometric__verify`, `preview-biometric__cancel` | `biometric-auth` penceresi (SCR-018) |
+| `__scan-value`, `__scan-type-<tür>`, `__scan-confirm`, `__scan-cancel` | `scan-code` "kod gir" penceresi (SCR-019; önek yok) |
+
+Pencere açıkken altındaki sayfa öğesine `click` uygulanmaz (SCR-023).
+
 ## Bildirim tarifi
 
 Bildirim adımları paletten yalnız mobil uygulamada sunulur. Tarif — S04 "her gün hatırlat": önce

package/dist/resources/guides/mobile.md

@@ -17,7 +17,8 @@ anlamları ayrı.
 1. **Uygulama ve kabuk.** Tek çağrıda: `mobile_app_create` (uygulama + sayfalar + kabuk layout'u +
    sekme ayarı + ana sayfa bağı, `dryRun` ile önce planı görün). Tekil araçlarla aynı sıra:
    `application_create({ type: 'mobile' })` → `page_create` × N → `layout_create` (kabuk) →
-   `page_update({ layoutId })` × N → `application_update({ homepageId, properties.mobile.tabs })`.
+   `page_update({ layoutId })` × N → `application_update({ homepageId, properties.mobile.tabs })` (ayar yalnız
+   development'a yazılır, production'a dağıtımla geçer — APP-001).
    Sekme ayarı sayfa **id**'si ister; bu yüzden sayfalardan SONRA yazılır.
 2. **Veri.** Entity, microservice ve workflow web'dekiyle aynıdır (`platform_guide('microservice')`).
    Sayfa akışı `microservice` adımıyla aynı uçları çağırır. Veri bağlamanın telefon
@@ -368,7 +369,8 @@ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tip
 
 ## Gezinme
 
-- **Yığın varsayılandır; ayar yoktur.** `redirect` adımı hedef sayfayı yığına iter, geri hareketi
+- **Yığın varsayılandır; ayar yoktur.** `redirect` adımı hedef sayfayı yığına iter (sekme sayfası hedefi sekmeye
+  geçer, aşağıda), geri hareketi
   (cihaz, app-bar ya da tarayıcı geri) önceki ekrana döner. Göreli yol uygulama
   köküne eklenir; tam adres (`https://…`) dışarıda açılır.
 - **Sekmeler uygulama ayarıdır, layout'ta değil.** `application_update({ properties: { mobile: { tabs } } })`:
@@ -398,6 +400,13 @@ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tip
   gizlenir; alan yoksa görünür). `true`/`false`'tan başka değer (ör. metin `"false"`) yok sayılır ve `MOB-007` uyarır.
   İkinci dokunuş (`reselect`) ile sekme değişimi (`keepStackOnSwitch`) ayrı ayardır; eski runtime anahtarları bilmez ve
   varsayılan davranışta kalır.
+- **Sekme sayfasına `redirect` sekmeye geçer, kopya itmez.** Hedef (`pageId` ya da sayfanın yolu) bir sekme sayfasıysa
+  o sekmeye geçilir; bulunulan sekmenin kök sayfasıysa o sekmenin yığını köke iner — "kaydet → listeye dön" böyle
+  yazılır. Başka sayfa bulunulan sekmenin yığınına itilir.
+- **`back` adımı iki kabukta da yığında bir geri gider.** Gidemezse (yığının ilk ekranı) hiçbir şey yapmaz, akış yine
+  `always`'tan sürer ve telefonun defterine `back-unavailable` düşer (`mobile_error_list`; kök ADR 0013).
+- **Sayfadan çıkılınca açık akış yarıda kalmaz**: telefona yazan adımlar sonuna kadar koşar, ekrana dokunanlar atlanır
+  (`platform_guide('mobile-steps')` §Sayfa kapanınca).
 - **Çekmece bir bileşendir.** `drawer` widget'ı + `app-bar`'ın `menuTarget` prop'u çekmeceyi açar.
   Çekmece layout'un kök dizisindedir (`views: [shell_root, nav_drawer]`), kabuk kabının içinde değil.
 - Kabuk örnekleri: `ngapps://examples/mobile-app-shell-stack` (yığın), `ngapps://examples/mobile-app-shell-tab`
@@ -473,10 +482,11 @@ Sunucudan gönderilen bildirim yerel `notification-schedule`'dan ayrıdır. Kana
 
 ## Kalıcı state
 
-State varsayılan olarak **bellektedir**: sayfa her açıldığında `variable_create`'te yazılan `value`'dan
-başlar, akışın yazdığı değer ekran kapanınca kaybolur — `state.app` dahil: sayfalar arası
-taşımak da `storage` ister (38 S-5). Uygulama kapanıp açıldığında kaldığı yerden
-sürmesi gereken değer için değişkene saklama türü verin:
+State varsayılan olarak **bellektedir**: `state.page` sayfa her açıldığında `variable_create`'teki `value`'dan başlar,
+ekran kapanınca kaybolur. **Mobil kabukta `state.app` uygulama + ortam başına tek depodur** (kök ADR 0031): bir
+sayfanın yazdığı arkadaki sayfada da anında görünür; açılan sayfanın `value`'su yalnız depoda olmayan anahtarı
+doldurur. Depo süreç ömrü kadar yaşar ve çıkışta silinir. Studio önizlemesi ve web her sayfaya kendi kopyasını verir (38 S-5).
+Uygulama kapanıp açıldığında kaldığı yerden sürmesi gereken değer için değişkene saklama türü verin:
 
 | `storage` | Depo | Ne için |
 |---|---|---|
@@ -496,8 +506,8 @@ variable_create({ applicationId, pageId, variables: [
   **ilk açılış** değeridir. Saklı değerin biçimi sonradan değiştirdiğiniz `value` ile uyuşmuyorsa saklı
   olan kazanır; sıfırlamak için anahtarı yeniden adlandırın.
 - `pageId` verilmeden tanımlanan değişken (`state.app`) uygulama kapsamındadır: her sayfa açılışta aynı
-  saklı değeri okur. Açık iki sekme birbirinin yazdığını canlı görmez — değer sayfa açılırken okunur.
-- Çıkışta (kullanıcının çıkışı ya da oturumun düşmesi) iki depodaki state değerleri silinir.
+  saklı değeri okur. Mobil kabukta açık sayfalar birbirinin yazdığını canlı görür; web'de değer sayfa açılırken okunur.
+- Çıkışta (kullanıcının çıkışı ya da oturumun düşmesi) iki depodaki state değerleri ve bellekteki `state.app` silinir.
 - Ortamlar ayrıdır: `development`'ta saklanan değer `production`'da okunmaz.
 - `variable_update` `storage` vermezse kayıttaki tür korunur; belleğe çevirmek için `storage: 'memory'`.
   `value` vermezseniz kayıttaki değer de korunur — yalnız türü değiştirmek için `{ key, storage }` yeter.
@@ -524,6 +534,20 @@ variable_create({ applicationId, pageId, variables: [
 - `flowRuns: 0` + `requests: 0` bir tıklamada akışın koşmadığını söyler: olay bağını
   `page_runtime_get`, akışı `flow_get` ile doğrulayın.
 - Kuru doğrulama: `page_schema_validate` mobil kataloğa karşı doğrular (`MOB-003`).
+- **Telefonda düşen hata** `mobile_error_list({ applicationId })` ile okunur (NTF-006): kabuk akış hatalarını sunucuya
+  gönderir, uçak kipindekiler ağ dönünce gelir. `page-unmounted` (sayfa kapanınca atlanan adım) ve
+  `back-unavailable` (geri gidilemedi) kayıtları da buradadır; önizlemede `page_screenshot` `runtimeErrors`'ta görünür.
+- **Önizlemede ağsızlık yalnız hata yolunu sınar** (SCR-020…022): `{ action: 'network', value: 'offline' }` ağı keser,
+  `'online'` açar (`actionsReport.online`). Önizlemede önbellek ve yazma kuyruğu YOKTUR: okuma da yazma da `error`
+  dalından gider (`queued`, `offlineQueueChange` koşmaz, `error.network` yazılmaz). Kuyruklu senaryo (kaydet → listede
+  bekleyen → eşitleme) yalnız cihazda (uçak kipi). İki çağrıya yayılan senaryo `session` ile kurulur — çerez,
+  localStorage (`storage: 'device'` state) ve IndexedDB taşınır; `secure` (sessionStorage) ve ağ taşınmaz. Klavye açıkken
+  yazılan hâl için `set` + `blur: false` (`changed` koşmaz). Önizleme her çağrıda tek sayfa açar.
+- **Onaylı akış sürülür** (SCR-023): `confirm`/`alert` adımı önizlemede pencere açar; onu açan `click`'in raporu
+  `pageState: 'awaiting-user'` der, sonraki eylem `{ action: 'click', target: 'preview-dialog__confirm' }` (onay dalı)
+  ya da `'preview-dialog__cancel'` (red dalı; uyarıda yok). Geçici onaysız sürüm yazmaya gerek yoktur.
+- **Çekim hedef kimlikleri** (`__press`, `__row-<i>`, `__chip-<değer>`, `__tab-<anahtar>`, önizleme pencereleri) tek
+  tabloda: `platform_guide('mobile-steps')` §Önizlemede çekim hedefleri.
 - Kare **donuktur**: bağlam "hareketi azalt" ile açılır, bileşen hareketi (giriş, döngü, geçiş, iskelet parıltısı,
   kabuğun yükleme göstergesi) durur, aynı sayfanın iki karesi aynı çıkar. Hareketin kendisini görmek için
   `motion: 'play'` (kare çekildiği ana bağlıdır; yanıt `motionNote` taşır).
@@ -547,6 +571,8 @@ Mobile App Store'dan ya da Google Play'den yüklenir (pencere mağaza bağlantı
 çıkan kod okutulur (120 sn geçerli). **Senin Mac'inde:** kullanıcı kendi Mac'ini bir kez ekler, simülatör o Mac'te
 açılır; Mac'i olmayan için Zeyrek'in Mac'inde açma henüz yoktur. **Kaydettiğinde güncellenir:** yazdığın yama
 telefonda ve simülatörde yenilenir. Ajan kod üretmez, önizleme başlatmaz; kullanıcıyı bu pencereye yönlendirir.
+Uygulamanın kendi derlemesi ayrı yoldur: iOS `target: 'build'` imzalama kimliği yokken simülatör `.app`'i,
+kimlik tamsa simülatörde açılmayan `.ipa` üretir (`platform_guide('mobile-publish')` §Hedefler).
 
 ## Yayın
 
@@ -568,5 +594,9 @@ yaptıkları. Derlenen uygulama
 - 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.
+  Yalnız GET okuma saklanır (POST okuma ağsız açılmaz → GET + query-string, FLOW-044); kuyruk değişimi sayfanın
+  `offlineQueueChange` olayıdır, yoklama gerekmez (§Kural 1g-4).
+  Ayar (`properties`, ana sayfa, bulunamadı sayfası) `application_update` ile yalnız **development**'a yazılır; production'da
+  `deployment_start`'tan sonra geçerli olur (APP-001) — önce development'ta deneyin.
   "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

@@ -1537,7 +1537,9 @@ Kayıtlar kullanıcıya, ortama ve veri diline bağlıdır; çıkışta ve kulla
   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
+  `Steps.<ad>.queued = { clientRequestId, at }`. Barındırıcı ağın olmadığını biliyorsa (`Device.isOnline === false`)
+  bu koşullardaki istek hiç denenmez, doğrudan kuyruğa girer (kök ADR 0029) — uçak kipinde `queued` beklemeden koşar;
+  durum bilinmiyorsa istek denenir. 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
@@ -1554,8 +1556,14 @@ Kayıtlar kullanıcıya, ortama ve veri diline bağlıdır; çıkışta ve kulla
 - **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.
+- **Kuyruk değişince ekran tazelenir:** mobil sayfanın `offlineQueueChange` olayı (`page.events`, `mount`/`destroy`/`focus`
+  yanında; Studio'da "Çevrimdışı kuyruk değiştiğinde") kayıt girdiğinde, gönderildiğinde, reddedildiğinde ve silindiğinde koşar.
+  Yük taşımaz: güncel sayaç olaydan hemen önce yazılan `Device.offline`'dadır. İlk okuma olay üretmez; olaya bağlı akış
+  koşarken kuyruğun değişmesi olayı yeniden tetiklemez (kuyruğa yazan akış döngüye girmez). Listeyi bekleyenlerle
+  yeniden kuran yükleme akışını bu olaya da bağlayın — yoklama (`setInterval`, birkaç saniyede bir okuma) gerekmez.
+- **Önizleme:** Studio ve web'de kuyruk yoktur, `queued` ve `offlineQueueChange` hiç koşmaz. `page_screenshot`
+  `{ action: 'network', value: 'offline' }` ile ağı keser (SCR-020) ama önbellek ve kuyruk olmadığı için okuma da yazma
+  da hata yolundan gider. 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ı).
 
@@ -1577,8 +1585,8 @@ Kayıtlar kullanıcıya, ortama ve veri diline bağlıdır; çıkışta ve kulla
   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
+okuma ağdan gider, `cache` ve `cachedAt` hiç yazılmaz. `page_screenshot`'ın `network` eylemi ağı keser ama önbellek
+olmadığından okuma hata yolundan döner; önbellekli ve kuyruklu 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
@@ -1602,7 +1610,11 @@ AYNI; veri bağlantı gelince Zeyrek'e kendiliğinden gider. Altı adım birlikt
    `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`).
+   yokluğu hata metni göstermez (`Steps.<ad>.error && !Steps.<ad>.error.network`). Aynı akış sayfanın
+   `offlineQueueChange` olayına da bağlanır: kuyruğa giren kayıt listeye hemen, gönderilen kayıt sunucudan gelir.
+   Kaydı yazan sayfadan çıkılsa da yazma akışı tamamlanır (kök ADR 0030) ve `state.app` mobil kabukta sayfalar arası
+   ortaktır (kök ADR 0031): "istekten önce yaz", "kuyruktan oku" ve "birkaç saniyede bir yokla" geçici çözümleri
+   gerekmez (Defter saha raporu, 2026-10-30).
 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).
@@ -1613,8 +1625,9 @@ AYNI; veri bağlantı gelince Zeyrek'e kendiliğinden gider. Altı adım birlikt
    `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
+Fark yalnız iki yerde kalır: giriş (ağ ister) ve hiç açılmamış ekran (cihazda kopyası yok). Yükleme akışı sayfanın
+`offlineQueueChange` olayına bağlıysa (4. adım) bağlantı dönünce gönderilen kayıt listeden düşmez: gönderim kuyruğu
+değiştirir, akış yeniden koşar ve kayıt sunucudan gelir (kök ADR 0029). Bağ yoksa kayıt liste aşağı çekilene kadar görünmez. Ö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`.
 
@@ -2035,6 +2048,24 @@ page_schema_patch(ops:[{ op:'set_event', target:'button_1', event:'click', event
 
 `flow_create`'e `flowId` verirsen id'yi önceden bilir, iki adımı tek planda kurabilirsin.
 
+### Uzun `code` gövdesi ayrı dosyada: `bodyFile` + `$file`
+
+Kodu JSON dizgisine kaçışlayarak yazma — bir ters tırnak ya da tırnak hatası adımı bozar. Adımları
+`bodyFile` ile ver; kod alanına `{ "$file": "<yol>" }` yaz, gateway o dosyanın **metnini** oraya koyar
+(kod çalıştırılmaz, satır sonu korunur, sonuç satır içi gövdeyle aynı doğrulamadan geçer):
+
+```jsonc
+// ./akislar/kaydet.steps.json  →  flow_create(host:'page', hostId, name, slug, bodyFile:'./akislar/kaydet.steps.json')
+[ { "stepId": "yaz", "name": "yaz", "type": "code", "kind": "normal",
+    "args": { "value": { "$file": "./kaydet.js" } },
+    "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }] } ]
+```
+
+`./kaydet.js` düz JS'dir. Yol bodyFile'ın klasörüne göre çözülür; göreli `bodyFile` `MCP_INPUT_DIR`'e
+(yoksa gateway'in çalışma dizinine) göre. Sınırlar: `.js .mjs .ts .txt .sql .html .css`, UTF-8, dosya
+başına 1 MB, toplam 5 MB, en çok 64 ekleme; eklenen dosyanın içindeki `$file` işlenmez. Yanıtın
+`bodyFile.included` alanı neyin nereye konduğunu söyler.
+
 ### Sayfada bağlı akış varken YENİ akış eklenemez — ve çözümü
 
 Bir sayfanın herhangi bir olayı zaten bir akışa bağlıysa, o sayfaya ikinci bir `flow_create`

package/dist/resources/guides/translation.md

@@ -137,6 +137,7 @@ tek dilli uygulamada da geçerlidir: yazı düzeltilince aynı kırılma olur. *
 | `colorMap: [{ value: 'Aktif', color: 'success' }]` | `value` kod, görünen yazı `label`'da (çeviri sarmalı olabilir) |
 | `currentItem.title === 'Dokümanlar'` (breadcrumb tıklaması) | Öğeye ek alan: `{ key: 'klasor', title }` → `currentItem.key === 'klasor'` |
 | Sekmeyi ya da hata satırını yazısıyla tanımak | Sekme `key`'i / kimliği (`<tabs>__tab-<key>`), bağlamdaki kod |
+| Yer tutucu metni kaydedip ona bakmak: `title === 'Başlıksız not'` (boş başlıklı notu ayırmak) | Ham alanı boş bırak, karar ham değerde: `!note.title`; gösterim ifadede `{{ note.title \|\| t('note.untitled') }}`. Yer tutucuyu kayda yazmak hem dili kayda gömer hem kararı metne bağlar |
 
 Gateway akış, sayfa, layout ve widget yazımında denetler (`flow_*`, `page_schema_patch` / `_validate`, `page_create`,
 `page_update`, `layout_*`, `component_schema_patch`, `component_create` / `_update`):
@@ -153,7 +154,8 @@ Gateway akış, sayfa, layout ve widget yazımında denetler (`flow_*`, `page_sc
 - **TR-006 (warn):** tek kelimelik metin (`'Aktif'`, `'Evet'`, `'Anasayfa'`) biçimden koddan ayrılmaz; projenin varsayılan
   dilindeki sözlük değeriyle ya da sayfanın yazısıyla aynıysa uyarır. Bir kod değeriyse yok sayın.
 - Kaçış: sunucu yalnız metin döndürüyor ve karşılaştırılacak kod yoksa aynı çağrıya `policyOverride: true` — bulgu
-  yanıtta uyarı olarak kalır. Kalıcı çözüm sunucudan kod istemektir (`platform_gap_report`).
+  yanıtta uyarı olarak kalır. Kalıcı çözüm sunucudan kod istemektir (`platform_gap_report`). Karar kendi verinizdeyse
+  (yer tutucu, durum adı) kaçış yerine tablodaki doğru şekle çevirin: kaçış yalnız denetimi susturur, kırılma sürer.
 
 Denetim sözdizimseldir: kodun içindeki karşılaştırmayı arar, etiket ve mesaj gibi düz metni kanca saymaz. Sunucu tarafı
 (workflow, microservice, Studio fonksiyonu) denetlenmez — orada da aynı kural geçerlidir.

package/dist/resources/schema-fingerprint.json

@@ -1,6 +1,6 @@
 {
-  "hash": "b073fadf0690bedd0b74c8c0610e0b843cd7487f3e2c7e9e27361443c52c06be",
-  "generatedAt": "2026-11-01T20:55:00.329Z",
+  "hash": "162e8c2d14c5a0737d023b55790bab139812a00ec8e2e6335ed51981bb27e548",
+  "generatedAt": "2026-11-02T08:52:07.624Z",
   "types": 377,
   "files": 196,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",

package/dist/tools/applications.js

@@ -113,7 +113,7 @@ export function registerApplicationTools(server, platform) {
     }));
     server.registerTool('application_update', {
         title: 'Application güncelle',
-        description: `Application bilgilerini günceller; homepageId zorunludur (mevcut değeri application_get ile alın). ${templateSubscriptionLock}`,
+        description: `Application bilgilerini günceller; homepageId zorunludur (mevcut değeri application_get ile alın). ORTAM (K5, b-15): ayar alanları — properties (mobile.offline, sekmeler, geçiş…), homepageId, notFoundPageId — yalnız development'a yazılır; production onları deployment_start ile alır (dal ortamları açıldıkları andaki kopyayı tutar), yani ayarı önce development'ta deneyin. Kimlik alanları (name, slug, color, dns) bütün ortamlara hemen gider. Yanıttaki environmentNote bunu çağrı başına söyler. ${templateSubscriptionLock}`,
         inputSchema: {
             id: guid,
             slug: z.string().min(1),
@@ -132,7 +132,12 @@ export function registerApplicationTools(server, platform) {
             : [];
         const response = await platform.org('PUT', `/applications/${id}`, { body });
         forgetApplication(platform, id);
-        return withPlatformWarnings(response, warnings);
+        // Uç tam kaydı yazar: verilmeyen properties/notFoundPageId development'ta da boşalır (APP-001, inceleme #4).
+        const missing = ['properties', 'notFoundPageId'].filter((field) => body[field] === undefined);
+        return {
+            ...withPlatformWarnings(response, warnings),
+            environmentNote: `properties, homepageId ve notFoundPageId verildiği gibi yalnız development'a (ve Core'a) yazıldı; production onları deployment_start ile alır, dal ortamları hiç almaz (APP-001). name/slug/color/dns bütün ortamlara gitti.${missing.length > 0 ? ` ${missing.join(' ve ')} verilmedi: uç tam kaydı yazar, development'taki değer boşaltıldı — korumak için application_get'teki mevcut değeri gönderin.` : ''}`
+        };
     }));
     server.registerTool('application_delete', {
         title: 'Application sil',

package/dist/tools/deployments.js

@@ -51,7 +51,7 @@ export function registerDeploymentTools(server, platform) {
     }));
     server.registerTool('deployment_status', {
         title: 'Deployment durumu',
-        description: "Projenin son deployment durumunu döner. 'projectId' ZORUNLUDUR (project_list/project_get'ten alın) — verilmezse çağrı MCP şema katmanında reddedilir, platforma hiç gitmez. Hiç deployment yapılmamış projede yanıt BOŞ gelir; o durumda tool 'hiç deployment kaydı yok' bilgisini açıkça döner, yani boş yanıtı 'tool çalışmadı' diye okumayın. Durum satırı modül başına ayrılmaz: süreç tanımları ve iş takvimleri sayfa ve workflow'lardan sonra aynı saga adımında aktarılır; hedefte çalışamayan (eksik workflow/entity/rol) tanım aktarımı DefinitionInvalid ile düşürür. type 'error' ise 'error' alanı düşüş nedenini taşır (DefinitionInvalid'de bulgular 'yol: mesaj | …' olarak eklenir); aktarım atomiktir, hedef değişmemiştir. type 'completed-with-mismatch': deploy tamamlandı, kayıtlar production'a yazıldı, ama ardından koşan özet denetimi production'da fark buldu; sonraki deploy otomatik tam (full) koşar. Yanıt mode (full | delta: deploy'un gerçekte koştuğu kip) ve counters (delta'da modül başına added/updated/deleted) taşır.",
+        description: "Projenin son deployment durumunu döner. Bittikten sonra iki ortamın tanım farkını environment_diff verir (özetten; tablo satırları hariç). 'projectId' ZORUNLUDUR (project_list/project_get'ten alın) — verilmezse çağrı MCP şema katmanında reddedilir, platforma hiç gitmez. Hiç deployment yapılmamış projede yanıt BOŞ gelir; o durumda tool 'hiç deployment kaydı yok' bilgisini açıkça döner, yani boş yanıtı 'tool çalışmadı' diye okumayın. Durum satırı modül başına ayrılmaz: süreç tanımları ve iş takvimleri sayfa ve workflow'lardan sonra aynı saga adımında aktarılır; hedefte çalışamayan (eksik workflow/entity/rol) tanım aktarımı DefinitionInvalid ile düşürür. type 'error' ise 'error' alanı düşüş nedenini taşır (DefinitionInvalid'de bulgular 'yol: mesaj | …' olarak eklenir); aktarım atomiktir, hedef değişmemiştir. type 'completed-with-mismatch': deploy tamamlandı, kayıtlar production'a yazıldı, ama ardından koşan özet denetimi production'da fark buldu; sonraki deploy otomatik tam (full) koşar. Yanıt mode (full | delta: deploy'un gerçekte koştuğu kip) ve counters (delta'da modül başına added/updated/deleted) taşır.",
         inputSchema: { projectId: guid },
         annotations: readOnly
     }, handle(config, async ({ projectId }) => {

package/dist/tools/designSchemaPatch.js

@@ -2,7 +2,7 @@ import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEvent
 import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, removeNodeFromTree, planEventRemovals, callerSlots, planEmulatedOps, recordsWithEventRemovals, serverOpsInOrder, assertOpBodies, applySkeletonOps, reshapesSkeleton } from './schemaOps.js';
 import { guid, projectParam, environmentParam, updates, microOps } from './common.js';
 import { fetchHost, hostPath } from './screens.js';
-import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
+import { assertScreenWriteGuards, screenCatalogNotes, unknownPropOps } from './screenWrite.js';
 import { emptyWriteDiff, schemaOpDrops, withWriteDiff } from '../platform/writeDiff.js';
 import { fetchComponentEventNames } from './components.js';
 import { boxSectionNote, collectIds, ensureBoxSections, expandSectionToggles } from '../knowledge/boxSections.js';
@@ -10,7 +10,7 @@ import { PlatformApiError } from '../platform/errors.js';
 import { connectDataOpIssues, connectedPropKeys } from '../knowledge/connectDataDefinition.js';
 import { handle } from '../platform/responses.js';
 import { slotWarning } from './layouts.js';
-import { batchEnvelopeNote, openBatchEnvelopes } from '../knowledge/platform/batchOps.js';
+import { batchEnvelopeNote, batchIndexHint, openBatchEnvelopes } from '../knowledge/platform/batchOps.js';
 import { applicationTypeField, resolveProfile } from '../knowledge/platform/resolve.js';
 import { boundFlowSteps, layoutPatchWarnings, screenProfileWarnings } from './profileWrite.js';
 import { enforceTextHooks, textHookOverrideParam } from './textHookGuard.js';
@@ -87,6 +87,11 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         const events = host === 'layout' ? record.events : undefined;
         const normalized = normalizeSchemaOps(opRecords);
         assertOpBodies(opRecords, propTypeOps);
+        // g-21: tanınmayan prop sayfa yamasındaki gibi istek gitmeden op'uyla adlandırılır; yama bütün reddedilir.
+        const unknownProps = await unknownPropOps(platform, project, environment, applicationId, async () => nodes, allOps);
+        if (unknownProps.length > 0) {
+            throw new PlatformApiError(`${spec.tool}: tanınmayan prop (unknown-prop) — yama atomik olduğu için HİÇBİR op gönderilmedi (istek gönderilmedi): ${unknownProps.map(issue => issue.message).join(' | ')}${batchIndexHint(opened)}`, 400);
+        }
         // TR-005 / TR-006: yamanın yükü op'ların EZDİĞİ kayıtlı değerle karşılaştırılır — orada zaten duran kanca eskidir.
         const textFindings = await enforceTextHooks(config, {
             platform, project, environment, applicationId,

package/dist/tools/environments.js

@@ -18,6 +18,46 @@ export function registerEnvironmentTools(server, platform) {
         inputSchema: { projectId: guid },
         annotations: readOnly
     }, handle(config, ({ projectId }) => platform.org('GET', `/environments/${projectId}`)));
+    server.registerTool('environment_diff', {
+        title: 'İki ortamın tanım farkı',
+        description: "İki ortamın (varsayılan development → production) TANIMLARINI karşılaştırır ve farklı olanları modül modül listeler: fark türü onlyInSource (yalnız kaynakta, dağıtılmamış) · onlyInTarget (yalnız hedefte) · changed (içerik farklı). Dağıtımdan sonra (deployment_status bitti dedikten sonra) 'production development'la aynı mı' sorusunun tek çağrılık cevabıdır. Fark tanım özetinden (definition digest) gelir, gövdeden değil: sırasız diziler ve çoğu üretilmiş alt kimlik karşılaştırmaya girmez — AMA akış adım parametrelerinin kimlikleri girer: development'ta yeniden yazılan (flow_update) bir akış içeriği aynı olsa da changed görünebilir; dağıtım kimlikleri koruduğu için dağıtımdan hemen sonraki karşılaştırma bundan etkilenmez. Kapsamı özetlenen modüllerdir (uygulama, rol, sorgu, DTO, görünüm, workflow, servis, klasör, layout, sayfa, akış, değişken, fonksiyon, mikrofonksiyon, çeviri); tablolar, bileşenler, erişim politikaları, süreçler, dosyalar ve asistan KAPSANMAZ — yanıtın notCovered alanı bu modülleri sayar, 'eşit' cevabı onlar için değildir. Tablo SATIRLARI (recordTransferMode) karşılaştırılmaz. En çok 50 kayıt satırı döner; fazlası truncated: true. Salt okunur; hiçbir ortama yazmaz.",
+        inputSchema: {
+            projectId: guid,
+            source: z.string().min(1).optional().describe("Kaynak ortam adı; varsayılan 'development'"),
+            target: z.string().min(1).optional().describe("Hedef ortam adı; varsayılan 'production'"),
+            modules: z.array(z.string().min(1)).max(20).optional().describe("Yalnız bu modüller, backend'in modül adıyla (yanıtın modules[].module değerleri; ör. 'page', 'flow', 'microservice', 'data_transfer_object', 'global-function')")
+        },
+        annotations: readOnly
+    }, handle(config, async ({ projectId, source = 'development', target = 'production', modules }) => {
+        // Tek modül ve 50 satır sınırı sunucuda uygulanır (adlar yalnız listelenen kayıtlar için okunur); birden çok modül
+        // süzgecinde sunucu tavanı istenir, süzme burada yapılır.
+        const single = modules?.length === 1 ? modules[0] : undefined;
+        const response = await platform.org('GET', `/revisions/${projectId}/environment-diff`, {
+            query: { source, target, ...(single ? { module: single } : {}), limit: modules && modules.length > 1 ? 1000 : 50 }
+        });
+        const diff = (response?.data ?? response ?? {});
+        const wanted = (module) => modules === undefined || modules.includes(module);
+        const records = (diff.records ?? []).filter((record) => wanted(record.module));
+        const total = modules && modules.length > 1 ? records.length : Math.max(diff.total ?? 0, records.length);
+        const moduleCounts = (diff.modules ?? []).filter((module) => wanted(module.module));
+        return {
+            source,
+            target,
+            equal: total === 0,
+            ...(total === 0 ? { note: `${source} ve ${target} özetlenen modüllerde eşit — notCovered'daki modüller karşılaştırılmadı.` } : {}),
+            modules: moduleCounts,
+            records: records.slice(0, 50).map((record) => ({
+                module: record.module,
+                ...(record.name ? { name: record.name } : {}),
+                id: record.recordId,
+                change: record.state === 'different' ? 'changed' : record.state
+            })),
+            ...(total > 50 || diff.truncated === true ? { truncated: true, total, truncatedNote: "50 satırdan fazla fark var — modules ile süzün (ör. modules: ['page'])." } : {}),
+            notCovered: diff.notCovered ?? [],
+            recordsNote: 'Tablo satırları (recordTransferMode) karşılaştırılmaz; bu yalnız tanım farkıdır.',
+            ...(diff.digestCheck?.possiblyStale ? { digestNote: 'Ortamlardan birinin özeti hiç denetlenmemiş, son denetimi düşmüş ya da güvenilir değil: fark bayat olabilir.' } : {})
+        };
+    }));
     server.registerTool('environment_create', {
         title: 'Dal environment\'ı aç',
         description: `Projede yeni bir dal environment'ı açar: kendi PG şeması kurulur ve development'ın tanımları oraya kopyalanır. Asenkron bir saga'dır — yanıt 202 döner, dal hemen kullanılabilir DEĞİLDİR. includeRecords true ise projenin KENDİ veritabanındaki bütün veri tablolarının satırları da kopyalanır (çok dilli companion tablolar ve junction'lar dahil; files/folders ve audit trail tabloları hariç, dış datasource'lara dokunulmaz) — entity'de kayıt taşıması ayarı açık olmasa bile. Merge'de yalnız kayıt taşıması ayarı açık tabloların satırları üç yollu geri taşınır (rehber: merge, Tablo kayıtları). ${templateSubscriptionLock}`,

package/dist/tools/flows.js

@@ -64,6 +64,23 @@ function hostNodes(record) {
     return record.schema ?? record.views ?? [];
 }
 const BINDINGS_UNAVAILABLE = 'Barındırıcı kaydı okunamadığı için olay bağları hesaplanamadı; akış listesi yine de günceldir.';
+/**
+ * g-21 (D-21, plans/defter-saha-bulgulari): `flow_get` `host` olmadan da çalışır. Akış kimliği sahibini söylemez ve
+ * platformda kimlikten sahibe giden uç yoktur; kimlik sırayla sayfa → layout → komponent kaydı olarak okunur. Yalnız
+ * 404 sonrakine geçer — başka hata (yetki, 500) sahibi hakkında bir şey söylemez ve olduğu gibi döner.
+ */
+async function resolveFlowHost(platform, project, environment, applicationId, hostId) {
+    for (const host of ['page', 'layout', 'component']) {
+        try {
+            return { host, record: await fetchHost(platform, host, project, environment, applicationId, hostId) };
+        }
+        catch (error) {
+            if (!(error instanceof PlatformApiError) || error.status !== 404)
+                throw error;
+        }
+    }
+    throw new PlatformApiError(`flow_get: bu kimlikte sayfa/layout/komponent yok (${hostId}, uygulama ${applicationId}). hostId akışın barındırıcısının id'sidir, akışın kendi id'si değil — page_list / layout_list / component_list ile doğrulayın ya da host'u açıkça verin.`, 404);
+}
 /**
  * TB-126 / S2-36 — satır aksiyonu taşıyabilen komponentler. Bu tiplerin `actions` prop'unu çoğu
  * zaman YÜKLEME AKIŞI çalışma zamanında yazar (aksiyon role göre eklenip çıkarılıyorsa başka yolu
@@ -529,16 +546,26 @@ export function registerFlowTools(server, platform) {
     server.registerTool('flow_get', {
         title: 'Akış getir',
         description: "Tek akışı adımlarıyla getirir; yeni akış yazarken en iyi şablon budur. bindings bu akışa bağlı olaylardır ([{ target: elementId | 'page', event }]; boşsa akış sahipsizdir). Hedefi silinmiş (element'siz) setter iteratee'si varsa yanıttaki flowWarnings söyler — o adım koşar ama hiçbir şeye yazmaz.",
-        inputSchema: { project: projectParam, environment: environmentParam, host: hostParam, applicationId: guid, hostId: guid, flowId: flowIdParam },
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            host: hostParam.optional().describe("Akışın barındırıcısı: page | layout | component. Verilmezse gateway hostId'yi sırayla sayfa → layout → komponent olarak okur (en çok üç okuma, 404 sonrakine geçer) ve yanıtın hostResolvedAs alanı bulduğunu söyler; biliyorsanız verin, tek okuma yapılır"),
+            applicationId: guid,
+            hostId: guid,
+            flowId: flowIdParam
+        },
         annotations: readOnly
     }, handle(config, async ({ project, environment, host, applicationId, hostId, flowId }) => {
-        const response = await platform.tenant('GET', project, flowPath(host, applicationId, hostId, flowId), { environment });
-        const record = await fetchHost(platform, host, project, environment, applicationId, hostId).catch(() => undefined);
+        const resolved = host === undefined ? await resolveFlowHost(platform, project, environment, applicationId, hostId) : undefined;
+        const owner = resolved?.host ?? host;
+        const response = await platform.tenant('GET', project, flowPath(owner, applicationId, hostId, flowId), { environment });
+        const record = resolved?.record ?? await fetchHost(platform, owner, project, environment, applicationId, hostId).catch(() => undefined);
         const warnings = targetlessSetterWarnings(response);
         if (!response || typeof response !== 'object' || Array.isArray(response))
             return response;
         return {
             ...response,
+            ...(resolved === undefined ? {} : { hostResolvedAs: resolved.host }),
             ...(record === undefined
                 ? { bindingsNote: BINDINGS_UNAVAILABLE }
                 : { bindings: flowBindings(hostNodes(record), record.events).get(flowId.toLowerCase()) ?? [] }),

package/dist/tools/mobile.js

@@ -114,6 +114,57 @@ export function registerMobileTools(server, platform) {
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid.describe('Mobil uygulama (slug da verilebilir, gateway GUID\'e çevirir)'), ...pushAudienceFields, pageIndex: pagingParams.pageIndex, pageLength: pagingParams.pageLength.describe('Sayfa boyu; varsayılan 25') },
         annotations: readOnly
     }, handle(config, ({ project, environment, applicationId, ...query }) => platform.tenant('GET', project, `/push/devices/${applicationId}`, { environment, query })));
+    server.registerTool('mobile_error_list', {
+        title: 'Telefonda düşen akış hataları',
+        description: "Mobil uygulamanın TELEFONDA düşen akış hatalarını okur (kabuk gönderir, sunucu saklar — defter-saha-bulgulari b-10/f-10). Kayıt biçimi page_screenshot.runtimeErrors ile aynıdır (flowId · step{id,name,type} · code · message · element · property · kind) ve şunları ekler: pageSlug, platform, appVersion, devices (kaç kurulumda), count, lastAt. Aynı akış/adım/mesaj üçlüsü tek satıra katlanır, en yeni önce. Önizlemede görülmeyen cihaz hatasını (ağsız yazma, sayfa kapanınca atlanan adım `page-unmounted`, geri gidilemeyen `back-unavailable`) kullanıcının anlatmasını beklemeden okumak için. Kabuk hatayı ağ gelince gönderir: uçak kipinde düşen hata ağ dönene kadar görünmez; occurredAt telefondaki saattir. Sunucu kurulum başına son 200 kaydı ve 7 günü tutar; mesaj gateway maskesinden geçer. Uygulama ayarı properties.mobile.reportErrors: false gönderimi kapatır. Web önizlemesinin hataları burada YOK — onları page_screenshot.runtimeErrors verir.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid.describe('Mobil uygulama (slug da verilebilir, gateway GUID\'e çevirir)'),
+            pageSlug: z.string().min(1).optional().describe('Yalnız bu sayfada düşenler'),
+            flowId: z.string().min(1).optional().describe('Yalnız bu akış'),
+            installationId: z.string().min(1).optional().describe('Yalnız bu kurulum (notification_device_list\'teki installationId ile aynı kimlik)'),
+            since: z.string().min(1).optional().describe('ISO zaman; yalnız bundan sonra görülenler'),
+            limit: z.number().int().min(1).max(100).optional().describe('Katlanmış satır sayısı; varsayılan 20')
+        },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, applicationId, limit = 20, ...query }) => {
+        let response;
+        try {
+            response = await platform.tenant('GET', project, `/runtime-errors/${applicationId}`, { environment, query: { ...query, limit: 200 } });
+        }
+        catch (error) {
+            if (error instanceof PlatformApiError && error.status === 404) {
+                throw new PlatformApiError('mobile_error_list: bu backend istemci akış hatası kaydetmiyor (runtime-errors ucu yok) — backend imajı güncel değil ya da uç bu kurulumda kapalı. Önizleme hatalarını page_screenshot.runtimeErrors verir.', 404);
+            }
+            throw error;
+        }
+        const rows = unwrap(response) ?? [];
+        // Aynı akış/adım/mesaj tek satır: sayılar toplanır, en yeni kaydın bağlamı (sayfa, sürüm, platform) taşınır.
+        const folded = new Map();
+        for (const row of rows) {
+            const key = `${row.flowId ?? ''}|${row.step?.id ?? ''}|${row.message ?? ''}`;
+            const lastAt = row.lastAt ?? row.occurredAt ?? '';
+            const existing = folded.get(key);
+            if (!existing) {
+                folded.set(key, { ...row, lastAt, count: row.count ?? 1, devices: new Set(row.installationId ? [row.installationId] : []) });
+                continue;
+            }
+            existing.count = (existing.count ?? 1) + (row.count ?? 1);
+            if (row.installationId)
+                existing.devices.add(row.installationId);
+            if (lastAt > (existing.lastAt ?? ''))
+                Object.assign(existing, { ...row, lastAt, count: existing.count, devices: existing.devices });
+        }
+        const errors = [...folded.values()]
+            .sort((left, right) => (right.lastAt ?? '').localeCompare(left.lastAt ?? ''))
+            .map(({ devices, installationId: _installation, ...error }) => ({ ...error, devices: devices.size }));
+        return {
+            errors: errors.slice(0, limit),
+            ...(errors.length > limit ? { truncated: true, total: errors.length } : {}),
+            ...(errors.length === 0 ? { note: 'Bu süzgeçle kayıt yok. Telefon hatayı ağ gelince gönderir; uçak kipindeki hata ağ dönene kadar görünmez. Uygulama ayarı properties.mobile.reportErrors: false ise kabuk göndermez.' } : {})
+        };
+    }));
     server.registerTool('notification_create', {
         title: 'Push bildirimi gönder (varsayılan kuru koşu)',
         description: "Kitleye dile göre içerikle push bildirimi gönderir — `SendPushNotificationCommand: { dryRun, audience, content, defaultLanguage, path?, query?, androidChannel?, badge?, testInstallationId? }`. dryRun VARSAYILAN TRUE: yalnız kitleyi sayar ({ total, byLanguage }), hiçbir şey yazmaz; göndermek için dryRun: false AÇIKÇA verilir. Gerçek gönderim kuyruğa girer ve yanıt id döner; sonucu notification_history { id } ile okuyun (birkaç saniye sonra sent/failed, teslim sayıları ve hatalı cihazlar). Kitle her zaman aktif ve izinli cihazlara daraltılır; testInstallationId verilirse yalnız o kurulum (notification_device_list'teki installationId). İçerik dil → { title, body }; başlığı boş dil düşer ve o cihaz varsayılan dili alır; varsayılan dilde başlık zorunlu (NTF-002, platform 400). Dil anahtarları küçük harfe indirilir. path dokunuşta açılacak sayfanın slug'ı, query onun sorgusu. Ret: production'da dryRun: false istek gitmeden reddedilir (NTF-001).",
@@ -169,6 +220,11 @@ export function registerMobileTools(server, platform) {
         const plan = buildMobileAppPlan(input);
         if (dryRun)
             return { dryRun: true, plan };
+        // APP-001 (K5, b-15): sekme ve ana sayfa ayarı yalnız development'a yazılır. Dalda kurulan sayfalara bağlı ayar
+        // development'ta olmayan sayfaları gösterir, dal sekmesiz kalırdı.
+        if (platform.resolveEnvironment(environment) !== 'development') {
+            throw new PlatformApiError(`mobile_app_create [APP-001]: uygulama ayarı (sekmeler, ana sayfa) yalnız development'a yazılır; '${platform.resolveEnvironment(environment)}' ortamında kurulan sayfalara bağlanamaz. Mobil uygulamayı development'ta kurun, production'a deployment_start ile taşıyın. Hiçbir şey yazılmadı.`, 400);
+        }
         const completed = [];
         const skipped = new Set();
         const warnings = [];