@appaflytech/zeyrek-ai-mcp 0.0.43 → 0.0.46

package/dist/resources/guides/mobile-connect-data.md

@@ -0,0 +1,70 @@
+# Mobil veri bağlama rehberi
+
+Mobil uygulamada (`type:'mobile'`) bileşeni veriye bağlamak web'deki connect-data sözleşmesinin aynısıdır
+(`platform_guide('page')` Kural 1c-3: `connect_data_describe` → `connect_data_bind` → `connect_data_get`).
+Bu rehber yalnız telefonun farkını anlatır: tanıma eklenen telefon alanları, mobil projede yazılan varsayılanlar,
+gruplu liste ve kurallar. Ekranın kendisi `platform_guide('mobile')`'dadır.
+
+## Telefonda
+
+Telefon kararları tanımda durur, bileşen prop'unda değil; web aynı tanımı okur ve bu alanları yok sayar.
+
+- **Seçim alanı:** alana dokunmak **alt sayfa** açar (hızlı liste, son seçilenler, arama); alanın yanındaki ↗
+  **tam ekran** seçimi açar (arama, filtre ve sıralama çipleri). Varsayılan yüzeyi `lookup.mobileMode` seçer:
+  `sheet` (varsayılan) | `fullscreen`. Satır `lookup.mobileRow { title, subtitle?, trailing? }`: başlık, alt satır
+  ve sağda mono değer.
+- **Liste ve tablo:** **sonsuz kaydırma** varsayılandır (`behavior.mobile.infiniteScroll`); sayfalar birleşir,
+  düşen sayfa "Yeniden dene" gösterir. Kapalıysa listenin sonunda "Daha fazla yükle".
+- **Mobil projede `connect_data_bind` varsayılanları yazar:** kök lookup'a `mobileMode: 'sheet'` ve
+  `mobileRow.title` ← label alanı; liste/seçim bağlantısına `behavior.mobile: { infiniteScroll: true }`.
+  Yeniden bağlamada kayıtlı telefon ayarı korunur; `null` kaldırır.
+- Studio sihirbazındaki "Telefonda" kutusu aynı alanları yazar; web'de çekmece Uygula bunları silmez.
+
+## Seçim bileşenleri
+
+`dropdown` ve `multi-select` kök lookup'ı (entity kaynağı) telefonda böyle açar. `behavior.mobile` seçim
+bileşeninde: `search` (alt sayfada arama kutusu), `infiniteScroll`, `pullToRefresh`, `recentSelections`.
+`mobileRow` parçaları lookup `fields` içinden seçilir (dışındaysa CD-004); `fields: []` (türetilen lookup)
+yalnız başlığın dolu olmasını ister. Tek seçim alt sayfada dokununca kapanır; çoklu seçim onay kutusu +
+"Seçililer (n)" + Temizle/Uygula ile yazar, `change` yalnız Uygula'da gider; `max-length` doğrulaması dolunca
+öbür satırlar pasifleşir.
+
+`autocomplete` lookup taşımaz (seçim listesi gerekiyorsa `dropdown`): bağlı `options` `value` + `label` ister,
+`caption`/`icon` isteğe bağlıdır. Bağlantı arama alanı seçmişse (`behavior.searchable`) yazılan metin
+`search { searchText }` ile düğüme yazılır ve bağlantı yeniden okunur — sunucu arar, akış gerekmez.
+
+## Tablo ve liste
+
+- **`datatable`:** `behavior.mobile` → `filterChips` (web `filterable` kolonlarından çip şeridi), `swipeDelete`
+  (onaylı kaydırarak sil), `infiniteScroll`, `pullToRefresh`. Kart görünümü `behavior.mobileCard
+  { title, fields?, trailing? }` seçili yollardan (dışındaysa CD-004); yoksa ilk metin alan başlıktır.
+  Satıra dokunmak düzenleme alt sayfasını açar (bağlantının `edit` ayarıyla).
+- **`repeater`:** bağlı satırlar sayfa sayfa birleşir; öğe şablonundaki metne alan bağlamak
+  `page_schema_patch` ile `set_binding { prop, expression: '{{ item.<alan> }}' }` (Studio'nun "Şablonda" seçimi
+  aynı op'u yazar).
+
+## Gruplu liste
+
+`grouped-list` `rows`u bağlanabilir; bağlarken `grouping` **zorunludur** (kök ADR 0019):
+
+```json
+{ "grouping": { "by": "dueDate", "sectionOrder": "asc", "dateBucket": "day", "otherSectionTitle": "Tarihsiz", "stickyHeaders": true, "showCounts": true } }
+```
+
+- `by` seçili ve sıralanabilir bir alan (`asis` hariç); `sectionOrder` `asc` · `desc` · `asis`.
+- `dateBucket` (`day` · `week` · `month`) yalnız `date`/`datetime` alanda (describe `dateBuckets`). Sunucu
+  sırayı gruplama alanıyla başlatır (azalanda boşlar sonda); `date` alanında kovayı satıra `__section` yazar,
+  `datetime` cihazın yerel gününe kovalanır.
+- Bağlıyken bölümleme tanımdan okunur; `groupBy`/`sectionOrder`/`otherSectionTitle`/`stickySectionHeaders`/
+  `showCounts` prop'ları yok sayılır. Bağsız (`rows` ifadeyle) gruplu liste: `platform_guide('mobile')`
+  §Güne göre görev listesi.
+
+## Kurallar
+
+| Kod | Ne zaman | Ne yapılır |
+|---|---|---|
+| CD-004 | `mobileRow` parçası lookup alanı değil; `mobileCard` parçası seçili yol değil | alanı seçime ekleyin ya da parçayı değiştirin |
+| CD-019 | gruplu liste `grouping`siz; tarih dışı alanda `dateBucket` | `grouping { by, sectionOrder }` verin |
+| CD-020 | `grouping` gruplama adımı bildirmeyen bileşende | `grouping`i kaldırın |
+| PAGE-035 | `mobileMode` `sheet`/`fullscreen` dışında | iki değerden birini yazın |
+| CD-013 | `grouping` entity dışı kaynakta | entity kaynağı kullanın |

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

@@ -0,0 +1,64 @@
+# Mobil akış adımları rehberi
+
+Mobil uygulamada (`type:'mobile'`) akış motoru web'deki motorun aynısıdır (`platform_guide('page')`, `flow_create`).
+Bu rehber yalnız barındırıcıya — cihaza — dokunan adımların telefondaki sözleşmesini ve tariflerini anlatır.
+Ekranın kendisi, sayfa olayları (`mount` · `focus` · `destroy`) ve uzak push `platform_guide('mobile')`'dadır.
+
+## Adımlar
+
+Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `function`, `flow-trigger`,
+`validation`) iki platformda aynıdır. Barındırıcıya dokunan adımlar:
+
+| Adım | Mobilde |
+|---|---|
+| `redirect` | yığına iter (göreli yol) ya da dışarıda açar (tam adres) |
+| `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')`) |
+| `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 |
+| `share` | RN paylaşım sayfası (metin + bağlantı; Android'de bağlantı metne eklenir, `title` iOS'ta e-posta konusu, Android'de seçici başlığı); akış `always` ile sürer — iOS'ta sayfa kapanınca, Android'de seçici açılır açılmaz (RN kapanışı bildirmez). Argümanlar `platform_guide('page')` §`share` adımı |
+| `haptic` | dokunsal geri bildirim (`expo-haptics`, izin istemez). `args.value` stil, **düz metin**: `success` · `warning` · `error` · `light` · `medium` · `heavy` · `selection`; boş → `medium`. Değer yazmaz, hep `always`. Web'de titreşim varsa kısa titreşim, yoksa hiçbir şey (paletten yalnız mobilde sunulur) |
+| `location` | cihaz konumu (`expo-location`; ilk kullanımda izin sorulur; derleme konumu taşımıyorsa sorulmaz, `error` dalı `status: 'unavailable'`). `args.value` doğruluk, düz metin: `low` · `balanced` · `high` (boş → `balanced`); `args.isRaw: true` → adres çözülmez. Sonuç `Steps.<adım>.data = { latitude, longitude, accuracy, address }`, `address = { country, region, subregion, city, district, street, postalCode }` ya da `null` (Türkiye'de il `region`, ilçe `subregion`, yoksa `city`). İzin reddi `Steps.<adım>.error = { status: 'denied', message }`, okunamayan konum `unavailable`: adımın `error` dalı bağlıysa o koşar (`always` koşmaz), yoksa akışın hata akışı, o da yoksa `always` (`data: null`). Web'de tarayıcı konumu, adres hep `null` |
+| `notification-permission` | bildirim izni ister (sorulmuşsa yeniden sormaz, kalıcı red yeniden sorulmaz). Sonuç `Steps.<adım>.data.status`: `granted` · `denied` · `undetermined`; red hata değildir, hep `always` |
+| `notification-schedule` | yerel bildirim planlar (`expo-notifications`; uzak push değil). `args.name` kimlik ve `args.title` başlık **metin şablonudur** — yalnız `{{ }}` içi çözülür (`'ilac-{{ item.id }}-0800'` kayıt başına ayrı kimlik, `"{{ t('ilac.vakti') }}"` çeviri; `{{ }}` dışındaki ifade çözülmez, FLOW-022); aynı kimlik eskisinin yerini alır. `args.message` gövde (**ifade**), `args.value` zaman (**ifade**): sonucu `'HH:mm'` → her gün, `{ weekday: 1–7, time: 'HH:mm' }` → her hafta (1 = Pazartesi), ISO tarih-saat → bir kez. `args.path` dokununca açılacak sayfanın slug'ı, düz metin — şablon çözmez (+ `args.query` ifade), boşsa uygulama açılır. İzin yoksa `error.status: 'denied'`, geçmiş ya da okunamayan zaman `invalid`: `error` dalı → hata akışı → `always`. Web'de desteklenmez (`unsupported`) — sayfa kapalıyken tarayıcı gösteremez |
+| `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 |
+| `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 |
+
+## Bildirim ve izin
+
+Bildirim adımları paletten yalnız mobil uygulamada sunulur. Tarif — S04 "her gün hatırlat": önce
+`notification-permission` (S03 düğmesi), sonra `timepicker`'ın değeriyle `notification-schedule`
+(`value: "<saat>.value"`, değer `HH:mm`) ve `error` dalında kullanıcıya mesaj. Çevrimdışı bandı adım değil
+ifadedir: `isHidden: {{ Device.isOnline }}` (`platform_guide('expressions')`).
+
+**İzin tarifi** (izin, ihtiyaç anında — düğmeye basılınca — istenir; sayfa açılışında değil): `permission`
+`check` → `condition`, **bu sırayla**: `status === 'granted'` ise işe devam; `'unavailable'` ise özelliği sunma
+(Ayarlar'da açılacak izin yoktur — `canAskAgain` burada da `false` gelir); `canAskAgain` ise `permission` `request`
+ve sonucuna göre devam; değilse nedenini söyleyip `open-settings`. `location` adımı, `map.showUser` ve dosya alanının
+kamera/galeri kaynağı izni kendileri de ister — `permission` adımı *ne zaman* sorulacağını seçmek ve sonucu
+okumak içindir. `unavailable` bir hata değil, derlemenin o izni taşımadığının haberidir
+(`platform_guide('mobile-publish')` §İzinler).
+
+## Reklam
+
+**Reklam tarifi** (kök ADR 0012): (1) `mobile_store_update { settings: { ads: { enabled: true, iosAppId, androidAppId,
+testMode: true, units: [{ name, format, ios, android }] } } }` — reklam, App ID'si olan platformun derlemesine `tracking`'i de sokar (ATT metni
+gider, kip `off` olamaz); (2) banner için sayfaya `adBanner` `unit: '<banner yerleşimi>'`; (3) geçiş/ödüllü reklam için
+düğme akışına `ad-show` `value: '<yerleşim>'`, `error` dalında reklamsız devam; (4) ödül `condition`:
+`Steps.<adım>.data?.reward` doluysa ödülü ver. Açılış reklamı adım değil ayardır (`ads.appOpenUnit`). Sıra cihazda:
+rıza formu → açılış izinleri (ATT) → SDK; iOS'ta izleme izni yoksa reklam kişiselleştirilmeden istenir. Yerleşim adının
+ayarda tanımlı olduğu sayfa/akış yazımında denetlenemez — `mobile_store_get` `settings.ads.units` ve `adsWarnings`
+(`MOB-026`); yayın ayrıntısı `platform_guide('mobile-publish')` §Reklamlar.
+
+## Konum ve harita
+
+`style`, `accuracy`, `reverseGeocode` gibi anahtarlar sözleşmede yoktur ve platform onları sessizce düşürür
+(`FLOW-029`). "Haritada aç" için adım yoktur: `map`'in `press` olayı düğüme `mapsUrl` yazar, akış
+`redirect` `isRaw: true`, `path: '<harita>.mapsUrl'` ile açar. Tarif — L05 "mevcut konumumu kullan":
+düğmenin `click`'i → `location` (`always` → setter `il.value = Steps.konum.data.address?.region`, `error` →
+setter hata metni). Uzak push (sunucudan gelen bildirim): `platform_guide('mobile')` §Uzak push.

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

@@ -5,23 +5,96 @@ hata kodları. Uygulamanın kendisi (ekranlar, akışlar, uzak push gönderimi)
 
 ## Genel
 
-Mağaza derlemesi bir Mac runner'da koşar; uygulama **production ortamını** okur (yükleme için açılış sayfası
-production'a dağıtılmış olmalı; yalın `build` onsuz da derlenir, uygulama "yayımlanmamış" ekranını gösterir). Mağaza bilgisi ortam değil uygulama düzeyindedir (Core DB), dağıtımla kopyalanmaz.
+Mağaza derlemesi bir Mac runner'da koşar; uygulama işin **ortamını** okur — boşsa production (yükleme için
+açılış sayfası o ortamda olmalı, production'da dağıtılmış olmalı; yalın `build` onsuz da derlenir, uygulama
+"yayımlanmamış" ekranını gösterir). Mağazaya yalnız production işinin derlemesi gider (§Test derlemesi). Mağaza
+bilgisi ortam değil uygulama düzeyindedir (Core DB), dağıtımla kopyalanmaz.
+
+## Yolculuk
+
+Studio › Yayınla sekiz adımdır; 1–5 ortak (3'ün test derlemesi platform başına), 6–8 iOS ve Android için ayrı
+sekmede yürür (biri de tek başına yayınlanabilir):
+
+1. **Production'dan çıkar** — uygulama production ortamını okur; hangi mağazaya gidileceği
+   (`settings.releaseTargets`) burada seçilir.
+2. **Telefonunda dene** — Zeyrek Mobile ile (`platform_guide('mobile')` §Cihazda dene).
+3. **Test sürümü** — üç bölüm: kimlik ve sürüm · Apple hesabı · Google Play hesabı; ardından isteğe bağlı test
+   derlemesi (TestFlight / Play iç test, istenen ortamdan — §Test derlemesi) ve test kullanıcıları.
+4. **Yayına hazırla** — yedi bölüm: mağaza metinleri · görseller · yaş derecelendirmesi · gizlilik · beyanlar ·
+   sürüm, fiyat, yayın · konsolda kalanlar. Ajanın `mobile_store_update` / `mobile_asset_*` yolu; 3 ve 4'ün iş
+   tarifi MCP prompt'u `mobile_publish_prepare`'dir.
+5. **Canlıya al** — iki tür güncelleme (aşağıda).
+6. **Son kontrol** — mağaza ön kontrolü (`scope: 'store'`); aynı düğme derlemeyi başlatır (`mobile_build_start`:
+   iOS `testflight`, Android `internal`; Android'de paket türü).
+7. **Derle** — işin ilerlemesi ve sonucu (`mobile_build_status`).
+8. **Mağazada yayınla** — incelemeye gönder, yayınla, kanala taşı: insan onayıyla Studio'da.
+
+**Doldurmadan ilerlenmez.** Studio sonraki adımı kilitler: 3'te kimlik ya da bu sürümün gittiği mağazanın hesap
+bölümü eksikken 4'e (test derlemesi kapı değildir), 4'te eksik bölüm varken 5'e (konsol bölümü elle yapılır,
+kilide girmez), 5'te production'a gitmemiş değişiklik varken (`detail: ['changes']` → `live` dolu) 6'ya, 6'da
+bu platformun mağaza işi yokken 7'ye, 7'de başarıyla biten iş yokken 8'e geçilmez. 3'teki test işi 6–8'i açmaz.
+Ajan kullanıcıyı "sonraki adıma geç" diye yönlendirmeden önce o adımın koşulunu karşılar.
+
+## Test derlemesi
+
+Yayınla 3 · Test sürümü, mağaza hazırlığından ve canlıya almadan **önce** TestFlight'a / Play iç test kanalına bir
+derleme gönderir. İsteğe bağlıdır; her başlatma derleme numarası ayırır ve kimliği kilitler.
+
+- **Ortam:** `mobile_build_start { platform, target, environment, dryRun: true }` — `environment` ortamın adı ya da
+  slug'ı: `development`, `production` ya da `Ready` durumdaki bir dal; boş = production. Yalnız `build`,
+  `testflight`, `internal` alır; yükseltme hedefinde gateway istek gitmeden reddeder. Etkin olmayan
+  ortam ya da hazır olmayan dal backend'de 422 `environment`. Yanıt ve `mobile_build_status` işin `environment`'ını
+  taşır.
+- **Ön kontrol `scope: 'test'`** (environment verilince kendiliğinden; `'store'` ile birlikte reddedilir, yükseltme
+  hedefinde verilmez). Yalnız test yüklemesinin istediğini sorar:
+
+  | Satır | `scope: 'test'` |
+  |---|---|
+  | P-01 | yalnız kimlik: `displayName`, `bundleIdentifier`, `androidPackage`, `scheme`, `version`, sayaçlar (metin ve Play sürüm notu sınırı yok) |
+  | P-03, P-04, P-05, P-07, P-08, P-09 | aynı (hesap ve imza, konsolda uygulama kaydı, https, etkin iş, runner) |
+  | P-06 | seçilen ortamda: production dışında `ok environment_ready` / `fail environment_page_missing` |
+  | P-11 | aynı kurallar, `fail` → `warn` (push eksikliği testi durdurmaz) |
+  | P-12, P-14 | seçilen ortamın kullanımı ve akışları |
+  | P-13 | `manual ads_test_mode` yok (test kipi testte beklenir) |
+  | P-02, P-10, P-15…P-21 | sorulmaz — metin, görsel, beyan ve App Review kuralları mağazaya giden işte |
+
+- **Yayın kaynağı yalnız production işidir.** Production'dan alınan ve testte beğenilen derleme sonradan yeniden
+  derlenmeden incelemeye (`app-store-review`) ya da kanala (`play-promote`) gider. Development ya da dal derlemesi
+  **asla** mağazaya yükseltilemez ve daha yeni olsa da production işini gölgelemez. Dal merge'ten sonra silinir; o
+  dalın test derlemesi açılamaz olur.
+- Development ya da dal derlemesi test edene o ortamın verisini açar; ortamın erişim kipi `off` ise korumalı alanlar
+  uygulanmaz — ortamı seçerken kullanıcıya söyleyin.
+- **Play taslak uygulama:** Play'de hiç yayınlanmamış uygulamada API yalnız `draft` sürüm açabilir; ilk iç test
+  yayını Play Console'dan elle başlatılır (`play.releaseStatus` ayarı korunur).
+- TestFlight **dış** test grubu (Test bilgisi, Beta App Review) bu yolun dışındadır; test kullanıcıları iç test
+  ekibine Studio'dan davet edilir.
+
+## İki tür güncelleme
+
+`mobile_store_get { detail: ['changes'] }` son production dağıtımından beri değişenleri iki kovada döner:
+`live` (sayfa, akış, uç — production'a dağıtılınca telefonlara dakikalar içinde gider, mağaza gerekmez;
+dağıtım insan onaylıdır) ve `store` (izin, kimlik, görsel, kabuğun taşıdığı ayar — yeni mağaza sürümü ve
+1–3 gün inceleme ister → adım 6). Kova boşsa o tür güncelleme gerekmez.
 
 ## Kim ne yapar
 
 **Ajanın yaptığı:** `mobile_store_get` (ayar, kilitli alanlar, görsel sayısı, beyanlar; `manifest: true`;
-`detail: ['assets','signing','runners','audit']` id'li görseller, maskeli kimlik bilgisi/hesap, runner, denetim) ·
+`detail: ['assets','signing','runners','audit','status','changes']` id'li görseller, maskeli kimlik bilgisi/hesap,
+runner, denetim, mağaza durumu, iki kova) ·
 `mobile_store_update` (`settings` yaması · `declarations` · `registerAppleBundleId`) · `mobile_asset_create` /
-`_update` (sıra) / `_delete` · `mobile_build_start` (`dryRun`, `runnerScope`) · `mobile_build_status` ·
-`mobile_build_log` · `mobile_build_cancel`.
+`_update` (sıra) / `_delete` · `mobile_build_start` (`dryRun`, `environment`, `scope`, `runnerScope`, `runnerId`, `packageType`) ·
+`mobile_build_status` · `mobile_build_log` · `mobile_build_cancel`.
 
 **Beyan kullanıcınındır:** `declarations` (App Privacy, Data safety, içerik derecelendirme, hedef kitle,
 uygulama erişimi) yalnız kullanıcı formu mağazada doldurduğunu onaylayınca `true` yazılır.
 
 **İnsanın Studio › Yayın › Hesaplar'da yaptığı (MCP'de araç yok):** Apple/Google hesabı, sertifika, profil,
 keystore, harita anahtarı, demo parolası, push kimlikleri — APNs anahtarı, Firebase hesabı,
-`google-services.json` (gizli bilgi) ve runner kaydı. `review.demoPassword` şemada reddedilir.
+`google-services.json` (gizli bilgi) ve runner kaydı. `review.demoPassword` şemada reddedilir: App Review demo
+hesabı (P-15) Studio'da girilir. **Test kullanıcıları** (TestFlight davetleri, Play test grubu ve katılım
+bağlantısı) Studio › Yayınla'dan davet edilir — kişisel e-posta taşıdığı için MCP'de araç yok. **Mağazaya
+gönderim** (adım 8: `app-store-review`, `app-store-release`, `play-promote`) geri dönüşsüz ya da insan onaylıdır;
+ajan yalnız `dryRun` ile ön kontrolünü okur ve kullanıcıyı Studio'ya yönlendirir.
 
 **Ekran görüntüsü:** `page_screenshot { environment: 'production', device, format: 'jpeg', quality: 92,
 language, colorScheme: 'light', outPath }` → `mobile_asset_create { path, kind: 'screenshot', deviceClass, locale }`.
@@ -44,36 +117,90 @@ ikon/splash/öne çıkan görsel tekli yuvadır: yeni yükleme eskisinin yerine
 ## Hedefler
 
 `build` (iki platform, yalnız derler) · `testflight` (yalnız iOS) · `internal` (yalnız Android, Play
-iç test). TestFlight'ta runner yükledikten sonra iş `running` + `store_processing` kalır (`awaitingStore`),
+iç test). 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
 tamamlandı / başarısız / iptal edildi, mağaza yüklemeyi işliyor).
-TestFlight'ta derleme yüklenip mağaza metni/ekran görüntüleri reddedilirse iş yine tamamlanır;
-`storeResult.listingError` (hata kodu, ör. `store_rejected`) + `listingMessage` (ne yapılacağı) gelir. Derleme
-TestFlight'tadır, numara harcanmıştır: metni düzeltip yeni sürüm yüklemek gerekir, işi yeniden başlatmak aynı
-metni yeni numarayla yeniden dener.
+`testflight` ve `internal` yalnız ikiliyi yükler; mağaza metni, ekran görüntüleri ve inceleme bilgisi yükseltme
+işinde gider (iOS `app-store-review`, Android `play-promote` `production` kanalına). Eski TestFlight işlerinde
+görülen `storeResult.listingError` + `listingMessage` o işin metin yüklemesinin reddidir; derleme yine TestFlight'tadır.
+
+## Mağaza yayını
+
+Yayın hedefleri önceki adımın derlemesini taşır (yeni derleme yapmaz): `app-store-review` son TestFlight
+derlemesini incelemeye gönderir, `app-store-release` onaylanan sürümü yayınlar, `play-promote` son iç test
+derlemesini `releaseTrack` kanalına (`closed` | `production`) taşır. Kaynak yalnız **production işinin** derlemesidir
+(development / dal test derlemesi sayılmaz); yoksa P-22 `fail`. Yükseltme hedefi `environment` ve `scope: 'test'` almaz.
+**MCP'den yalnız `dryRun`**: gerçek çağrı `release_target_studio_only` ile durur, hiçbir iş açılmaz. App Review'a ek
+görsel: `mobile_asset_create { kind: 'reviewAttachment' }` (dilsiz; yalnız `app-store-review` gönderimine girer).
+
+`mobile_store_get { detail: ['status'] }` → `status.apple` (`appStoreState`, sürüm, kademeli durum),
+`status.play.tracks[]` (kanal, durum, `versionCodes`, `rolloutPercent`) ve `status.actions[]`: Studio'daki
+yayın düğmeleri, her biri `irreversible` + `consequence` (ne olacağı, istek dilinde). `irreversible: true`
+geri alınamaz (App Store'da yayın, Play üretim kanalı; `releaseType` `manual` değilse incelemeye göndermek de) —
+kullanıcıya `consequence`'ı aynen söyleyin.
+
+Yayın ayarı (`mobile_store_update { settings }`, MOB-022 aynası): `apple.releaseType` `manual` (varsayılan) ·
+`automatic` · `scheduled` (+ ileri `scheduledAt`), `apple.phasedRelease` (7 güne yayılan otomatik
+güncelleme), `apple.pricing` `free` | `tier-1…tier-87`, `apple.territories` `['all']` ya da ISO alfa-3 kodları
+(gönderim yalnız EKLER; satıştan kaldırma App Store Connect'te), `play.contactPhone` (E.164),
+`play.contactWebsite` (https), `play.promoVideoUrl` (YouTube), `play.rolloutPercent` 1–100 (üretim kanalı;
+boş = 100).
+
+## Yaş derecelendirmesi
+
+`settings.apple.advisory` Apple'ın yaş anketidir: soru anahtarı → cevap (metin). Ön kontrol (P-21) tek cevabı
+yeterli sayar, ama App Store Connect beyanı **her soru cevaplı** değilse reddeder ve Studio'nun bölümü de
+ancak hepsi cevaplıyken tamamdır. Bütün soruları yazın (yama `advisory`'yi anahtar anahtar birleştirir;
+yazılmayan soru boş kalır).
+
+- Sıklık soruları — `NONE` · `INFREQUENT_OR_MILD` · `FREQUENT_OR_INTENSE`:
+  `alcoholTobaccoOrDrugUseOrReferences`, `contests`, `gamblingSimulated`, `gunsOrOtherWeapons`,
+  `horrorOrFearThemes`, `matureOrSuggestiveThemes`, `medicalOrTreatmentInformation`, `profanityOrCrudeHumor`,
+  `sexualContentGraphicAndNudity`, `sexualContentOrNudity`, `violenceCartoonOrFantasy`, `violenceRealistic`,
+  `violenceRealisticProlongedGraphicOrSadistic`.
+- Evet/hayır soruları — `'true'` · `'false'` (metin):
+  `advertising`, `ageAssurance`, `gambling`, `healthOrWellnessTopics`, `lootBox`, `messagingAndChat`,
+  `parentalControls`, `socialMedia`, `socialMediaAgeRestricted`, `unrestrictedWebAccess`, `userGeneratedContent`.
+- `kidsAgeBand` (isteğe bağlı): boş = Çocuklar kategorisinde değil; `FIVE_AND_UNDER` · `SIX_TO_EIGHT` ·
+  `NINE_TO_ELEVEN`.
+
+Cevap uygulamanın içeriğinden çıkar (sayfalar, akışlar, reklam ayarı: `settings.ads.enabled` → `advertising`);
+emin olunmayan soru kullanıcıya sorulur. Google Play'in IARC anketi konsoldadır (insan).
 
 ## Ön kontrol
 
-`mobile_build_start { dryRun: true }` yalnız `ok` OLMAYAN satırları döner (`okCount` gerisini sayar).
+`mobile_build_start { dryRun: true }` yalnız `ok` OLMAYAN satırları döner (`okCount` gerisini sayar). Tablo
+`scope: 'store'` (varsayılan) içindir; `scope: 'test'` farkı §Test derlemesi'nde.
 
 | id | Kod (`fail`) | Nerede düzelir |
 |---|---|---|
-| P-01 | `settings_incomplete`; Android `internal`'da `release_notes_too_long` (bir dilde `releaseNotes` > 500 — Play sınırı; ayar 4000'e izin verir çünkü App Store'a da gider; ikisi birlikteyse tek satırda iki cümle) | `mobile_store_update` |
+| P-01 | `settings_incomplete`; Android `internal`'da `release_notes_too_long` (bir dilde `releaseNotes` > 500 — Play sınırı; ayar 4000'e izin verir çünkü App Store'a da gider; ikisi birlikteyse tek satırda iki cümle). Mesaj alanları istek dilinde adlandırır ("başlık (English)", "gizlilik politikası adresi"), ayar yolunu değil — yol `mobile_store_get`'ten | `mobile_store_update` |
 | P-02 | `assets_missing` | `mobile_asset_create` |
 | P-03 | `secrets_missing`, `secrets_unreadable`, `signing_expired` (`warn signing_expiring`) | Studio › Yayın › Hesaplar |
 | P-04 | `apple_account_missing`, `asc_bundle_id_missing`, `asc_app_missing`, `asc_unauthorized`, `asc_forbidden`, `asc_unreachable` | `asc_bundle_id_missing`: `mobile_store_update { registerAppleBundleId: true }`. `asc_app_missing`: App Store Connect'te uygulama kaydı (API açamaz, insan açar). Diğerleri: Studio hesabı |
 | P-05 | `google_account_missing`, `play_app_missing`, `play_unauthorized`, `play_forbidden`, `play_unreachable` | Play Console'da uygulama + servis hesabı yetkisi |
-| P-06 | `production_missing`, `production_page_missing` (yalın `build`'de `warn`, başlatmayı engellemez) | production ortamı ve dağıtım — insan onaylı, ajan yapmaz |
+| P-06 | `production_missing`, `production_page_missing` (yalın `build`'de `warn`, başlatmayı engellemez); production dışı `environment` ile `fail environment_page_missing` | production ortamı ve dağıtım — insan onaylı, ajan yapmaz; başka ortamda açılış sayfası o ortamda |
 | P-07 | `https_required` | platform ayarı (destek) |
 | P-08 | `build_active` | etkin işi bekle ya da `mobile_build_cancel` |
 | P-09 | `runner_offline` | runner Mac'te `zeyrek-mobile-runner run` |
 | P-10 | `manual declarations_pending` | kullanıcı onayıyla `mobile_store_update { declarations }` (engellemez) |
 | P-11 | push (yalnız `testflight` / `internal`): `warn push_incomplete` (kimlik eksik — derleme push'suz çıkar); `push_unreadable` (kimliğin şifresi çözülemiyor), `push_profile_stale` (profil APNs anahtarından önce üretilmiş), `push_firebase_mismatch` (`google-services.json` başka Firebase projesinin), `push_package_mismatch` (dosya yüklendikten sonra Android paket adı değişmiş), `push_shell_outdated` (kabuk paketi push taşımıyor) | Studio › Yayın › Hesaplar ve kimlik bilgileri (insan yükler); `push_profile_stale`: profili yeniden üret; `push_shell_outdated`: platform ayarı (destek). Push kapalı ya da hazırsa satır `ok`'tur ve dryRun'da görünmez — hazır olduğunu `mobile_store_get { manifest: true }` → `manifest.push` söyler |
-| P-12 | izinler: `warn permissions_shell_outdated` (yayındaki kabuk izin kümesini taşımıyor: sabit izinler bildirilir, kamera çalışmaz, kipler uygulanmaz — başka P-12 satırı çıkmaz); kabuk taşıyorsa `fail permission_off_in_use` (kip `off` ama production o izni yazılı olarak kullanıyor) ya da `warn launch_permissions_shell_outdated` (açılışta sorulan izin var, kabuk açılışta sormuyor; kabuk kümeyi de taşımıyorsa bu cümle ilk uyarının iletisine eklenir) | `mobile_store_update { settings: { permissionModes } }` ya da kullanımı kaldırıp dağıtım; açılış uyarısında daha yeni kabuk ya da izni akış adımından isteme |
+| P-12 | izinler: `warn permissions_shell_outdated` (yayındaki kabuk izin kümesini taşımıyor: sabit izinler bildirilir, kamera çalışmaz, kipler uygulanmaz — başka P-12 satırı çıkmaz); kabuk taşıyorsa `fail permission_off_in_use` (kip `off` ama production o izni yazılı olarak kullanıyor), `warn permission_shell_outdated` (derlemenin taşıdığı izin yayındaki kabuktan yeni — katalog satırının `minShellVersion`'ı, ör. `biometric` 0.6.0; manifest o izni yazmaz, açılış uyarısı varsa iletisine eklenir) , `warn launch_permissions_shell_outdated` (açılışta sorulan izin var, kabuk açılışta sormuyor) ya da `warn app_lock_shell_outdated` (uygulama kilidi açık, kabuk 0.6.0'dan eski: mağaza sürümü kilitsiz açılır); kabuk uyarıları tek satırda birleşir — kod ilk uyarınındır, ileti hepsini söyler, kabuk kümeyi de taşımıyorsa açılış ve kilit cümleleri `permissions_shell_outdated`'ın iletisine eklenir | `mobile_store_update { settings: { permissionModes } }` ya da kullanımı kaldırıp dağıtım; açılış uyarısında daha yeni kabuk ya da izni akış adımından isteme |
 | P-13 | reklam (yalnız `ads.enabled`): `warn ads_app_id_missing` (bu platformun AdMob App ID'si yok — derleme reklamsız çıkar), `warn ads_shell_outdated` (yayındaki kabuk reklam taşımıyor), yükleme hedefinde `manual ads_test_mode` (test kipi açık: mağazada test reklamı görünür), değilse `ok ads_ready` (yerleşim sayısıyla) | `mobile_store_update { settings: { ads } }`; test kipini yayından önce `testMode: false` |
 | P-14 | kod tarama (yalnız production akışlarında `scan-code` adımı varsa): `warn scan_shell_outdated` (yayındaki kabuk tarayıcıyı taşımıyor — derleme çıkar, adım `error` dalıyla biter); taşıyorsa `ok scan_ready`. Kamerayı yalnız dosya alanı kullanıyorsa satır hiç gelmez | yeni kabuk paketi (destek); ajan düzeltemez |
+| P-15 | App Review satırları P-15…P-21 yalnız iOS yükleme hedeflerinde (`testflight`, `app-store-*`); sinyal okunamazsa `manual review_signals_unreadable`. P-15 demo hesabı: giriş varsa ve demo hesabı yoksa `review_demo_missing` | Studio › Yayın › Hesaplar (demo hesabı gizli bilgidir) |
+| P-16 | `manual screenshot_source_unverified` (ekran görüntüsü uygulamanın gerçek ekranı mı — 2.3.3); hiç iOS ekran görüntüsü yoksa satır yok (eksikliği P-02 söyler) | kullanıcı doğrular |
+| P-17 | `app_name_missing`, `app_name_too_long` (> 30); `warn`: adda yasak terim, anahtar kelime adı tekrarlıyor | `mobile_store_update { settings: { listing } }` |
+| P-18 | giriş varsa `manual third_party_sign_in_unverified` (üçüncü taraf girişte Apple ile giriş — 4.8) | kullanıcı doğrular |
+| P-19 | `privacy_policy_missing` | `settings.urls.privacyPolicy` |
+| P-20 | kendi kaydı olan uygulamada hesap silme yolu görülmezse `manual account_deletion_unverified` (5.1.1(v)) | ekran + kullanıcı doğrular |
+| P-21 | `age_rating_missing` (yaş derecelendirmesi yanıtsız) | `settings.apple.advisory` |
+| P-22 | yayın hedefinde `release_source_missing`: kaynak derleme yok (`testflight` → `app-store-review` → `app-store-release`, `internal` → `play-promote`) | önce kaynak hedefi derle |
 
-Satırın `message` ve `fixHint`'i backend'den, istek dilinde gelir.
+`manual` satır başlatmayı engellemez ama kullanıcıya söylenir; `fail` engeller. Satırın `message` ve `fixHint`'i
+backend'den, istek dilinde gelir.
 
 ## İzinler
 
@@ -126,6 +253,24 @@ yerleşim o platformda yoktur. Biçim hatası `MOB-022` ile yazılmadan durur.
 - `mobile_store_get` reklam açıkken `adsWarnings` döner (`MOB-026`): test kipi, App ID'si olan platformda birimi olmayan
   yerleşim, konsol beyanları (App Privacy, Data safety, AdMob rıza mesajı — insanın işi).
 
+## Uygulama kilidi
+
+Mağaza sürümünün Face ID / parmak izi / cihaz parolasıyla kilitlenmesi (kök ADR 0021 madde 8–11) bir mağaza ayarıdır:
+`settings.appLock = { enabled, timeoutSeconds }`, süre `0` (her dönüşte) · `60` · `300` · `900` saniye. Yama alan alan
+birleşir (`{ appLock: { timeoutSeconds: 300 } }` açık/kapalıyı korur).
+
+- Açık kilit `biometric` için bir kullanımdır (`usage` içinde `source: lock`): izin `auto` kipte derlemeye girer.
+  `permissionModes.biometric` `off` iken kilit açılamaz, açık kilitle kip `off` yapılamaz (422 `appLock.enabled`;
+  gateway birleşik kayıtta istek gitmeden durdurur, `MOB-022`).
+- Bir sonraki mağaza derlemesiyle etkili olur. Kilit kabuğun ayrı bir yeteneğidir (kabuk paketi ≥ 0.6.0): görünümde
+  `shell.carriesAppLock: false` ise ayar saklanır ama manifest `appLock` yazmaz, uygulama kilitsiz açılır
+  (`permissionWarnings` `MOB-031`; ön kontrol P-12 uyarır — kabuk 0.5.x'te kod `app_lock_shell_outdated`, daha eski kabukta
+  cümle o kabuğun ilk P-12 uyarısına eklenir, aynı satırda `fail permission_off_in_use` varsa kilit cümlesi görünmez).
+- Davranış: soğuk açılışta ve arka planda süre dolup dönüşte kilit ekranı, ardından sistem penceresi; içerik kilit
+  açılmadan çizilmez, oturum kapanmaz. Cihazda biyometri de parola da yoksa kilit atlanır. iOS'ta uygulama değiştirici
+  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')).
+
 ## Hata kodları
 
 `mobile_build_status` → `error.code`.

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

@@ -28,6 +28,7 @@ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `functi
 | `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 |
 | `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` |
 
 ## Bildirim tarifi
@@ -35,7 +36,10 @@ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `functi
 Bildirim adımları paletten yalnız mobil uygulamada sunulur. Tarif — S04 "her gün hatırlat": önce
 `notification-permission` (S03 düğmesi), sonra `timepicker`'ın değeriyle `notification-schedule`
 (`value: "<saat>.value"`, değer `HH:mm`) ve `error` dalında kullanıcıya mesaj. Çevrimdışı bandı adım değil
