@appaflytech/zeyrek-ai-mcp 0.0.36 → 0.0.40

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

@@ -0,0 +1,193 @@
+# Mobil mizanpaj — uygulamanın her yeri tek dil
+
+Bir mobil ekran kurmadan önce bunu okuyun. Buradaki kurallar zevk meselesi değildir, **ölçülür**:
+
+- **Doğru varsayılan.** Gateway iskeleti kendisi doğru kurar (`mobile_app_create`, `page_create`, yeni
+  düğümlerin boşluğu).
+- **Yazımda uyarı.** Yazım yanıtında sözleşme dışı durum `MOB-015…021` olarak gelir (`layoutWarnings`).
+- **Çizimde ölçüm.** `page_screenshot({ layoutReport: true })` sonucu sayıyla ölçer (`layoutSummary.alignment`).
+
+Temel mobil bilgi (flex-only yerleşim, tipli stil, gezinme, adımlar) için `platform_guide('mobile')`.
+Altın örnek: `ngapps://examples/mobile-form-screen`.
+
+## Sözleşme
+
+Birim dp. Ölçek **4 · 8 · 16 · 24 · 32**. `gap` jetonları `small` 8, `medium` 16, `large` 24.
+
+| # | Konu | Kural | Bulgu |
+|---|---|---|---|
+| S1 | Üst güvenli alan | Tek yerde. Kabuklu uygulamada kabukta (`safe-area` `edges: 'top'` içinde app-bar). Kabuksuz sayfada ilk öğe `safe-area` `top`. Sayfa kabuğun payını ikinci kez vermez | MOB-015 |
+| S2 | Alt güvenli alan | Formun gönder düğmesi akışta, formun sonunda durur. Ekrana sabit alt eylem gerekiyorsa `floating-container` (`respectSafeArea`) kullanılır, ayrıntısı §Bileşen dizgisi'nde. Akışın sonunda pay gerekiyorsa `safe-area` `bottom` (`all` değil) | — |
+| S3 | Kaydırma | Sayfa kökü kaydırır, `size: 'shrink'`. `scroll-view` yalnız gerekçeyle; iç içe dikey kaydırıcı yok | MOB-016 |
+| S4 | Ekran kenarı | Yatayda ve üstte **16**, tek yerde. Kabuklu sayfada slot'un margin'i verir. Kabuksuz sayfada yatayı kökün padding'i verir; üstteki 16, tepedeki `safe-area`'dan sonraki `gap`tir. Bileşenlere yazılmaz | ölçüm `gutter` |
+| S5 | Aralık | Kardeşler arası boşluk yalnız ebeveynin `gap`'i; çocuklar `marginType: 'none'`. Bölümler arası `large`, bölüm içi alanlar `medium`, satır içi öğeler `small` | MOB-019, MOB-021 |
+| S6 | Saydam sarmalayıcı | Yalnız davranış ekleyen kap (`tooltip`, zeminsiz grup kabı) içeriği içeri itmez: `paddingType: 'none'`, `marginType: 'none'`, `widthType: 'fill'` | MOB-019 |
+| S7 | Yüzey | Görünen grup (kart) iç boşluğu 16, yarıçap `lg`, 1 dp kenarlık ya da zemin (ikisi birden değil). Yüzeyin içeriği bilerek içeride durur | MOB-021 |
+| S8 | Genişlik | Tam genişlik öğesi (alan, birincil düğme, yüzey) `widthType: 'fill'`. Aynı sütundaki kardeşlerin sol ve sağ kenarı eşittir | MOB-019, MOB-020 |
+| S9 | Kap yönü | Dikey grup `direction: 'column'` + `horizontalAlign: 'stretch'`. **Yönü yazılmamış container/form satırdır.** Satır yalnız gerçekten yan yana dizilen öğeler için | MOB-020 |
+| S10 | Bileşen içi | Alan yüksekliği, iç boşluk, etiket aralığı ve yarıçap temadan (`--ng-form-*`) gelir; alanlara padding ya da yarıçap yazılmaz | — |
+| S11 | Yarıçap, renk, yazı | Yarıçap ölçek adıyla (`sm`, `md`, `lg`, `pill`), renk tanımlı jetonla, yazı boyu `text`'in `type` seviyesiyle (`h1`…`h4`, `p`, `small`, `label`). Ham px yok | MOB-021 |
+| S12 | App-bar | Ekranda tek app-bar, ilk çizilen öğe. Kabuk veriyorsa sayfa eklemez; başlık kabuğun app-bar'ına bağlanır | MOB-017 |
+| S13 | Boş kap | Çalışma anında boş kalan kap bırakılmaz (tepedeki `safe-area` payı hariç) | MOB-018 |
+
+## İskelet ağaçları
+
+Aşağıdaki iskeleti `mobile_app_create` ile mobil `page_create` kendisi kurar. Elle kuruyorsanız bu biçimi
+kullanın.
+
+**Kabuk (layout).** `shell_root` düz bir `container`'dır. Padding tipi yazılmazsa runtime ona 10 dp verir ve
+app-bar kenardan kopar.
+
+```
+container  shell_root   direction:column  gap:none  size:shrink  appearance.paddingType:none  heightType:fill
+├─ safe-area  edges:top
+│  └─ app-bar  (başlık, leading, menuTarget)
+├─ slot       appearance.marginType:custom  marginValues:{ top:16, right:16, bottom:0, left:16 }  heightType:fill
+└─ drawer     (çekmeceli kabukta)
+```
+
+**Kabuklu sayfa.** Pay ve kenar boşluğu kabuktan gelir.
+
+```
+container  page_container  direction:column  horizontalAlign:stretch  size:shrink  gap:medium  paddingType:none
+└─ … içerik
+```
+
+**Kabuksuz sayfa** (giriş, karşılama, izin). `isWrapper` yalnız margin'i sıfırlar, kökün padding'i çizilir.
+
+```
+container  page_container  direction:column  horizontalAlign:stretch  size:shrink  gap:medium
+           appearance.paddingType:custom  paddingValues:{ top:0, right:16, bottom:0, left:16 }
+├─ safe-area  edges:top     (boş: durum çubuğu payı + gap kadar üst boşluk)
+└─ … içerik
+```
+
+**Form ekranı.** Gönder düğmesi formun içinde, akışın sonundadır. Form doğrulaması yalnız bu yolda koşar.
+
+```
+page_container
+├─ text  type:h2  (başlık)
+└─ form  direction:column  horizontalAlign:stretch  gap:large  paddingType:none  marginType:none  widthType:fill
+   ├─ … bölümler
+   └─ button  type:submit  widthType:fill
+```
+
+## Bileşen dizgisi
+
+Bir ekran yukarıdan aşağıya şu sırayla kurulur: **başlık → bölümler → eylem.**
+
+- **Başlık:** `text` `type: 'h2'`, bölüm başlığı `type: 'h4'`. `typographyStyle.fontSize` yazılmaz.
+- **Bölüm iki türlüdür:**
+  - *Görünen grup (yüzey kabı):* `container` + `surfaceStyle` (zemin ya da kenarlık, `radius: 'lg'`) +
+    `paddingType: 'custom'` ve `paddingValue: 16`. İçeriği bilerek 16 içeride durur; kabın kendisi kardeşleriyle
+    hizalıdır.
+  - *Görünmeyen grup (saydam kap):* `container` `direction: 'column'`, `paddingType: 'none'`,
+    `marginType: 'none'`. İçerik kardeşleriyle aynı kenarda başlar.
+
+  Başlığı (`title`) olan ama zemini olmayan kap saydam kap gibi davranmalıdır. Varsayılan 10 dp padding'i
+  içeriği kaydırır (MOB-019). Ya yüzey verin ya da padding'i `none` yapın.
+- **`card` çocuk almaz.** Kart görünümlü alan grubu `container` + `surfaceStyle` ile kurulur.
+- **`tooltip`** dokunulan içeriği sarar ve saydamdır. Runtime ona varsayılan boşluk vermez; gateway yine de yeni
+  tooltip'e `paddingType: 'none'` ve `widthType: 'fill'` yazar. 2026-09-29'dan önce derlenmiş uygulamada
+  boşluksuz tooltip'in içeriği 14 dp içeri kayar ve 28 dp daralır; açık değer onu da korur.
+- **Satır (`direction: 'row'`)** yan yana dizilen öğeler içindir: arama kutusu + düğme, ikon + metin,
+  "Ekle / Sil" düğmeleri. Form alanlarını alt alta dizmek için satır kullanılmaz.
+- **Eylem:** birincil düğme tam genişlik (`widthType: 'fill'`). İkincil eylem `variant: 'text'` ya da
+  `'outline'`; metin görünümlü düğme içerik genişliğinde durabilir.
+- **Ekrana sabit eylem** (`floating-container`, `anchor: 'bottom-center'`, `fullWidth`, `respectSafeArea`) iki
+  şeye dikkat ister:
+  - *Yerleşim.* `fullWidth` ekran kenarına dayanır; S4 kenarı için içine `paddingType: 'custom'` +
+    `paddingValues` yatay 16 olan bir kap koyun, `floating-container`'ın kendisine `paddingType: 'none'`
+    yazın (yoksa akışta 20 dp boş şerit kalır). Sabit düğme uzun formun son alanını örter; akışın sonuna
+    düğme boyu kadar boşluk bırakın.
+  - *Gönderim.* Formun dışındaki `type: 'submit'` + `formId` düğmesi formun olayını tetikler ama **form
+    doğrulamasını koşmaz** (bilinen açık). Doğrulanan form için gönder düğmesi formun içinde kalmalı.
+
+## Boşluk
+
+Aralığın tek kaynağı ebeveynin `gap`'idir. Runtime'ın varsayılanları katmanlarda birikir: margin tipi
+yazılmamış her düğüm 4 dp, bırakılabilir düğüm ayrıca 10 dp padding alır. İki kat iç içe zeminsiz kap, içeriği
+28 dp kaydırır.
+
+- **Gateway yeni düğüme `marginType: 'none'` yazar** (`page_create`, `page_schema_patch`,
+  `page_schema_validate`) ve bunu `gatewayNormalized`'da söyler.
+  - Kardeşleri varsayılan margin'le duran eski bir kaba eklenen düğüme dokunulmaz; yeni düğüm eskilerden
+    4 dp kayardı. Kabı sözleşmeye taşımak için bütün çocuklarına `marginType: 'none'` yazın.
+  - `layout_schema_patch` ve `component_schema_patch` bu varsayılanı yazmaz. Kabukta ya da widget'ta eklenen
+    düğüme boşluğu siz yazın.
+- **Ritim:**
+  - bölümler arası `gap: 'large'` (24);
+  - bölüm içi alanlar `gap: 'medium'` (16);
+  - satır içi öğeler `gap: 'small'` (8).
+
+- **Özel değer** (`custom`) ve sayısal `gap` yalnız ölçekten seçilir: 0, 4, 8, 16, 24, 32 (MOB-021).
+
+## Genişlik ve hiza
+
+- **`horizontalAlign: 'stretch'`** olan sütun, çocuklarını `widthType` yazılmasa da tam genişlik gerer. Öteki
+  hizalarda tam genişlik öğesine `widthType: 'fill'` yazın. Aynı sütunda bir kısmı `fill`, bir kısmı değilse
+  sağ kenar hizadan kopar (MOB-020).
+- **Yönü yazılmamış `container` ve `form` satırdır.** Alanlar yan yana sıkışır; `direction: 'column'` yazın.
+  `safe-area` ve `scroll-view` sütun doğar.
+- **Ortalanmış ekran** (giriş, boş durum) için sütuna `horizontalAlign: 'center'` verin. Bu kapsamda kenar
+  eşitliği aranmaz.
+
+## Kenarlık, yarıçap, yazı
+
+- **Yüzey:** `surfaceStyle` ile verilir.
+  - zemin `background: 'var(--ng-…)'` (temada tanımlı jeton);
+  - kenarlık `borderTop…borderLeft` 1 dp, renk `border` jetonu;
+  - yarıçap `radius: 'lg'`.
+
+  Zemin ve kenarlığı birlikte kullanmayın; biri yeter.
+- **Yarıçap ölçeği:** kartlar `lg`, çip ve rozetler `pill`, alan ve düğmeler temadan. Ham `'10px'` yazılmaz.
+- **Yazı:** `text` `type` seviyesi.
+- **Tasarım sistemi çapında görünüm** (bütün kartlar, bütün düğmeler) temadan yönetilir. Ölçekler, adlı ön
+  ayarlar ve yeni düğümlerin başlangıç değerleri `platform_guide('theme')`'dadır. Aynı değer tek tek düğümlere
+  kopyalanmaz. Temanın eski `componentStyles` alanı emeklidir.
+
+## Kaydırma
+
+Sayfa kökü her zaman kaydırır: barındırıcı sayfayı bir kaydırıcı içinde çizer.
+
+`scroll-view` yalnız şu gerekçelerle eklenir:
+
+- `refreshable` (çekerek yenile);
+- `stickyHeader` ya da `states.isSticky` çocuk (yapışkan başlık);
+- `horizontal` (yatay şerit);
+- `heightType: 'fixed'` (sabit boylu iç liste).
+
+Gerekçesiz ya da iç içe dikey kaydırıcı jestleri çakıştırır (MOB-016). Kökün `size: 'grow'`'u çocukları ekran
+boyunca eşit böler ve kısa içerik üst üste biner. Yapışkan başlık ve ekrana sabit içerik için
+`platform_guide('mobile')` §Ekrana sabit içerik.
+
+## Doğrulama
+
+Bir ekranı bitirince iki çağrı yapın:
+
+1. **`page_schema_validate`** (kuru koşu): `layoutWarnings`'te MOB-015…021 bulgusu olmamalı.
+   - Yazım araçları (`page_schema_patch`, `layout_schema_patch`) yalnız o yazımın **getirdiği** bulguyu söyler.
+   - Sayfanın bütün durumunu kuru koşu verir.
+2. **`page_screenshot({ layoutReport: true })`:** `layoutSummary.alignment` şu değerleri vermeli.
+
+| Alan | Temiz değer | Anlamı |
+|---|---|---|
+| `gutter` | 16 | ekran kenarı boşluğu (sol = sağ) |
+| `leftEdges` | tek küme | aynı kapsamdaki geniş içeriğin sol kenarları |
+| `surfaces` | `[]` | iç hizası bozuk yüzey kabı yok |
+| `widthOutliers` | `[]` | sağ kenarı sapan geniş öğe yok (`insetLeft`/`insetRight` dp) |
+| `offScaleGaps` | `[]` | ardışık öğeler arası boşluk ölçekte |
+
+İki kaynak aynı şeyi söyler. MOB-019'un şemadan öngördüğü dp farkı, `leftEdges` kümeleri arasındaki farktır.
+
+## Bulgu → reçete
+
+| Kod | Ne diyor | Ne yapılır |
+|---|---|---|
+| MOB-015 | Üst pay eksik ya da çift | Kabuksuz sayfaya `safe-area` `top`. Kabuğu payı vermiyorsa kabukta app-bar'ı `safe-area` `top` içine alın. Kabuk veriyorsa sayfadaki `top`/`all` güvenli alanı kaldırın |
+| MOB-016 | Kaydırma tek yerde değil | Kök `size: 'shrink'`. Gerekçesiz `scroll-view`'ı kaldırın ya da gerekçesini verin. İç içe olanda içtekine `fixed` boy verin |
+| MOB-017 | İkinci ya da yanlış yerde app-bar | Kabuk veriyorsa sayfadakini silin, başlığı kabuğa bağlayın. Kabuksuzda app-bar'ı ilk sıraya (ya da tepedeki `safe-area`'nın içine) taşıyın |
+| MOB-018 | Boş kap | İçeriğini ekleyin ya da silin |
+| MOB-019 | Kenar kayması (dp) | Bulgunun hedefi içeriği iten kaptır. Görünen grup olacaksa yüzey verin, olmayacaksa `paddingType: 'none'` + `marginType: 'none'`. Hedef öğenin kendisiyse margin'ini kardeşleriyle aynı yapın |
+| MOB-020 | Genişlik tutarsız | Öğeye `widthType: 'fill'`. Yönü yazılmamış kaba `direction: 'column'` + `horizontalAlign: 'stretch'` |
+| MOB-021 | Ölçek dışı değer | Boşluğu ve sayısal gap'i 0/4/8/16/24/32'den, yarıçapı `sm`/`md`/`lg`/`pill`'den, yazı boyunu `text` `type`'tan seçin |

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

