@appaflytech/zeyrek-ai-mcp 0.0.43 → 0.0.45

package/dist/resources/guides/microfunction.md

@@ -17,7 +17,7 @@ verir (gateway kendi çağrısında 200 gönderir; platform varsayılanı 10'dur
 |---|---|
 | Birkaç satır dönüşüm, alan eşleme, koşul | `code` step / ifade (aynı süreç, en ucuz) |
 | İfadelerde çıplak adla çağrılacak yardımcı | global function (`global_function_create`, JS) |
-| Kütüphane gerektiren iş (kriptografi, PDF, görüntü, parse) | microfunction (zip kaynak) |
+| Kütüphane gerektiren iş (kriptografi, PDF, görüntü, parse) | microfunction + bağımlılık (§Bağımlılıklar) |
 | Python gereken iş | microfunction — platformun ifade motoru YALNIZ JavaScript'tir |
 | Uzun süren/CPU yiyen iş | microfunction (kendi bütçesi, API sürecini bloke etmez) |
 
@@ -42,12 +42,13 @@ def handler(args, context):
     return {"total": args["a"] + args["b"], "environment": context["environment"]}
 ```
 
-- `args` — adımın `rule.expression`'ından üretilen argüman nesnesi. Fonksiyonun
-  `parameterDtoId`'si yoksa `{}` gelir.
+- `args` — adımın `rule.expression`'ından üretilen argüman. Şekli `parameterBehavior`'dır:
+  `object` ⇒ nesne, `array` ⇒ dizi, `primitive` ⇒ tek değer. Fonksiyonun `parameterDtoId`'si
+  yoksa `{}` gelir.
 - `context` — **salt okunur anlık görüntü**. İçine yazmak hiçbir şeyi değiştirmez; akışa dönen
   tek kanal fonksiyonun DÖNÜŞ DEĞERİdir.
 
-`context` şekli (ölçüldü, `MicrofunctionStep.BuildContext`):
+`context` şekli (ölçüldü, `MicrofunctionStep.EvaluateAsync`'in kurduğu sözlük):
 
 ```jsonc
 {
@@ -96,6 +97,16 @@ draft ──publish──▶ publishing ──▶ published ──update──
 4. `microfunction_delete` runtime'daki fonksiyonu da kaldırır; bir workflow adımı kaydı
    kullanıyorsa 400 ile reddedilir.
 
+## Test çağrısı ve kayıtlı argüman
+
+- `microfunction_invoke`'un `args`'ı **herhangi bir JSON değeridir** — liste modelli fonksiyona
+  dizi, tek değer modelliye sayı/metin gönderin; workflow adımının gönderdiği şekille aynıdır.
+- `testArguments` Studio'nun Test call sekmesinin kayıtlı argüman metnidir (≤ 64 KB). Olduğu gibi
+  saklanır, JSON geçerliliği denetlenmez, koşuma girmez; deployment ve template onu taşır.
+- `microfunction_update` **tam gövdedir**: `testArguments` verilmezse kayıtlı metin silinir —
+  güncellemeden önce `microfunction_get`'ten alın. Kaydetmek `revision`'ı artırır (yayındaki
+  kayıt `hasUnpublishedChanges: true` olur).
+
 ## Workflow adımı (WF-MF-001)
 
 Adım tipi `microfunction`; `workflow`, `automation` ve `middleware` akışlarının hepsinde
@@ -177,13 +188,97 @@ kullanıcısı verin, `roleArn` fonksiyonun koşacağı execution rolüdür ve *
 deseni tutmayan hesap gateway'de durur (MFR-001, block). Kaydettikten sonra
 `microfunction_runtime_test_connection` ile doğrulayın.
 
+## Bağımlılıklar: dış paketler (MF-001, MF-007)
+
+Paketlerin tek gerçeği dilin manifest dosyasıdır: Python `requirements.txt`, Node `package.json`.
+
+| Kaynak | Nerede bildirilir |
+|---|---|
+| `inline` | `dependencies` alanı — **satır başına bir paket**; platform yayında manifest dosyasını bu metinden yazar |
+| `archive` | Zip'teki `requirements.txt` / `package.json` (`microfunction_files_apply` ile düzenlenir); `dependencies` alanı yok sayılır |
+
+Satır biçimi (inline; boş ve `#` satırları yorumdur, toplam ≤ 16 KB):
+
+- **python:** requirements.txt satırı olduğu gibi — `pillow==11.1.0`, `requests>=2.32`,
+  `python-dateutil==2.9.0.post0`. pip seçeneği (`-r`, `--index-url`, `-e`) **yasak**.
+- **node:** `ad@aralık` — `sharp@^0.33.0`, `@scope/ad@1.2`; aralıksız satır (`dayjs`) `latest` olur.
+  Ad küçük harftir.
+
+Kural dışı satır istek gitmeden durur (MF-001, block; platform 422
+`MicrofunctionDependenciesInvalid`).
+
+**Yayın.** Etkili satır varsa Built-In yayın paketleri Fission builder'da kurar (`pip install -r
+requirements.txt` / `npm install`); kayıt build süresince `publishing` kalır — ölçülen süreler 4–30 sn,
+tavan 300 sn. Kurulum düşerse kayıt `publish-failed` olur ve `publishError` build günlüğünün son
+4 KB'ını taşır (`No matching distribution found for …` gibi) — bağımlılığı düzeltip yeniden yayınlayın.
+Etkili satır yoksa yayın build'siz ve bugünkü hızındadır.
+
+**Sembolik bağ.** Built-In paketi sembolik bağ taşıyamaz. Platform `.bin` dizinlerindeki bağları
+(`node_modules/.bin/*`: npm'in kurduğu ya da zip'te gelen) kendisi atar; bu yüzden çalışma anında
+paketlerin komut satırı araçları yoktur — kütüphaneyi `require` / `import` ile kullanın. Zip'te başka
+bir bağ varsa yayın `publish-failed` olur ve mesaj bağın yolunu verir: bağı gösterdiği dosyayla
+değiştirin. `file:` ile bağlanan yerel paket de npm kurulumunda bağ olur; zip'e `.npmrc` koyup
+`install-links=true` yazın (ölçüldü 2026-09-30). Eski `.npmrc` `bin-links=false` geçici çözümü artık
+gerekmez; bin komutu çağıran kurulum betiklerini (`bcrypt` gibi yerel paketler) kırdığı için önerilmez.
+
+**Eski archive kayıtları:** Faz 1'de paketleri zip'e koyup `requirements.txt` / `package.json`'da da
+bildiren kayıt, bir sonraki yayında build'e girer (manifest artık okunur). Bu kurulum ağa çıkar ve
+birkaç saniye–dakika sürer; zip'teki kurulu paketler yerinde kalır.
+
+**Built-In Python 3.13, Node 22'dir** (AWS Lambda'daki `python3.13` / `nodejs22.x` ile aynı). C
+uzantılı paketler (Pillow gibi) hazır wheel'den kurulur — ölçüldü 2026-09-29: `pillow==11.1.0` ile
+bir PNG'yi açıp boyutlandıran inline fonksiyon yayınlandı ve çağrıldı. 2026-09-29'a kadar Built-In
+Python 3.7'ydi; o sürümde kurulmuş paketler yeniden yayında 3.13 için yeniden kurulur.
+
+**AWS Lambda'da kurulmaz** (MF-007, warn): paket olduğu gibi gider. Lambda'da paketler kurulmuş
+hâlde zip'in içinde gelmelidir (archive kaynağı; Python'da paket klasörleri, Node'da `node_modules`);
+aksi hâlde yayının probe adımı import hatasıyla `publish-failed` olur.
+
+Örnek: `ngapps://examples/microfunction-node-dependencies`.
+
+## Zip kaynağı: arşiv dosyaları (MF-006)
+
+`sourceKind: 'archive'` kaydın dosyaları platformdaki zip'in İÇİNDE yaşar; tek gerçek kaynak o
+zip'tir (yayın, deployment ve şablon onu okur). Dört tool:
+
+| Tool | Ne yapar |
+|---|---|
+| `microfunction_archive_scaffold` | Arşivi olmayan kayda dilin iskeletini yazar ve kaydı zip kaynağına çevirir: node → `main.js` + `package.json` (`dependencies: {}`), python → `main.py` + `requirements.txt` (yalnız yorum); entrypoint `main.handler`. Boş manifest build gerektirmez. Arşiv varsa 409 |
+| `microfunction_files_list` | `{ hash, entries: [{ path, size, isDirectory }] }` — yalnız açık girdisi olan klasörler listelenir, ara klasörler yollardan çıkar |
+| `microfunction_file_get` | `{ path, size, isBinary, content }` — 1 MB üstü ya da UTF-8 olmayan dosyada `isBinary: true`, içerik yok |
+| `microfunction_files_apply` | `{ expectedHash, operations[] }` işlemlerini SIRAYLA uygular, yeni zip üretir, eski zip'i siler |
+
+İşlemler: `write-file` (oluştur ya da değiştir; ikili dosyada `content` base64 +
+`encoding: 'base64'`, MCP'den ≤ 8 MB; satırlara bölünmüş base64 da olur, platform boşluğu yok
+sayar) · `create-directory` · `delete` (klasörse altındaki her
+girdiyle) · `rename` (`newPath`; klasörse altındakilerle birlikte). Yol `'/'` ayraçlıdır, kökle
+başlamaz, `/` ile bitmez, boş/`.`/`..` segmenti ve ters bölü içermez — klasör de sondaki `/`
+olmadan yazılır (`lib`). Kural dışı gövde istek gitmeden durur (MF-006, block).
+
+**Yalnız zip kaynaklı kayıtta:** satır içi kayıtta `microfunction_files_apply` 400 döner
+(`sourceKind`); önce `microfunction_archive_scaffold` (arşiv yoksa) ya da `microfunction_update`
+ile `sourceKind: 'archive'`. Aynı anda iki yazan olursa biri kazanır, öteki 409 alır.
+
+**`expectedHash` zorunlu sıra:** önce `microfunction_files_list`, dönen `hash`'i `apply`'a verin.
+Kayıt o arada değiştiyse 409 (`MicrofunctionArchiveConflictException`) döner ve hiçbir şey
+yazılmaz — listeyi yeniden okuyup işlemleri ona göre kurun. Arşivi olmayan kayıtta hash verilmez.
+
+**Entrypoint yayında denetlenir.** Değişiklik entrypoint modülünü silse ya da taşısa bile yazılır
+(MF-006 warn; sonraki bir işlem modülü ya da klasörünü aynı yola geri getiriyorsa uyarı yok), ama `microfunction_publish` modül zip'te yoksa 400 döner. Modül yolu entrypoint'in
+son `.`'sından öncesi + dilin uzantısıdır: `handlers/sum.handler` → `handlers/sum.js`
+(Python'da `.py`). **Node'da giriş modülü `index.js` olamaz**: o ad platform shim'inindir; yayın
+bunu da 400 ile reddeder.
+
+Paketler zip'teki `requirements.txt` / `package.json`'a yazılır ve Built-In yayında kurulur
+(§Bağımlılıklar). Yayındaki kaydı değiştirmek `hasUnpublishedChanges` üretir; yeni kod
+`microfunction_publish` ile canlıya alınır.
+
 ## Sınırlar (v1)
 
-- **Bağımlılık build'i yok:** inline kod yalnız standart kütüphanedir; bağımlılık zip içinde gelir.
-- **MCP'den zip yükleme ve indirme yok** (`sourceKind: 'archive'` kaydı açılabilir, dosya
-  Studio'dan yüklenir) — Faz 2. Yüklenmiş zip platform ucunda okunabilir durumdadır
-  (`GET /{proje}/microfunctions/{id}/archive`, `application/zip`) ve Studio inspector'ında bir
-  indirme düğmesi taşır.
+- **Bağımlılık build'i yalnız Built-In'de:** AWS Lambda'da paketler zip'te gelmelidir (MF-007).
+- **Tek parça zip yükleme ve indirme MCP'de yok:** zip'in içeriği dosya düzeyinde okunur ve yazılır
+  (§Zip kaynağı). Zip'in tamamı platform ucunda okunabilir durumdadır
+  (`GET /{proje}/microfunctions/{id}/archive`, `application/zip`) ve Studio'dan indirilir.
 - `timeoutSeconds` ve `memoryMb` komutta non-nullable int'tir: **göndermezseniz 0 gider ve platform
   422 döner.** Gateway değer uydurmaz, eksikliği çağrıdan önce söyler (MF-001, block; ürün
   varsayılanları 30 / 256). Aynı kural provider ↔ `runtimeId` eşleşmesini, inline kaynakta `code`

package/dist/resources/guides/microservice.md

@@ -344,13 +344,42 @@ kart doğru sütuna geçer, başlığı ve sorumlusu silinir.
 > ifadeden gelir ve `undefined` dönen ifade de `null` yazar —
 > `platform_guide('workflow')` §"Table update adımı".
 
+### Güncelle/sil filtresi: tek satır + sahiplik koşulu (MS-019, block)
+
+`update` · `upsert` · `delete` ucu **tek kök** filtre ister ve hedef her zaman **tek satırdır**:
+
+| Filtre ağacı | Sonuç |
+|---|---|
+| Tek filtre: benzersiz alan + `eq` | Geçer |
+| Tek kök `group`; çocukların hepsi tekil ve `conditionType: 'and'` (ilki dahil); biri benzersiz alan + `eq` | Geçer |
+| Benzersiz alan `neq`/`in`/`contains`… · çocuklardan biri `or` · iç içe grup · kökte iki filtre | Gateway MS-019 ile durdurur; platform `FilterFieldMustUniqueEqException` / `InvalidFilterCountException` |
+| Koşullarda benzersiz alan yok | Platform `FilterFieldMustUniqueException` (gateway alanın benzersizliğini bilmez) |
+
+**Basit erişim modelinde sahiplik koşulunu uç kendisi koyar.** Kimliği bilen herkes `id eq`
+filtreli bir uçla başkasının satırını değiştirebilir; bunu kapatan grup:
+
+```jsonc
+"filters": [{
+  "filterType": "group", "conditionType": "and",
+  "children": [
+    { "filterType": "single", "conditionType": "and", "fieldId": "<id alanı>", "alias": "<entity slug>", "operator": "eq", "source": "query-string" },
+    { "filterType": "single", "conditionType": "and", "fieldId": "<sahip alanı>", "alias": "<entity slug>", "operator": "eq", "source": "expression", "value": "user.id" }
+  ]
+}]
+```
+
+`user.id` için uca auth middleware'i bağlanır (MS-011). Sahip koşulu tutmazsa işlem **0 satır**
+döner, hata vermez. Karmaşık erişim modelinde platform sahip koşulunu satır kapsamından kendisi
+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.
+
 ### Toplu güncelleme FİLTREYLE kurulmaz
 
-"Bekleyen bütün başvuruları onayla" bir table-source `update` ucuyla YAZILAMAZ. `update`
-operasyonu tam olarak **bir tekil alan filtresi** ister: birden çok filtre
-`InvalidFilterCountException`, tekil olmayan alanla filtre `FilterFieldMustUniqueException`
-döndürür (ölçüldü 2026-09-20, S2-22). Yani hedef kümeyi bir KOŞUL belirleyemez, yalnız bir ANAHTAR
-belirler. İki doğru yol var:
+"Bekleyen bütün başvuruları onayla" bir table-source `update` ucuyla YAZILAMAZ: hedef kümeyi bir
+KOŞUL belirleyemez, yalnız bir ANAHTAR belirler (yukarıdaki §"Güncelle/sil filtresi"; ilk ölçüm
+2026-09-20, S2-22). İki doğru yol var:
 
 | Ne istiyorsun | Yol |
 |---|---|

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
@@ -58,6 +59,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