-ifadedir: `isHidden: {{ Device.isOnline }}` (`platform_guide('expressions')`).
+ifadedir: `isHidden: {{ Device.isOnline }}` (`platform_guide('expressions')`) — ağı CANLI izler, ekran açıkken bağlantı
+gidince çıkar. Kabuğun kendi bandı ayrıdır: yalnız sayfa isteği (açılış ya da yenileme) düşünce çıkar — ağ yoksa
+"Çevrimdışı · son güncelleme …", sunucu 5xx dönerse "Yenilenemedi". İkisi aynı anda görünebilir; sayfa bandını
+ekranın tepesine değil, anlattığı verinin yanına koyun (`platform_guide('page')` §Kural 1g-4).
 
 ## İzin tarifi
 
@@ -58,6 +62,22 @@ rıza formu → açılış izinleri (ATT) → SDK; iOS'ta izleme izni yoksa rekl
 ayarda tanımlı olduğu sayfa/akış yazımında denetlenemez — `mobile_store_get` `settings.ads.units` ve `adsWarnings`
 (`MOB-026`); yayın ayrıntısı `platform_guide('mobile-publish')` §Reklamlar.
 
+## Biyometri tarifi
+
+**Biyometri tarifi** (kök ADR 0021): (1) onaylanacak düğmenin akışına `biometric-auth` `args: { title: 'Ödemeyi
+onaylayın' }`, işi `always` dalına, kullanıcıya söylenecek olanı `error` dalına (`Steps.<adım>.error.status`) bağlayın —
+hata yolu yoksa vazgeçen kullanıcıda akış biter; (2) "bu cihazda biyometri yok" metni `isHidden: {{ Device.biometric.available }}`
+(`Device.biometric = { available, enrolled, kinds }`, `platform_guide('expressions')`). Nerede ne olur: Studio önizlemesi,
+canlı kip, `/dev` ve `/branch` sormaz — "Doğrulandı say" / vazgeç penceresi açar (`Device.biometric` orada açık, kayıtlı,
+yüz); production `/view` ve web uygulaması `unsupported` döner. Oynatıcıda (Expo Go) yedeği `device` olan adım çalışır,
+`none` olan her zaman `unavailable`. Mağaza derlemesi biyometriyi yalnız production'da kullanılıyorsa ya da uygulama kilidi açıksa taşır (izin satırı
+`biometric`, Face ID metni `mobile_store_update { settings: { permissions: { biometric } } }`, kabuk 0.6.0+). `biometric`
+**sorulamayan izindir**: `permission` adımının türü olamaz, açılışta sorulamaz (422). Uygulamanın tamamını açılışta
+kilitlemek adım değil mağaza ayarıdır (`settings.appLock`, `platform_guide('mobile-publish')` §Uygulama kilidi). `page_screenshot` pencereyi
+sürer: adımı tetikleyen tıklamanın raporu `pageState: 'awaiting-user'` der, sonraki eylem `{ action: 'click', target:
+'preview-biometric__verify' }` (Doğrulandı say) ya da `'preview-biometric__cancel'`. Tam gövde:
+`ngapps://examples/flow-biometric-confirm`.
+
 ## 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

