@appaflytech/zeyrek-ai-mcp 0.0.51 → 0.0.53

package/dist/resources/examples/mobile-offline-seamless.json

@@ -12,8 +12,8 @@
     "list": "Liste = sunucunun yanıtı (ağsızken son okunan) + Page.offline.list()'teki status === 'pending' kayıtlar (service = yazma ucunun slug'ı, parameters'tan alan). Reddedilen kayıt (status 'rejected') listeye katılmaz. Ağ yokluğu hata metni göstermez: tx_liste_hata yalnız Steps.<okuma>.error && !error.network iken görünür.",
     "lock": "Yazan düğme istek süresince isLoading + isDisabled. Kilitsiz düğmede hızlı ikinci dokunuş YENİ bir istek ve yeni bir Idempotency-Key'dir — sunucu ikisini de uygular (ölçüldü: 1,6 sn'de üç dokunuş, üç kayıt). Kilit her dalın sonunda (always, queued, error) açılır.",
     "landing": "Açılış sayfası korumasız giriş ekranıdır; kalıcı state.app.oturumVar (storage: device) true ise mount akışı listeye replace ile geçer. Giriş işareti yazar, çıkış siler. Geçici çare: korumalı açılış sayfası ağsız ilk açılışta çizilemiyor (kök ADR 0024 taslak) ve kabuk bilgisi yokken middleware reddi girişe yönlenmiyor (zeyrek-frontend ARC-342). Mağaza derlemesinde açılış manifestin landingPageSlug'ıdır.",
-    "refresh": "Liste scroll-view refreshable + refresh olayı aynı yükleme akışına bağlı: bağlantı dönünce açık ekranın mount akışı kendiliğinden koşmaz (kök ADR 0025 taslak). Kuyruk gönderilince kayıt artık bekleyen değildir ve önbellekteki eski listede de yoktur — kullanıcı aşağı çekene kadar listeden düşer; ADR 0025 kapanınca kalkar.",
-    "preview": "Studio önizlemesi, /dev ve page_screenshot önbellek ve kuyruk KULLANMAZ: page_screenshot ağı kesemez, ağsız davranış yalnız cihazda (uçak kipi) görülür. Ekran açıkken değişen akış ekran yeniden açılınca etkindir.",
+    "refresh": "Liste scroll-view refreshable + refresh olayı ve sayfanın offlineQueueChange olayı aynı yükleme akışına bağlı (pageUpdateArgs, kök ADR 0029): kuyruğa giren kayıt listeye hemen katılır, bağlantı dönünce gönderilen kayıt kuyruk değiştiği için akış yeniden koşup kaydı sunucudan getirir — listeden düşmez. Bağlantı dönüşünün kendisi açık ekranın mount akışını koşturmaz (kök ADR 0025 taslak); çekerek yenileme yine çalışır.",
+    "preview": "Studio önizlemesi, /dev ve page_screenshot önbellek ve kuyruk KULLANMAZ: page_screenshot network eylemiyle ağı keser (SCR-020) ama okuma da yazma da hata yolundan döner; önbellekli ve kuyruklu davranış yalnız cihazda (uçak kipi) görülür. Ekran açıkken değişen akış ekran yeniden açılınca etkindir.",
     "notWhere": "Kuyruktaki kayda bağlı ikinci işlem (dönen kimlikle yönlendirme) çevrimdışıyken koşamaz; o akışlara queued dalı vermeyin. Giriş ve hiç açılmamış ekran ağ ister — fark yalnız orada görünür."
   },
   "applicationUpdateArgs": {
@@ -1514,7 +1514,16 @@
           "event": "click",
           "eventValue": "<cikis akış id>"
         }
-      ]
+      ],
+      "pageUpdateArgs": {
+        "_note": "Sayfa olayı page_update { events } ile yazılır (mobil sayfa olayı; listeyi kuyruk değişince yeniden kurar).",
+        "events": [
+          {
+            "name": "offlineQueueChange",
+            "value": "<notlar-yukle akış id>"
+          }
+        ]
+      }
     }
   ]
 }

package/dist/resources/examples/store-import-mapping.json