@@ -0,0 +1,148 @@
+# Mobil mağaza yayını rehberi
+
+Mobil uygulamanın (`type:'mobile'`) App Store / Google Play'e gidişi: mağaza ayarı, derleme işi, ön kontrol ve
+hata kodları. Uygulamanın kendisi (ekranlar, akışlar, uzak push gönderimi) `platform_guide('mobile')`'dedir.
+
+## 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.
+
+## 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) ·
+`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`.
+
+**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.
+
+**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 }`.
+`device`: iphone69 `{440,956,3}` · ipad13 `{1032,1376,2}` · phone `{360,720,3}` · tablet7 `{600,960,2}` ·
+tablet10 `{800,1280,2}`. JPEG şart (iOS alfa kabul etmez); giriş/splash sayfası çekilmez (App Review 2.3.3).
+ikon/splash/öne çıkan görsel tekli yuvadır: yeni yükleme eskisinin yerine geçer.
+
+## Akış
+
+1. `mobile_store_get` → kimlik varsayılandır (`app.zeyrek.o<org>.a<uygulama>`); değiştirilecekse **ilk
+   derlemeden önce** `mobile_store_update { settings: { bundleIdentifier, androidPackage, scheme } }`. İlk
+   derleme bu üçünü ve sayaçları kilitler (`lockedFields`); değişim 422.
+2. Mağaza metni: `settings.listing.<dil>` (`title` ≤ 30, `description` ≤ 4000, `keywords` virgülle ≤ 100…),
+   `urls.privacyPolicy`, iOS `apple.categories.primary` + `apple.copyright`, Android `play.contactEmail`.
+   Biçimsiz alan **MOB-022** ile yazılmadan durur; yükleme için eksik alan uyarıdır (taslak kaydedilir).
+3. `mobile_build_start { platform, target, dryRun: true }` → `fail` satırlarını düzelt (aşağıdaki tablo).
+4. `mobile_build_start { platform, target }` → `mobile_build_status { buildId }` ile `completed`/`failed`
+   bekle. Her başlatma derleme numarası ayırır; iptal/hata numarayı geri vermez.
+
+## 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`),
+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.
+
+## Ön kontrol
+
+`mobile_build_start { dryRun: true }` yalnız `ok` OLMAYAN satırları döner (`okCount` gerisini sayar).
+
+| 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-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-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-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` |
+
+Satırın `message` ve `fixHint`'i backend'den, istek dilinde gelir.
+
+## İzinler
+
+Derleme, **production'ın kullandığı** izinleri taşır: kullanılmayan iznin amaç metni Info.plist'e, Android izni
+manifeste girmez (`MOB-023`). `mobile_store_get { detail: ['permissions'] }` izin başına `usage` (çağrının ortamı:
+sayfa · bileşen ya da akış adımı), `build` (production: `carried`, `reason` = `used` · `unused` · `forced_on` ·
+`forced_off` · `not_prunable` · `scan_failed`) ve `devices` (aktif cihazların izin durumu) döner.
+
+- Kip `settings.permissionModes.<key>`: `auto` (varsayılan) · `on` (kullanılmasa da taşı) · `off` (taşıma).
+  Amaç metni `settings.permissions.<key>`; boşsa katalog varsayılanı gider.
+- **Açılışta sor:** `settings.launchPermissions` (izin anahtarı dizisi; liste bütün olarak yazılır, `[]` kaldırır).
+  Mağaza sürümü açılınca listedeki izinleri katalog sırasıyla ve yalnız hiç sorulmamışsa sorar; oynatıcı sormaz. Bir
+  kullanım sayılır (`usage` içinde `source: launch`, satırda `askOnLaunch`): izin derlemeye girer. Kipi `off` olan
+  izin listeye yazılamaz (422, `launchPermissions.<key>`) — önce kipi `auto` ya da `on` yapın. Bir sonraki mağaza
+  derlemesiyle etkili olur. Açılışta sorma kabuğun ayrı bir yeteneğidir: görünümde `shell.carriesLaunchPermissions:
+  false` ise ayar saklanır ama derleme sormaz (`permissionWarnings` ve P-12 söyler) — o zamana kadar akış adımından
+  isteyin. İzin bir eylemin sonucuysa (harita, fotoğraf) açılışta değil o anda sorun — `permission` adımı
+  (`MOB-025`).
+- Taşınmayan izin çalışma zamanında hiç istenmez: `permission` adımı `unavailable` döner, `map` kullanıcı
+  noktasını, dosya alanı o kaynağı sunmaz (`MOB-024`).
+- Küme derleme anında donar. İzin kullanan yeni bir sayfa production'a dağıtılmadan derlenirse — ya da derlemeden
+  SONRA dağıtılırsa — kurulu ikili o izni taşımaz (`unavailable`): önce dağıtım (insan onaylı), sonra derleme; izin
+  ileride kullanılacaksa kipi `on` yapın. Görünüm bunu söyler: izin satırının `missingFromStoreBuilds`'i o izni
+  taşımayan son mağaza derlemelerini (TestFlight / Play iç test) listeler; izin kullanılıyorsa yanıt
+  `permissionWarnings` taşır — production kullanıyorsa yeni derleme şimdi, yalnız okunan ortam kullanıyorsa
+  dağıtımdan sonra gerekir.
+- **İzleme izni (`tracking`, iOS ATT, kök ADR 0011):** derleme taşıyorsa App Store Connect App Privacy'de "Device
+  ID — Used to Track You", Play Console Data safety'de "Advertising ID" beyanı insanın işidir; izin penceresinden önce
+  teşvik ya da kendi ön pencerenizi göstermeyin (App Store 5.1.2). Görünüm bunu `permissionWarnings`'te söyler
+  (`MOB-027`). Taşınmayan ikiliye `expo-tracking-transparency` hiç bağlanmaz. Reklam açıksa izin, App ID'si olan platformun derlemesinde taşınır (yalnız Android'de reklam varsa iOS ikilisi ATT taşımaz).
+- Tarama `setter` ile yazılan tetikleyici prop'u da sayar; `code` adımı, fonksiyon gövdesi, `webview` / `html`
+  içeriği ve dış bileşen görünmez — onlar için kip `on`.
+
+## Reklamlar
+
+Google Mobile Ads (kök ADR 0012) mağaza ayarıdır: `settings.ads = { enabled, iosAppId, androidAppId, testMode,
+consentForm, appOpenUnit, units: [{ name, format, ios, android }] }`. App ID `ca-app-pub-…~…`, birim kimliği
+`ca-app-pub-…/…`; `name` `^[a-z][A-Za-z0-9]{0,39}$` ve tekil (bileşen `adBanner.unit` ve adım `ad-show.value` bu adla
+anar); `format` `banner` · `interstitial` · `rewarded` · `rewardedInterstitial` · `appOpen`; bir platformun kimliği boşsa
+yerleşim o platformda yoktur. Biçim hatası `MOB-022` ile yazılmadan durur.
+
+- SDK ikiliye yalnız `enabled` iken ve o platformun App ID'si varken bağlanır; o platformun derlemesine `tracking`'i de taşıtır (kip
+  `off` olamaz, 422).
+- `testMode: true` (varsayılan) gerçek birim yerine Google test birimini gösterir — geliştirirken gerçek birime
+  tıklamak AdMob hesabını kapattırabilir. Yayından önce `false` (P-13 `manual`).
+- `consentForm: true` (varsayılan) açılışta AdMob UMP rıza formunu gerekiyorsa gösterir; rıza mesajının kendisi AdMob
+  konsolunda kurulur (insan). Sıra: rıza → açılış izinleri (ATT) → SDK başlatma; rıza reklama izin vermezse uygulama
+  reklamsız sürer.
+- `appOpenUnit` `appOpen` biçimli bir yerleşimin adı; soğuk açılışta bir kez gösterilir.
+- `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).
+
+## Hata kodları
+
+`mobile_build_status` → `error.code`.
+
+| Kod | Ne oldu → ne yapılır |
+|---|---|
+| `toolchain_missing` | Runner'da bir derleme aracı eksik → Mac'te runner'ın doctor komutunu çalıştırın ve listelediklerini kurun (Xcode, CocoaPods, JDK ya da Android SDK). |
+| `manifest_invalid` | Derleme ayarları geçersiz → Uygulamanın mağaza ayarlarını — ad, kimlik ve sürüm — kontrol edip derlemeyi yeniden başlatın. |
+| `secrets_missing` | İmzalama bilgileri eksik → İmzalama sertifikasını ve mağaza hesabını Hesaplar ve kimlik bilgileri altında ekleyin. |
+| `prebuild_failed` | Native proje hazırlanamadı → İlk hatayı günlükte bulun. Bir modülün adını veriyorsa Zeyrek desteğine bildirin. |
+| `pod_install_failed` | iOS bağımlılıkları kurulamadı → Runner Mac'te pod repo update çalıştırın ya da ağ erişimini kontrol edip yeniden deneyin. |
+| `xcodebuild_failed` | iOS derlemesi başarısız → Günlükte ilk hata satırını bulun. Runner'daki Xcode sürümünün desteklendiğini kontrol edin. |
+| `gradle_failed` | Android derlemesi başarısız → Günlükte ilk hata satırını bulun. Runner'daki JDK ve Android SDK sürümlerini kontrol edin. |
+| `signing_failed` | Uygulama imzalanamadı → Sertifika ve profilin paket kimliğiyle eşleştiğini ve süresinin dolmadığını kontrol edin. |
+| `upload_failed` | Derleme yüklenemedi → Mağaza hesabı bilgilerini ve runner'ın ağını kontrol edip yeniden deneyin. |
+| `store_rejected` | Mağaza derlemeyi reddetti → Mağazanın gerekçesini günlükte okuyun, kaydı ya da derlemeyi düzeltin ve yeni bir derleme numarasıyla yayımlayın. |
+| `timeout` | Derleme çok uzun sürdü → Yeniden deneyin. Zaman aşımı sürerse runner Mac'in yükünü ve disk hızını kontrol edin. |
+| `cancelled` | Derleme iptal edildi → Hazır olduğunuzda yeni bir derleme başlatın. |
+| `runner_lost` | Runner yanıt vermeyi bıraktı → Runner Mac'in uyanık ve çevrim içi olduğunu kontrol edip derlemeyi yeniden başlatın. İpucu `runner_offline`: 24 saat içinde hiçbir runner işi almadı. |
+| `disk_full` | Runner Mac'in diski doldu → Runner Mac'te yer açın (eski derlemeler, DerivedData) ve yeniden deneyin. |
+| `unknown` | Derleme başarısız → Ayrıntı için günlüğü açın. Neden belirsizse derlemeyi Zeyrek desteğine bildirin. |