@@ -20,8 +20,10 @@ anlamları ayrı.
    `page_update({ layoutId })` × N → `application_update({ homepageId, properties.mobile.tabs })`.
    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.
-3. **Ekranlar.** `page_schema_patch` ile bileşen ekle, akış bağla (`flow_create` → `set_event`).
+   Sayfa akışı `microservice` adımıyla aynı uçları çağırır. Veri bağlamanın telefon
+   kararları: `platform_guide('mobile-connect-data')`.
+3. **Ekranlar.** `page_schema_patch` ile bileşen ekle, akış bağla (`flow_create` → `set_event`). Cihaza
+   dokunan adımlar (izin, konum, bildirim, reklam, geri, kod tarama): `platform_guide('mobile-steps')`.
 4. **Doğrulama.** `page_screenshot` (mobilde varsayılan `device: 'phone'`, 390x844 @2) ve
    `page_runtime_get({ resolveStyles: true })` (düğümün React Native stili). Ayrıntı §Doğrulama.
 
@@ -119,12 +121,9 @@ mobil bileşenlere geçen notlar). Web'de karşılığı olmayan bileşende (`ap
 - **Dönen kart ve kart destesi** (2026-10-08): `flip-card` (children = [ön `view`, arka `view`]; `isFlipped`,
   `flip`) ve `swipeable-stack` (`repeater` şekli: [kart `view`, boş `view`], `rows`, `currentIndex`;
   `swipeLeft` / `swipeRight` / `finish` yükü `event.data`) mobile özgüdür.