@@ -0,0 +1,25 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mağazadan taşıma: içe aktarma raporu okunduktan sonra Zeyrek'e yazılacak seçimler (temsilî Anatoli kimlikleri; plans/mobil-magazadan-tasima §Ürün eşleme kuralları)."
+  },
+  "tool": "mobile_store_import_mapping",
+  "arguments": {
+    "applicationId": "01a13ea2-c7ed-70ed-9046-6e4eea34f216",
+    "importId": "01a17000-0000-7000-8000-000000000001",
+    "mapping": {
+      "scheme": "anatoli",
+      "choice.listing.tr.title": "apple",
+      "choice.listing.en.description": "custom",
+      "custom.listing.en.description": "Discover Anatolia, offline.",
+      "skip.language.ar": "true",
+      "product.0.key": "premium_yillik",
+      "product.0.entitlement": "premium",
+      "product.1.key": "cevrimdisi_paket",
+      "product.1.entitlement": "offline",
+      "declaration.appPrivacy": "true",
+      "declaration.dataSafety": "true"
+    }
+  },
+  "next": "mobile_store_import_apply { applicationId, importId } → mobile_product_list → mobile_store_notification_forwarding { action: 'switch', confirm: true } (kullanıcı onayıyla) → mobile_purchase_import { dryRun: true }"
+}

package/dist/resources/guides/deployment.md

@@ -97,6 +97,15 @@ değişimidir: adresin gösterdiği **dosya kopyalanmaz**, production'da adres *
 production'a taşımak için onu dosya tipli prop'a (`ref`) ya da taşınan bir satırın dosya sütununa
 bağlayın.
 
+## Dağıtımdan sonra doğrula
+
+`deployment_status` bitti dedikten sonra `environment_diff({ projectId })` (varsayılan development → production)
+iki ortamın tanım farkını tek çağrıda verir: `equal: true` ise özetlenen modüllerde fark yok. Fark tanım özetinden
+gelir, gövdeyi elle karşılaştırmaya gerek yok. Dağıtım kimlikleri korur; ama development'ta yeniden yazılan bir akış
+(adım parametrelerinin kimlikleri yenilenir) içeriği aynı olsa da `changed` görünebilir.
+`notCovered`'daki modüller (tablolar, bileşenler, erişim, süreçler) ve tablo satırları bu karşılaştırmanın
+dışındadır; satır için §Tablo satırları. `digestNote` varsa özet bayat olabilir.
+
 ## Production'a doğrudan yazılmaz
 
 Eksik satır ya da dosya production'da elle tamamlanamaz. Production ortamında `file_upload`,

package/dist/resources/guides/expressions.md