-- **Faz 10** (FlutterFlow D listesi): `datatable` web ikizidir — kolon biçimi, sıralama ve sayfa hesabı web'in
-  modülünden, akış sözleşmesi aynı (sıralama/sayfa değişince `sortField`/`sortType`/`offset` düğüme yazılır ve
-  `mount` yeniden koşar; satır eylemi `selectedRow`u yazıp eylemin akışını koşturur). Mobile özgü `variant`:
-  `table` (varsayılan, yatay kaydırılan tablo; başlığa dokunuş `__sort-<kolon>`) ya da `cards` (satır başına
-  kart). Eylemler `__action-<satır>-<sıra>`, `dropdown` kipinde `__more-<satır>` → alttan eylem sayfası;
-  sayfa çubuğu `__page-prev`/`__page-next`. Filtre düzenleyicisi, özet satırı ve sabit eylem sütunu yok.
+- **Faz 10:** `datatable` web ikizidir (kolon, sıralama, sayfa ve akış sözleşmesi web'in). Telefon farkları
+  (`variant: table | cards`, filtre çipleri, düzenleme alt sayfası, sonsuz kaydırma) `component_get`
+  `mobileKnowledge`'ta; bağlı tablonun telefon ayarı `platform_guide('mobile-connect-data')`'da.
 - Web'e özgü bileşenlerin mobil karşılığı:
 
 | Web | Mobilde |
@@ -136,6 +135,7 @@ mobil bileşenlere geçen notlar). Web'de karşılığı olmayan bileşende (`ap
 | `iframe` | `webview` (`src` ya da `html`) |
 | `theme-toggle` | cihaz teması |
 | `fileUpload` | `fileInput` (alan) ya da `filebutton` (düğme) — sürükle-bırak yok |
+| `attachments` | `filebutton` (`isMultiple`) — önizlemeli kart ızgarası, popup ve sürükle-bırak yok |
 
 **Harici bileşen mobilde yoktur** (`MOB-006`): protokol v1 tarayıcı `.mjs` paketidir;
 `external_component_*` araçları mobil uygulamada platforma gitmez. **Geçici yol `html`** (2026-09-28):
@@ -365,7 +365,7 @@ 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
-  (cihaz geri tuşu, app-bar geri düğmesi, tarayıcı geri) önceki ekrana döner. Göreli yol uygulama
+  (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 } } })`:
 
@@ -377,7 +377,7 @@ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tip
       "style": "default",
       "items": [
         { "page": "<page_list id>", "label": "Görevler", "icon": "list" },
-        { "page": "<page_list id>", "label": "Profil", "icon": "user" }
+        { "page": "<id>", "label": "Sepet", "badge": { "source": "state", "ref": "sepet.adet" }, "reselect": "keep" }
       ],
       "showLabels": true
     }
@@ -385,14 +385,19 @@ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tip
 }
 ```
 
-  `items` 1–5 sayfa **id**'si (slug değil), tekrar yok; `style: 'floating'` köşe `pill` + gölge `md`
-  çizer. Çubuğun rengi ayarda YOKTUR: zemin `surface`, seçili `accent-primary`, seçilmemiş
-  `text-secondary` — değiştirmek için `theme_update`; eski `appearance` alanı okunmaz; `style: 'custom'` + `customWidgetId` çubuğu kendi widget'ınla çizer. Tutarsız ayar ve
+  `items` 1–5 sayfa **id**'si (slug değil), tekrarsız; `floating` köşe `pill` + gölge `md`. Renk ayarda YOK: zemin `surface`, seçili `accent-primary`, seçilmemiş
+  `text-secondary` (`theme_update`); `style: 'custom'` + `customWidgetId` çubuğu o widget'la çizer. Tutarsız ayar ve
   layout/sayfada eski `tab-bar` / `drawer-menu` düğümü `MOB-007` alır. Sekme dışı sayfalar yığına açılır.