@@ -112,6 +112,7 @@ dalından devam eder.
 | `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. 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) |
+| `Entitlements` · `Products` · `Balances` | Uygulama içi satın almanın salt okunur durumu (kök ADR 0027), barındırıcı yazar: `Balances.<bakiye>` sayı — tüketilen ürünün (kredi, jeton) güncel bakiyesi, sunucudan gelir ve harcama/satın alma sonrası kendiliğinden güncellenir (bilinmeyen bakiye `undefined`: `{{ Balances.kredi ?? 0 }}`; iade sonrası negatif olabilir); `balance-spend` adımının `args.value`'sundaki düz ad katalogda tüketilen ürünün `balance`'ı olmalıdır (yoksa yazım `FLOW-046` ile durur). Hak tarafı: `Entitlements.<hak>` boolean — hak açık mı (bilinmeyen hak `false`; ekran ürüne değil hakka bakar: `isHidden: {{ !Entitlements.premium }}`); `Products.<anahtar> = { price, period, trial }` — mağazanın yerelleştirilmiş fiyat metni (`₺949,99`), süre ve deneme ISO 8601 (`P1Y`, `P7D`) ya da `null`; `purchase.value`'ya yazılan düz anahtar katalogda olmalıdır (yoksa yazım `FLOW-045` ile durur), seçimden gelen anahtar `{{ … }}` şablonudur ve yazımda denetlenmez. Değişince bağlar yeniden okunur (satın alma ve geri yükleme sonrası kendiliğinden). Studio önizlemesi ve oynatıcı katalogdan deneme değerleri verir; web uygulamasında ikisi de boş nesnedir. `Device`'ın altında değil, kendi adlarıyla. Tarif: `platform_guide('mobile-steps')` §Satın alma tarifi |
 | **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/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
@@ -284,6 +286,69 @@ birleşir (`{ appLock: { timeoutSeconds: 300 } }` açık/kapalıyı korur).
   görüntüsü örtülür, Android'de örtülmez. **Oynatıcıda (Expo Go) ve Studio önizlemesinde kilit yoktur** — tek bir
   ekranı kapı arkasına almak için `biometric-auth` adımı (platform_guide('mobile-steps')).
 
+## Satın almalar
+
+Uygulama içi satın alma (kök ADR 0027): abonelik (`subscription`), tek seferlik kalıcı ürün (`non_consumable`) ve tüketilen
+ürün (`consumable` — kredi, jeton). Ürün Zeyrek anahtarıyla anılır, mağaza kimliği sayfaya yazılmaz; hak (`entitlement`) Apple'da
+abonelik grubu, Google'da abonelik, abonelik ürünü Google'da temel plandır (anahtar, `_` → `-`). Sıra:
+
+1. **Ürün:** `mobile_product_upsert` (anahtar, tür, hak, TRY fiyatı, abonelikte süre ve deneme, dil başına ad ≤ 30 ve
+   açıklama ≤ 45) — `mobile_product_list` mağaza başına durumu gösterir. Mağazaya gitmiş ürünün anahtarı, türü, hakkı ve
+   bakiye adı kilitlidir; ad/fiyat/süre/miktar değişikliği `pendingChanges`'e düşer (miktar mağaza alanı değildir, doğrudan
+   geçer). **Tüketilen ürün:** `kind: 'consumable'`, hak yerine `balance` (bakiyenin adı, ekranlar `Balances.<ad>` okur) ve
+   `grantsAmount` (her satın almada eklenen miktar, 1–1.000.000); süre, deneme ve hak yasak. Apple'da `CONSUMABLE`, Google'da
+   tek seferlik tüketilebilir ürün — grup, temel plan ve deneme adımı yoktur, gönderim yolu `non_consumable` ile aynıdır.
+   Aynı `balance`'ı birden çok ürün paylaşır. Kullanıcı ürünü her istediğinde yeniden alır; mağaza **geri yüklemez** (K9):
+   girişsiz uygulamada telefon değişince bakiye gider, girişli uygulamada hesaba taşınır (`MOB-036` kredi harcama akışı
+   yazılırken girişsiz uygulamayı uyarır). İade o satırın miktarını bakiyeden geri alır, bakiye negatife düşebilir.
+2. **Hazırlık:** `mobile_purchase_readiness` — iOS: Apple hesabı, ücretli uygulama sözleşmesi, satın alma anahtarı
+   (`.p8`), bildirim adresi; Android: Play hizmet hesabı, ödeme profili, faturalandırmalı derleme, hizmet hesabı izni,
+   gerçek zamanlı bildirim konusu. `manual` satırları konsolda insan yapar; satır `hint`'i nerede olduğunu söyler.
+3. **Faturalandırmalı derleme (Android):** Google ürün açmayı `BILLING` izinli bir derleme yüklenmeden reddeder
+   (`play_billing_build`). Ürünlü uygulamanın derlemesi `purchases` bloğunu ve izni taşır — kabuk 0.9.0+ (ön kontrol
+   P-23: `purchases_shell_outdated` eski kabuk, `purchases_unknown_product` bir `purchase` adımının düz anahtarı
+   katalogda yok, `purchases_not_sent` ürün mağazaya gitmemiş); `mobile_build_start
+   { platform: 'android', target: 'internal' }`. Ürünü olmayan uygulamanın ikilisinde satın alma modülü ve izin yoktur.
+4. **Gönder:** `mobile_product_send` (202, asenkron) → `mobile_product_send_status`. Geri alınamaz: mağazadaki ürün API'den
+   silinmez, Apple ürün kimliğini yeniden kullandırmaz — anahtar ve fiyatı kullanıcıya onaylatın. Fiyat değişiminde
+   mevcut aboneler varsayılan olarak eski fiyatta kalır (`applyToExisting: true` onlara da uygular). Düşen adım
+   (`paid_agreement`, `play_permission`, `play_billing_build`) giderilince `mobile_product_send { retrySendId }`.
+5. **Ekran:** `purchase` / `restore-purchases` adımları ve `Entitlements` (`platform_guide('mobile-steps')` §Satın alma
+   tarifi); tüketilen ürün için `balance-spend` adımı ve `Balances` (§Kredi harcama tarifi).
+
+**İnsanın işi (MCP yapmaz):** satın alma anahtarını (`.p8` + Key ID + Issuer ID) Studio › Satın almalar › Mağaza
+hazırlığı'nda yüklemek (gizli bilgi); App Store Connect'te ücretli uygulama sözleşmesi, banka ve vergi; bildirim adresini
+(`notificationUrl` satırının `copyValue`'su) App Store Connect › App Information › App Store Server Notifications
+(Version 2, production ve sandbox aynı adres) alanına yazmak; Play Console'da ödeme profili, hizmet hesabına ürün izni,
+gerçek zamanlı bildirim Pub/Sub konusu ve kimlik doğrulamalı push aboneliği (`rtdnTopic` `copyValue`); App Review
+inceleme görseli. Apple ilk satın alma ürününü uygulamanın yeni sürümüyle inceler: ürün `ready` kalır, sürümle
+incelemeye gönderilince `in_review` olur. Satışlar `mobile_purchase_list` (gerçek satış `production`'dadır; TestFlight
+ve Play iç test satın almaları `environment: test` etiketiyle, `includeTest: true` olmadan görünmez).
+
+## Mağazadan taşıma
+
+Yayındaki bir uygulama (App Store / Google Play) Zeyrek'e **bir kez okunur, bir kez onaylanır**; sonra tek kaynak Zeyrek'tir
+(kök ADR 0028). Yalnız ilk derlemeden önce (MOB-037).
+
+1. `mobile_store_import_start { applicationId, bundleId, packageName }` → bağlantı satırı ve okuma işi.
+2. `mobile_store_import_report` → `state: ready` olunca kovalar: **auto** (Zeyrek'e gelir) · **upload** (siz yüklersiniz:
+   ikon, 6.5" ekran görüntüsü) · **kept** (mağazada kalır: beyan içerikleri, ülke fiyatı, promosyon, tüketilen ürün).
+3. `mobile_store_import_mapping` → `scheme` (eski uygulamanın URL şeması, zorunlu), iki mağaza farkı
+   (`choice.<satır>`), ürün anahtarı/hak (`product.<i>.key|entitlement`), beyan onayı. Mağaza kimliği seçilmez (MOB-038).
+4. `mobile_store_import_apply` → tek işlem; mağazaya hiçbir şey gitmez. Örnek: `store-import-mapping`.
+
+**Aboneler — üç kaynak:** eski liste (`mobile_purchase_import`, önce `dryRun` — MOB-039) · mağaza bildirimi (katalogdaki
+ürünün tanınmayan işlemi **sahipsiz** satın alma açar) · cihaz (kabuk ilk açılışta sürüm başına bir kez sessiz geri
+yükler, kabuk ≥ 0.10.0). Sahipsiz satır `mobile_purchase_list { owner: 'ownerless' }` ile görünür; geri yükleme kuruluma,
+giriş hesaba bağlar.
+
+**Apple bildirimleri:** `mobile_store_notification_forwarding { action: 'switch', confirm: true }` adresi Zeyrek'e çevirir,
+eski adresi 90 gün iletir (MOB-040). Google'da Pub/Sub konusuna ikinci abonelik insanın işidir.
+
+**Yayın öncesi:** ön kontrol P-24…P-31 (kimlik, sürüm, derleme numarası, upload anahtarı, ürünler, kabuk, bildirim, URL
+şeması). Yayından hemen önce `mobile_store_diff { action: 'read' }`; `store_changed` / `both_changed` satırları
+`choose` ile seçilmeden mağaza yayını başlamaz (MOB-041). Yayın yalnız `send` listesindeki alanları yazar.
+
 ## Hata kodları
 
 `mobile_build_status` → `error.code`.

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,10 +26,50 @@ 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` |
+| `purchase` | uygulama içi satın alma (kök ADR 0027). `args.value` ürünün Zeyrek **anahtarı**, metin şablonu: düz `premium_yillik` ya da `{{ plan_secim.value }}` (`FLOW-045`: katalogda olmayan düz anahtar yazılmaz; `{{ }}` dışındaki ifade harfi harfine anahtar sayılır, `productKey`/`sku` anahtarı sessizce düşer). Kabuk mağazanın penceresini açar, sunucu makbuzu mağazaya sorar, hak açılır: `Steps.<adım>.data = { productKey, entitlements }` → `always`; `Entitlements` kendiliğinden güncellenir. **Kapıdır**: `error.status` `cancelled` (vazgeçti) · `pending` (Ask to Buy, bekleyen ödeme ya da sunucuya ulaşılamadı — hak sonra kendiliğinden açılır) · `failed` · `unavailable` (mağaza yok, ürün satışta değil, ikili satın almayı taşımıyor) · `unsupported` (web uygulaması, production `/view`, kabuk < 0.9.0) · `invalid` (anahtar katalogda/manifestte yok); `error` dalı → hata akışı → **o da yoksa akış bu adımda biter**. Paletten yalnız mobilde |
+| `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
 
@@ -78,6 +118,54 @@ sürer: adımı tetikleyen tıklamanın raporu `pageState: 'awaiting-user'` der,
 'preview-biometric__verify' }` (Doğrulandı say) ya da `'preview-biometric__cancel'`. Tam gövde:
 `ngapps://examples/flow-biometric-confirm`.
 