+  `badge.ref` **saklı** state yolu; `keep`: ikinci dokunuşta yığın durur.
+  Çubuk düzeyinde iki davranış anahtarı vardır ve **yalnız varsayılandan ayrılınca yazılır**: `"keepStackOnSwitch": false`
+  (sekme değişince hedef sekme köke döner; alan yoksa yığın korunur) ve `"hideOnKeyboard": true` (klavye açılınca çubuk
+  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.
 - **Ç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`
-  (sekmeler), `ngapps://examples/mobile-app-shell-drawer` (çekmece); üç sayfalık liste → detay → form akışı:
+  (sekmeler), `ngapps://examples/mobile-app-shell-drawer` (çekmece); liste → detay → form:
   `ngapps://examples/mobile-list-detail-form`; kod tarama (düğme → `scan-code` → alana yaz):
   `ngapps://examples/mobile-scan-code`.
 
@@ -425,9 +430,9 @@ Mobil uygulama web ile **aynı sözlüğü ve aynı motoru** kullanır (plans/mo
 Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `function`, `flow-trigger`,
 `validation`) iki platformda aynıdır. Barındırıcıya dokunan adımlar ayrı rehberdedir:
 `platform_guide('mobile-steps')` — `redirect`, `alert`, `confirm`, `download`, `storage`, `setcookie`, `share`,
-`haptic`, `location`, `notification-permission` / `-schedule` / `-cancel`, `permission`, `open-settings`, `back`
-ve `ad-show`'un mobildeki davranışı, argümanları, `Steps.<adım>` sonucu; bildirim, izin, reklam ve konum
-tarifleri. Bu adımlardan birini yazmadan önce onu okuyun.
+`haptic`, `location`, `notification-permission` / `-schedule` / `-cancel`, `permission`, `open-settings`, `back`,
+`ad-show` ve `scan-code`'un mobildeki davranışı, argümanları, `Steps.<adım>` sonucu; bildirim, izin, reklam ve
+konum tarifleri. Bu adımlardan birini yazmadan önce onu okuyun.
 
 Sayfa ve layout `mount` akışları ilk çizimden sonra, `destroy` akışları sayfa kalkarken koşar. Yığındaki
 ve sekmedeki ekran bağlı kalır: geri dönüşte `mount` KOŞMAZ. Listeyi yeniden okumak için sayfanın
@@ -519,17 +524,30 @@ variable_create({ applicationId, pageId, variables: [
   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).
 
-## Cihazda önizleme
+## Studio'da ne görünür
 
-Expo uygulaması (`apps/mobile-runtime`) aynı sayfayı native çizer. Derin bağlantı
-`zeyrek://open/{proje}/{uygulama}/{sayfa}?env=<ortam>` **token taşımaz**: cihazdaki uygulama zaten giriş
-yapmış olmalıdır. Canlı önizleme sayfa şeması değişikliğini (`/hubs/page-schema`) dinler; yazdığın
-yama cihazda yenilenir.
+Mobil ekran tasarımcısındaki telefon ekranın **runtime çizimidir**: kayıtlı sayfa gerçek veri, kabuk ve akışlarla
+çizilir, kaydedilmemiş değişiklik anında üstüne yansır. Ayrı bir "canlı" kip yoktur; "Canlı" yalnız
+production ortamının adıdır. **Düzenle** kipinde dokunuş seçer (production'da akış koşmaz), **Dene** kipinde
+uygulamadaki gibi çalışır ve development'ta gerçek veriye yazar. **Ekran durumu** çipi (Gerçek veri · Örnek veri ·
+Yükleniyor · Boş · Hata · Erişim yok) hâli yalnız telefonda zorlar, şemaya yazmaz. **Kim olarak** çipi telefonu bir
+uygulama kullanıcısı, rol ya da Studio kullanıcısı olarak çizer; o kimliğin göremediği bileşen taralıdır. Yeni
+bağlanan liste kayda kadar örnek satırla çizilir. `page_screenshot` aynı runtime'ı kayıtlı hâliyle çeker (taslak,
+örnek rozeti ve tarama karede yok). Tasarımcı şema yayınına abone değildir: MCP'nin yazdığı değişikliği açık
+tasarımcı kendiliğinden göstermez, kullanıcı ekranı yeniden açar.
+
+## Cihazda dene
+
+Studio'daki **Cihazda dene** penceresinin iki yolu var; tarayıcıda deneme yolu yoktur. **Telefonunda:** Zeyrek
+Mobile App Store'dan ya da Google Play'den yüklenir (pencere mağaza bağlantısını verir; davet yoktur), pencerede
+çı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.
 
 ## Yayın
 
 Mağaza yayını ayrı rehberdedir: `platform_guide('mobile-publish')` — `mobile_store_*` / `mobile_asset_*` /
-`mobile_build_*` akışı, ekran görüntüsü, ön kontrol (P-01…P-11), derleme hata kodları ve insanın Studio › Yayın'da
+`mobile_build_*` akışı, ekran görüntüsü, ön kontrol (P-01…P-22), derleme hata kodları ve insanın Studio › Yayın'da
 yaptıkları. Derlenen uygulama
 **production ortamını** okur; ilk derleme kimlik alanlarını (`bundleIdentifier`, `androidPackage`, `scheme`) kilitler.
 
@@ -544,3 +562,7 @@ yaptıkları. Derlenen uygulama
   Web'in `theme-toggle`'ı mobilde yoktur. Seçili düğme saklanan seçimi `LocalStorage`'dan okur:
   `{{ LocalStorage['zeyrek:theme-mode'] || 'light' }}` (ARC-147).
 - Dar ekran kırılımı (`hideOn: 'mobile'`) mobil uygulamada anlamsızdır: ekran zaten tek boydur.
+- Ağ yokken ekranlar ve (açıksa) son okunan veri cihazdaki kopyadan gelir: `properties.mobile.offline`
+  (MOB-033), `Steps.<ad>.cache.at`, `error.network` — `platform_guide('page')` §Kural 1g-4. Önizleme önbellek kullanmaz.
+  "Uygulama ağsızken de çalışsın" isteğinin tarifi (okuma GET, yazma kuyruğu, liste birleştirme, düğme kilidi, korumasız
+  açılış, bant kapalı): §Kural 1g-4 "Ağsızken fark göstermeyen uygulama", örnek `ngapps://examples/mobile-offline-seamless`.