+## Satın alma tarifi
+
+**Satın alma tarifi** (kök ADR 0027): (1) ürünler kataloğa — `mobile_product_upsert { key: 'premium_yillik', kind:
+'subscription', entitlement: 'premium', priceTry, period: 'year', trial, texts }`; aynı hakkı veren aylık ve yıllık
+abonelik mağazada bir gruptur. Hazırlık ve mağazaya gönderim `platform_guide('mobile-publish')` §Satın almalar. (2) Ekran
+ürüne değil **hakka** bakar: teklif kökü `isHidden: {{ Entitlements.premium }}`, "Premium açıldı" kökü
+`isHidden: {{ !Entitlements.premium }}` — ayrı sayfa gerekmez. Fiyatı yazmayın: `{{ Products.premium_yillik.price }}`
+mağazanın yerel fiyat metnidir (`₺949,99`), `period` / `trial` ISO 8601 süre (`P1Y`, `P7D`) ya da `null`; plan seçimi
+`choice-chips` ise `{{ Products[plan_secim.value]?.price ?? '' }}`. (3) Devam et düğmesinin akışı `start` → `purchase`
+`{ value: '{{ plan_secim.value }}' }`; `always` teşekkür, `error` dalında `condition`: `pending` → "onay bekleniyor",
+`cancelled` dışı → hata iletisi, `else` (vazgeçti) → hiçbir şey. (4) "Satın almaları geri yükle" düğmesi → `restore-purchases`
+— bu akışı satın alma akışından ÖNCE yazın: `MOB-034` ekranın geri yükleme yolunu yalnız satın alma akışı yazılırken arar. (5) Abonelik satan ekranda süre ve fiyat, otomatik yenileme ve iptal yolu metni, kullanım koşulları ve
+gizlilik bağlantısı (`href` taşıyan düğme; adres `mobile_store_get` `urls.privacyPolicy`) — App Store 3.1.2 ve Play
+politikası ister, yoksa ekran incelemeden döner (`MOB-042`). Tam gövde: `ngapps://examples/flow-purchase-paywall`.
+
+Tuzaklar (Studio'nun "Teklif ekranı oluştur" şablonu ilk ölçümde üçüne düştü): akış `start` adımıyla açılmazsa motor
+onu sessizce bitirir, düğme hiçbir şey yapmaz; kod bağı `{{ }}` ile sarılmazsa (`isHidden: 'Entitlements.premium'`)
+düz metin sayılır ve iki kök birden gizlenir; hata dalı yalnız `pending`'i karşılarsa öteki hatalar sessiz kalır.
+Statik anahtar (`{{ }}` şablonu olmayan değer) katalogda değilse yazım `FLOW-045` ile **durur**, hata katalogdaki
+anahtarları sayar: ürünü önce `mobile_product_upsert` ile açın (akış doğrulayıcısı kataloğu okumaz; Studio'da yazılan
+bilinmeyen anahtarı mağaza yayını ön kontrolü P-23 uyarır). Şablon değer yazımda denetlenmez. Nerede ne olur: Studio önizlemesi, canlı kip, `/dev`,
+`/branch` ve Zeyrek Mobile oynatıcısı gerçek satın alma yapmaz, dört sonuçlu **deneme penceresi** açar (`preview-purchase__success` ·
+`__cancel` · `__pending` · `__error`, gönder `preview-purchase__send`; başarı yalnız o oturumda hakkı açar, Haklar çipi
+de açar); production `/view` ve web uygulaması `unsupported`. `page_screenshot` pencereyi biyometri penceresi gibi
+tanımaz — `scan-code`'daki gibi `captureUnready: true` ile sürün (satın alma penceresinde ölçülmedi). Gerçek satın alma
+kabuk 0.9.0+ mağaza derlemesinde (TestFlight sandbox, Play iç test): hak sunucuda doğrulanır, telefonun söylediğine
+güvenilmez; cihazın doğrulama/geri yükleme uçlarını kabuk çağırır, akıştan çağrılmaz. Satışlar `mobile_purchase_list`.
+
+## Kredi harcama tarifi
+
+**Kredi harcama tarifi** (kök ADR 0027 bakiye bölümü): (1) kredi ürünü kataloğa — `mobile_product_upsert { key: 'kredi_100',
+kind: 'consumable', balance: 'kredi', grantsAmount: 100, priceTry, texts }`; aynı `balance`'ı birden çok ürün paylaşır
+(`kredi_100`, `kredi_500` → `Balances.kredi`), `entitlement` verilmez. Satın alma teklif ekranıyla aynıdır (`purchase`
+`{ value: 'kredi_100' }`): doğrulanınca bakiye `grantsAmount` kadar artar. (2) Ekran bakiyeyi okur:
+`{{ 'Kredin: ' + (Balances.kredi ?? 0) }}` — bilinmeyen bakiye `undefined`, `?? 0` yazın; `{{ }}` ile sarın. (3) Harcayan
+düğmenin akışı `start` → `balance-spend { value: 'kredi', title: '10' }`; `always` işi yapar, `error` dalında
+`Steps.<ad>.error.status === 'insufficient'` → "Krediniz yetmiyor" ve satın alma ekranına yönlendirme, `unavailable` →
+"Bağlantı gerekli" (çevrimdışıyken harcanamaz, kuyruğa girmez). (4) Sunucu tarafı iş (rapor üretmek) harcamadan SONRA
+koşar: harcamayı önce yapan akış, iş düşerse bakiyeyi iade etmez — sunucuda "düş, üret, düşerse geri ekle" gerekiyorsa
+workflow `balance` adımıyla kurun (`platform_guide('workflow')` §Balance adımı). Tuzaklar: miktar `args.title`'dır
+(`args.amount` sessizce düşer, `FLOW-046` block); bakiye adı katalogdaki `balance`'tır, ürün anahtarı değil; **girişsiz
+uygulamada bakiye kuruluma yazılır ve tüketilen ürün mağazada geri yüklenemez** — telefon değişince kredi gider
+(`MOB-036` yazımda uyarır); girişli uygulamada hesaba taşınır. Nerede ne olur: production `/view` ve web uygulaması
+`unsupported` döner; gerçek harcama kabuk 0.9.0+ mağaza derlemesinde sunucuda doğrulanır. Studio önizlemesinde kredi
+satın alma/harcama davranışı için frontend 11 (kabukta tüketme ve önizleme) bitene kadar bu rehberde ölçülmüş bir şey
+yoktur — önizlemede `unsupported` ya da deneme değeri görürseniz hata değildir. Tam gövde:
+`ngapps://examples/flow-credit-spend`.
+
 ## Konum ve harita
 
 `style`, `accuracy`, `reverseGeocode` gibi anahtarlar sözleşmede yoktur ve platform onları sessizce düşürür

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.