@appaflytech/zeyrek-ai-mcp 0.0.37 → 0.0.40

package/dist/knowledge/componentEvents.js

@@ -108,18 +108,18 @@ export const componentEventContracts = {
         mount: NO_DATA,
         change: {
             payload: { value: 'FilterGroup (iç içe and/or kural ağacı)', jexl: 'string (aynı ağacın hazır jexl ifadesi)' },
-            reads: "setter yalnız `value`yi self’e yazar; `jexl` YALNIZ event.data’dadır (params) — sorguya bağlayacağın alan odur"
+            reads: "setter yalnız `value`yi self’e yazar; `jexl` YALNIZ event.data’dadır (params) — sorguya bağlayacağın alan odur. `value` (ağaç) de event.data’da gelir — State’e geri yazmak için event.data.value’yu kullan. Ağaç değişmediyse (etkin birleştiriciye yeniden basmak) olay yayılmaz"
         }
     },
     comments: {
         mount: NO_DATA,
         submit: {
             payload: { text: 'string', parentId: "string (yanıtsa üst yorumun id’si, kök yorumda '')", mentions: 'string[] (metinden çözülmüş @kişi listesi)', author: 'string (currentUser)', process: "{ scope: 'task' | 'instance', targetId, visibility, body (@Ad → @<id>), mentionUserIds } | null (serbest yorumda null)" },
-            reads: 'Komponent yorumu ANINDA iyimser olarak listeye ekler (bekleyen katman); kalıcılık akışın işidir — rows tazelenmezse bekleyen satır bir sonraki içerik değişiminde kaybolur'
+            reads: 'Yük YALNIZ event.data’dadır (self.text/self.mentions boş gelir): {{ event.data.text }}. Komponent yorumu ANINDA iyimser olarak listeye ekler (bekleyen katman); kalıcılık akışın işidir — bekleyen satır, rows’a aynı üst yorum + metin (+ yazar) ile YENİ bir satır gelince yerini ona bırakır; akış kaydetmezse ya da metni değiştirirse "gönderiliyor…" kalır'
         },
-        like: { payload: { id: 'string', liked: 'boolean (yeni durum)', author: 'string (currentUser — işlemi yapan)' }, reads: 'beğeni de iyimserdir; sayaç rows tazelenene kadar yerel. isDisabled/isReadonly/isViewmode açıkken yayılmaz' },
-        edit: { payload: { id: 'string', text: 'string (yeni metin)', author: 'string (currentUser — işlemi yapan)' }, reads: 'düzenleme de iyimserdir; yeni metin "düzenlendi" işaretiyle rows tazelenene kadar yerel. Metin değişmediyse yayılmaz' },
-        delete: { payload: { id: 'string', author: 'string (currentUser — işlemi yapan)' }, reads: 'satır (kök yorumsa yanıtlarıyla birlikte) listeden hemen gizlenir; uca yazmak akışın işidir' }
+        like: { payload: { id: 'string', liked: 'boolean (yeni durum)', author: 'string (currentUser — işlemi yapan)' }, reads: 'Yük yalnız event.data’dadır. Beğeni de iyimserdir; sayaç rows tazelenene kadar yerel. isDisabled/isReadonly/isViewmode açıkken yayılmaz' },
+        edit: { payload: { id: 'string', text: 'string (yeni metin)', author: 'string (currentUser — işlemi yapan)' }, reads: 'Yük yalnız event.data’dadır. Düzenleme de iyimserdir; yeni metin "düzenlendi" işaretiyle rows tazelenene kadar yerel. Metin değişmediyse yayılmaz' },
+        delete: { payload: { id: 'string', author: 'string (currentUser — işlemi yapan)' }, reads: 'Yük yalnız event.data’dadır. Satır (kök yorumsa yanıtlarıyla birlikte) listeden hemen gizlenir; uca yazmak akışın işidir' }
     },
     'auth-layout': { mount: NO_DATA, primaryClick: NO_DATA, secondaryClick: NO_DATA },
     layout: { mount: NO_DATA, logout: NO_DATA },
@@ -354,7 +354,7 @@ export const componentEventContracts = {
     'audit-basic': { mount: NO_DATA },
     'audit-history': {
         mount: NO_DATA,
-        showMore: { payload: {}, reads: 'yalnız histories visibleLogCount’u aşınca çıkan "Daha fazla göster" düğmesine basılınca; görünür sınır visibleLogCount kadar büyür, kalan kalmayınca düğme kaybolur. Bileşen veri çekmez; backend kayıt başına en fazla 5 işlem verdiği için meta.history bağlıyken düğme ancak visibleLogCount < 5 iken çıkar' }
+        showMore: { payload: {}, reads: 'yalnız histories visibleLogCount’u aşınca çıkan "Daha fazla göster" düğmesine basılınca; görünür sınır visibleLogCount kadar büyür, kalan kalmayınca düğme kaybolur; en yeni (ilk) girdi değişince sınır başa döner. Bileşen veri çekmez; backend kayıt başına en fazla 5 işlem verdiği için meta.history bağlıyken düğme ancak visibleLogCount < 5 iken çıkar' }
     },
     'form-validation-errors': { mount: NO_DATA },
     'page-header': {
@@ -381,7 +381,7 @@ export const componentEventContracts = {
         },
         click: {
             payload: {},
-            reads: 'Yalnız akışa bağlıysa sarmalayıcı tıklanabilir olur; controls açıkken oynat/duraklat düğmesine basmak da bu olayı tetikler (tıklama sarmalayıcıya kabarır). isLoading:true iken HİÇ çalışmaz — o dalda oynatıcı yerine iskelet çizilir ve sarmalayıcı tıklanabilir değildir'
+            reads: "Yalnız akışa bağlıysa çalışır (sarmalayıcı <div>; controls:false iken role=button + Enter/Boşluk da tetikler); controls açıkken videonun YÜZEYİNE tıklamak hem oynatır hem bu olayı tetikler, kontrol çubuğundaki yerel oynat/duraklat düğmesi ise videoyu oynatır AMA bu olayı TETİKLEMEZ (ölçüldü 2026-10-05). isLoading:true iken HİÇ çalışmaz — o dalda oynatıcı yerine iskelet çizilir ve sarmalayıcı tıklanabilir değildir"
         },
         play: {
             payload: { isPlaying: 'boolean (true)' },
@@ -394,6 +394,14 @@ export const componentEventContracts = {
         ended: {
             payload: { isPlaying: 'boolean (false)' },
             reads: 'loop açıkken HİÇ yayılmaz (döngü videosu bitmez). event.data: { currentTime, duration } — bitişte currentTime pratikte duration’a eşittir. Bitişte pause’dan SONRA gelir (spesifikasyon sırası), yani ended akışı pause akışının ardından koşar'
+        },
+        load: {
+            payload: {},
+            reads: "Kaynağın İLK KARESİ hazır olunca (loadeddata) yayılır; kaynak her değiştiğinde yeniden. Değer yazmaz (setter yok). event.data: { duration: number (saniye; sonsuz ya da bilinmiyorsa 0), width: number, height: number (kaynağın kendi piksel boyu) }. Yalnız oynatıcı çizilirken yayılır: isLoading:true iken <video> yoktur, load gelmez (iskeleti kaynağı çözen sorgudan kapat). Boş src'de ya da error'da yayılmaz"
+        },
+        error: {
+            payload: {},
+            reads: "Kaynak yüklenemediğinde yayılır (404, video olmayan dosya, desteklenmeyen biçim, ağ kopması). Değer yazmaz, ama isPlaying true ise false'a düşer. event.data: { code: number (MediaError.code: 1 iptal · 2 ağ · 3 çözümleme · 4 kaynak yok/desteklenmiyor), message: string (tarayıcıya bağlı, çoğu kez boş) }. Bileşen kendi hata görünümü çizmez: siyah kutu kalır, kullanıcıya bildirmek akışın işidir. Boş src'de yayılmaz"
         }
     },
     // — 2026-08-25 eşleme turu: ng-apps-ui'da olay YAYAN ama burada kaydı olmayan komponentler.
@@ -672,7 +680,7 @@ export const componentEventContracts = {
                 fileName: 'string (okunan dosyanın adı; henüz dosya yoksa "")',
                 rowCount: 'number (dosyadaki HAM veri satırı sayısı — doğrulamadan önce)'
             },
-            reads: "adım her değiştiğinde yayılır; currentStep ve fileName düğüme de yazılır (self.currentStep), rowCount yalnız event.data'dadır"
+            reads: "adım her değiştiğinde yayılır; currentStep ve fileName düğüme de yazılır (self.currentStep), rowCount yalnız event.data'dadır. resetAfterComplete açıkken complete'ten hemen sonra { currentStep: 0, fileName: tamamlanan dosya, rowCount: 0 } ile bir kez daha yayılır"
         },
         complete: {
             payload: {

package/dist/knowledge/connectDataBind.js

@@ -375,7 +375,11 @@ export function buildDefinition(input, describe, connectable, connectablePaths =
     for (const slug of (keptSlugs(input.edit?.editable) ?? []).filter(item => describe.fields.find(field => field.slug === item)?.type === 'file')) {
         block('CD-018', `'${slug}' dosya alanı: edit.editable'a konamaz — bağlı bileşen dosyayı satır içinde yazmaz, platform kaydı 422 connect-data-editable-file ile reddeder. '${slug}'i editable'dan çıkarın; dosyayı file_upload + row_update (ya da bir microservice) yazar.`);
     }
-    for (const slug of [...(keptSlugs(input.filterable) ?? []), ...(keptSlugs(input.searchable) ?? [])]) {
+    // qm S-12: view kaynaklı microservice'te (describe source.textSearch, MicroserviceConnectDataSourceExecutor) alanlar süzülemez
+    // ama arama vardır — ConnectDataService request.Search'ü uca geçirir; searchable alanı ise kayıtta 422 alır. Genel
+    // "süzülemez/aranamaz" mesajı ajanı çıkmaza sokuyordu. View kaynağında aynı yolu CD-013 söyler (connectDataShapeIssues).
+    const textSearchSource = input.source.kind === 'microservice' && describe.source?.textSearch === true;
+    for (const slug of [...(keptSlugs(input.filterable) ?? []), ...(textSearchSource ? [] : keptSlugs(input.searchable) ?? [])]) {
         const field = describe.fields.find(item => item.slug === slug);
         if (field && (field.canFilter === false || (field.operators ?? []).length === 0)) {
             block('CD-002', `'${slug}' süzülemez (canFilter yok ya da işleç yok); filterable/searchable'a konamaz.`);
@@ -389,7 +393,11 @@ export function buildDefinition(input, describe, connectable, connectablePaths =
     }
     for (const slug of keptSlugs(input.searchable) ?? []) {
         const field = describe.fields.find(item => item.slug === slug);
-        if (field && field.canFilter !== false && (field.type !== 'string' || field.isProtected || !(field.operators ?? []).includes('icontains'))) {
+        const searchableField = field?.type === 'string' && !field.isProtected && (field.operators ?? []).includes('icontains');
+        if (field && textSearchSource && !searchableField) {
+            block('CD-002', `'${slug}' aranamaz: '${describe.source?.slug ?? describe.source?.id}' metin aramalı bir kaynak (describe source.textSearch) — arama searchable ile değil, istekteki search ile sunucuda çalışır; platform searchable alanı kayıtta 422 connect-data-source-feature-unsupported ile reddeder. searchable'ı boş bırakın; arama metnini platform istekteki search ile uca geçirir ve uç metni kendisi arar.`);
+        }
+        else if (field && field.canFilter !== false && !searchableField) {
             block('CD-002', `'${slug}' aranamaz: arama yalnız korumasız, içerir (icontains) işleci olan metin alanında çalışır — platform bu alanı aramada YOK SAYAR (geçerli hiç alan kalmazsa 422 ConnectDataFilterNotAllowed). Aranabilir bir metin alanı seçin.`);
         }
     }

package/dist/knowledge/expressionPrelude.js

@@ -13,6 +13,7 @@ export const EXPRESSION_PRELUDE_NAMES = [
     'params',
     '_PROXY_TAG',
     '_STATE_PROXY_TAG',
+    '_componentItem',
     'Components',
     'Page',
     '_stripProxy',

package/dist/knowledge/mobileComponentCatalog.js

@@ -471,7 +471,7 @@ export const mobileComponentKnowledge = {
         differences: [
             'Matris `toqr` ile üretilir ve düz görünümlerle çizilir (`react-native-svg` yok); hata düzeltme `M` sabittir ve web\'in `errorCorrectionLevel` prop\'u mobil şemadan düşer; renk web gibi siyah üstüne beyaz — koyu temada da (okuyucular ters kodu her zaman okumaz).',
             'Kare kutunun kenarı: genişliği belli düğümde (`widthType: fill` ya da `fixed`) düğümün genişliği, içerik genişliğinde (`auto` ya da `widthType` hiç yazılmamış) 200 dp; genişlik ölçülemezse de (kanvasta satır kabındaki `fill`) 200 dp — cihaz o düğümü tam genişlik çizer. Sabit px boy kenarı sınırlar. Modül ölçüsü tam sayıya iner, artan birkaç piksel ortalanır. Belirli boy için `appearance.widthType: fixed` + `widthString`.',
-            'Veri boşsa ya da QR`a sığmıyorsa (yaklaşık 2,3 KB üstü) yer tutucu çizilir. `quietZone` web ile aynı `common` grubundadır (eski adı `padding` ortak çizim katmanının CSS boşluğuyla çakışıyordu, CQ-272).',
+            'Veri boşsa ya da QR`a sığmıyorsa (yaklaşık 2,3 KB üstü) yer tutucu çizilir. `quietZone` web ile aynı `common` grubundadır (eski adı `padding` ortak çizim katmanının CSS boşluğuyla çakışıyordu, CQ-416).',
             "`click` bir akışa bağlıysa kod runtime'da basılır (web gibi); bağlı değilse dokunuşu yutmaz. QR'a sığmayan veri `error { errorText }`ü makine başına bir kez yayar (satırdaki seçim değişimi yeniden yaydırmaz)."
         ],
         propNotes: {
@@ -494,7 +494,7 @@ export const mobileComponentKnowledge = {
     'list-item': {
         summary: 'Liste satırı (FlutterFlow ListTile): baş ikon ya da görsel · başlık · alt başlık · son metin ve ikon; basılabilir. Web`de karşılığı YOKTUR.',
         differences: [
-            'Satıra dokunuş `click` yayar (yük yok). Pasifken soluk ve basılamaz; tasarım kipinde basış kanvasın seçim jestidir.',
+            'Satır yalnız `click` bir akışa BAĞLIYKEN basılır ve `click` yayar (yük yok); bağsız satır düz kutudur ve dokunuşu yutmaz — `repeater`/`grouped-list` şablonunda basış listenin `itemPress`ine gider (2026-10-08). Pasifken soluk ve basılamaz; tasarım kipinde basılmaz (basış kanvasın seçim jestidir).',
             'Baş tarafta `leadingImage` `leadingIcon`dan önce gelir (40 dp yuvarlak görsel; yüklenmezse başlığın baş harfleri). Boş ikon çizilmez.',
             "`leadingImage` `image` ile aynı çözümden geçer: kayıttaki FILE alanını nesne olarak verin (`{{ item.foto }}`) ya da `.absolute_path` yazın; `.value` dosya kimliğidir (GUID), görsel çizilmez (MOB-011).",
             'Ölçüler Material liste satırı: tek satır 56, alt başlıklı 72; `dense` 48 / 60. Renkler token sınıflarından (başlık `--foreground`, alt başlık ve son taraf `--muted-foreground`, basılıyken `--accent`).',
@@ -553,7 +553,7 @@ export const mobileComponentKnowledge = {
             'Başlık ifadelerde `Section` okur: `{ key, title, count, items }` — ör. `{{ Section.title }} · {{ Section.count }}`. Başlık satır kapsamı TAŞIMAZ (salt okunur, `Row`/`item` boş). `Section` ayrılmış addır: aynı adlı komponent ifade bağlamından süzülür.',
             'Gruplama: tarih/saat değeri cihazın yerel gününe (`YYYY-AA-GG`) indirgenir, diğer değer metne; başlık = anahtar (biçimli başlık için `Section.key` ile ifade yazın). Alanı boş/eksik satırlar en sondaki `otherSectionTitle` bölümüne düşer.',
             'Yapışkan başlık (`stickySectionHeaders`) yalnız boyu kabuktan gelen listede çalışır ve cihazda/önizlemede SINIRLI boy ister: `appearance.heightType: fixed` + `heightString` verin. `auto`da liste düz akıştır; sayfanın kaydırıcısı içindeki `fill` içerik kadar uzar, iç kaydırıcı oluşmaz, başlık yapışmaz.',
-            'Öğe şablonu basılabilir bir bileşense (`list-item`, `button`) dokunuş onun `click`ine gider ve `itemPress` yayılmaz (repeater ile aynı); `itemPress` için şablonu basılamayan bir kap yapın ya da akışı `list-item.click`e bağlayın (satır seçimi yine olur).',
+            'Öğe şablonu basılabilir bir bileşense (`button`, `click`i bağlı `list-item`) dokunuş onun `click`ine gider ve `itemPress` yayılmaz (repeater ile aynı); `click`i bağlı olmayan `list-item` basılamaz, dokunuş `itemPress`e gider (2026-10-08). Akışı `list-item.click`e bağlarsanız satır seçimi yine olur.',
             'Çoklu seçim `repeater` ile AYNI sözleşmedir: `selectionMode: multiple` (onay kutusu, dokunuş seçer, `itemPress` yayılmaz), `longPressSelects`, `selectionChange { selectedIndices, count }`, düğümde `selectedIndices`/`selectedItems` — gruplu görev listesinde toplu Ertele/Tamamla.',
             'v1`de yok: `columnCount`, sanallaştırma, başlıktan yazan akış. Studio`nun satır farkında yerleri (Bind modalı `Row` önerisi, setter satır hedefi) yalnız `repeater`ı tanır — `grouped-list` içinde `Row`/`item` ifadesini elle yazın.'
         ],
@@ -797,7 +797,7 @@ export const mobileComponentKnowledge = {
             'Cihazda `react-native-maps`: iOS Apple Haritalar, Android Google Haritalar (Expo Go`da anahtarsız; geliştirme/EAS derlemesinde Android Google anahtarı ve konum izin metinleri gerekir — ARC-128). Kanvas ve önizlemede Leaflet + OpenStreetMap karoları (anahtarsız, köşede OSM atfı; OSM`nin ortak karo sunucusu yoğun trafiğe açık değildir). Kanvasta dokunuş almaz ve sürüklenmez; karolar ve işaretçiler çizilir.',
             'Görünüm üç sayıdır: `latitude`, `longitude`, `zoom` (web harita ölçeği 1–19, kesirli olabilir; cihazda Apple/Google bölgesine çevrilir). Nesne `center` prop`u YOKTUR: bağlanan düz nesne runtime`da bozulur (ARC-117).',
             'Akış `latitude`/`longitude`/`zoom` yazınca harita oraya gider (web`de anında, cihazda kısa canlandırmayla) ve `regionChange` YAYMAZ. Kullanıcı sürükleyip yakınlaştırınca bıraktığı görünüm `regionChange { latitude, longitude, zoom }` ile düğüme geri yazılır (`carousel.activeIndex` gibi: prop`a bağlı ifade o an ezilir). Kutu ya da pencere boyunun değişmesi olay sayılmaz.',
-            'İşaretçiye dokunmak `markerClick { markerId }` yayar ve başlığı ya da açıklaması varsa balon açar. Harita işaretçiye ORTALANMAZ; kenardaki işaretçinin balonu sığmazsa harita sığdıracak kadar kayar ve bu kayma `regionChange` yayar (iOS ve web`de ölçüldü). Üst üste binen işaretçilerde iOS`ta `markerId` açılan balonunkinden farklı olabilir (ARC-130). İşaretçi rengi temanın ana rengidir. Döndürme ve eğme kapalıdır (ölçek kuzey yukarı görünümün ölçeğidir).',
+            'İşaretçiye dokunmak `markerClick { markerId }` yayar ve başlığı ya da açıklaması varsa balon açar. Harita işaretçiye ORTALANMAZ; kenardaki işaretçinin balonu sığmazsa harita sığdıracak kadar kayar ve bu kayma `regionChange` yayar (iOS ve web`de ölçüldü). Üst üste binen işaretçilerde iOS`ta `markerId` açılan balonunkinden farklı olabilir (ARC-265). İşaretçi rengi temanın ana rengidir. Döndürme ve eğme kapalıdır (ölçek kuzey yukarı görünümün ölçeğidir).',
             '`interactive: false` sürüklemeyi ve yakınlaştırmayı kapatır, işaretçiler dokunulabilir kalır ve sayfa haritanın üstünden kayar. Açıkken haritanın üstündeki dikey sürükleme haritayı kaydırır, sayfayı değil.',
             '"Haritada aç" (adres önizlemesi): işaretçi dışına dokunuş `press { latitude, longitude, mapsUrl }` yayar ve düğüme yalnız `mapsUrl` yazılır. Yer tek işaretçiyse o işaretçi (adıyla), değilse görünümün merkezidir. Akış `redirect` `isRaw: true`, `path: \'<harita>.mapsUrl\'` ile açar: iOS Apple Haritalar, Android `geo:` (kullanıcının harita uygulaması), web Google Haritalar. Ayrı bir adım yoktur.',
             'Kutu `webview` kuralından: kabuktan gelen boy ya da panelin `aspectRatio`su, yoksa 300 dp.'
@@ -811,6 +811,18 @@ export const mobileComponentKnowledge = {
             showUser: 'Kullanıcının konumunu çizer. Cihazda iOS izni MapKit sorar, Android`de bileşen çalışma anı izni ister; web`de tarayıcı konum izni. Yalnız runtime`da. "Konumum" düğmesi yoktur (Android`inki kamerayı `regionChange` yaymadan taşırdı); konuma gitmek akışın `latitude`/`longitude` yazmasıdır.'
         }
     },
+    adBanner: {
+        summary: 'Google Mobile Ads banner`ı (kök ADR 0012). Web`de karşılığı YOKTUR. Reklam yalnız MAĞAZA sürümünde çizilir; kanvas, önizleme, `/view` ve Zeyrek Mobile oynatıcısı boyutlu kesikli yer tutucu ("Ad · <yerleşim> · 320×50") çizer.',
+        differences: [
+            '`unit` mağaza ayarındaki reklam yerleşiminin ADIDIR (`mobile_store_update` `settingsPatch.ads.units[].name`), AdMob birim kimliği DEĞİL: kimlik derlemenin platformuna göre manifestten çözülür. Yerleşim `banner` biçiminde olmalı; tam ekran yerleşimi (`interstitial`, `rewarded`…) banner çizmez — onlar `ad-show` adımının işidir.',
+            'Mağaza sürümünde sıra: rıza formu (UMP) → açılış izinleri (iOS ATT) → SDK başlatma; o bitene kadar ve reklam kapalı/rıza yokken bileşen YER KAPLAMAZ ve olay yaymaz. iOS`ta izleme izni verilmemişse reklam kişiselleştirilmeden istenir. Mağaza ayarında `testMode` açıkken Google test birimi çizilir ("Test Ad").',
+            'Yerleşim bu platformda yoksa ya da banner değilse yer kaplamaz ve `fail { code: \'unavailable\' }` yayar; oynatıcıda ve web`de de çalışma kipinde aynı olay yayılır (reklamsız akışı orada da sınayın). Yüklenemeyen reklam (`no-fill`) kutusunu kaldırır: boş kutu kullanıcıya hata gibi görünür.'
+        ],
+        propNotes: {
+            unit: 'Reklam yerleşiminin adı (`^[a-z][A-Za-z0-9]{0,39}$`, mağaza ayarında tanımlı). Panel serbest metindir — yanlış ad cihazda boş kutu + `fail` verir.',
+            size: '`banner` 320×50 (varsayılan) · `largeBanner` 320×100 · `mediumRectangle` 300×250 · `fullBanner` 468×60 · `leaderboard` 728×90 (tablet) · `adaptive` kabın genişliğine uyarlı çapa banner · `inlineAdaptive` içerik arası uyarlı. Yer tutucunun ölçüsü bu tablodandır; uyarlanır boyların gerçek yüksekliğini SDK belirler.'
+        }
+    },
     datatable: {
         summary: 'Veri tablosu (FlutterFlow DataTable); prop`lar ve akış sözleşmesi web ikizininki: sıralama ya da sayfa değişince sorgu prop`ları (`sortField`/`sortType`/`offset`) düğüme yazılır ve `mount` yeniden koşar, satır eylemi önce `selectedRow`u yazar sonra eylemin kendi akışını koşturur (yazım web gibi sessizdir, `silentUpdate: [elementId]`: tablo yeniden çizilmez, kaydırma konumu korunur). Hücre biçimi, görünür kolonlar, sıralama döngüsü ve sayfa hesabı web`in modülünden gelir (`renderCell`, `buildViewColumns`, `nextSort`, `computePageState`): iki platform aynı veriden aynı metni üretir.',
         differences: [

package/dist/knowledge/mobileComponentEvents.js

@@ -111,6 +111,26 @@ export const mobileComponentEventContracts = {
             reads: "işaretçi dışına dokunuşta yayılır (interactive: false önizlemede bütün yüzey). Makine YALNIZ mapsUrl'i düğüme yazar (self.mapsUrl) — koordinat yazılsaydı harita kayardı; koordinat event.data'dadır. Tarif: redirect isRaw: true, path: '<harita>.mapsUrl'"
         }
     },
+    adBanner: {
+        mount: NO_DATA,
+        load: {
+            payload: {
+                width: 'number — yüklenen reklamın genişliği (dp)',
+                height: 'number — yüklenen reklamın yüksekliği (dp)'
+            },
+            reads: 'yalnız mağaza sürümünde, reklam yüklenip çizilince yayılır'
+        },
+        fail: {
+            payload: {
+                code: "string — SDK hata kodu (`googleMobileAds/no-fill`, `googleMobileAds/network-error`…) ya da `unavailable`: derleme reklam taşımıyor (oynatıcı, web), ya da yerleşim bu platformda yok / banner değil",
+                message: 'string — hatanın açıklaması'
+            },
+            reads: "reklam çizilemeyince yayılır; kutu yer kaplamaz. Reklam alanını akışla gizlemek ya da yerine içerik koymak için kullanın. Mağaza sürümünde rıza yokken ya da SDK henüz başlamamışken YAYILMAZ"
+        },
+        click: { payload: {}, reads: 'kullanıcı reklama dokununca (yalnız mağaza sürümü)' },
+        open: { payload: {}, reads: 'reklam ekranı kaplayan bir katman açınca' },
+        close: { payload: {}, reads: 'kullanıcı reklam katmanından uygulamaya dönünce' }
+    },
     markdown: {
         mount: NO_DATA,
         linkClick: {
@@ -160,7 +180,7 @@ export const mobileComponentEventContracts = {
                 index: 'number (öğenin rows içindeki düz indeksi, 0 tabanlı)',
                 row: 'object (öğenin satır verisi)'
             },
-            reads: 'yalnız itemPressable açıkken; önce change { selectedIndex } yayılır. Öğe şablonu basılabilir bir bileşense (list-item, button) dokunuş onun click\'ine gider, itemPress yayılmaz'
+            reads: 'yalnız itemPressable açıkken; önce change { selectedIndex } yayılır. Öğe şablonu basılabilir bir bileşense (button, click\'i bağlı list-item) dokunuş onun click\'ine gider, itemPress yayılmaz; click\'i bağlı olmayan list-item basılamaz, dokunuş itemPress\'e gider'
         },
         swipe: {
             payload: {

package/dist/knowledge/mobileStore.js

@@ -16,6 +16,14 @@ export const SPLASH_RESIZE_MODES = ['contain', 'cover'];
 export const RELEASE_STATUSES = ['draft', 'completed'];
 /** İznin mağaza derlemesindeki kipi (kök ADR 0010): kullanıma göre · her zaman · hiç. Anahtarları backend doğrular. */
 export const PERMISSION_MODES = ['auto', 'on', 'off'];
+/** Reklam ayarı (kök ADR 0012) — backend `MobileStoreSettingsValidator` / `MobileAdFormat` aynası. */
+export const AD_APP_ID_PATTERN = /^ca-app-pub-\d{16}~\d{10}$/;
+export const AD_UNIT_ID_PATTERN = /^ca-app-pub-\d{16}\/\d{10}$/;
+export const AD_UNIT_NAME_PATTERN = /^[a-z][A-Za-z0-9]{0,39}$/;
+export const AD_UNITS_MAX_COUNT = 40;
+export const AD_FORMATS = ['banner', 'interstitial', 'rewarded', 'rewardedInterstitial', 'appOpen'];
+/** Reklam açıkken taşınması gereken izin: iOS ATT (backend `MobileStoreSettings.AdsPermission`). */
+export const ADS_PERMISSION = 'tracking';
 export const LISTING_LIMITS = {
     title: 30,
     subtitle: 30,
@@ -200,6 +208,36 @@ export function storeSettingsFormatErrors(settings) {
         add('review.email', 'geçerli e-posta olmalı');
     if (text(apple.copyright).length > COPYRIGHT_MAX_LENGTH)
         add('apple.copyright', `en çok ${COPYRIGHT_MAX_LENGTH} karakter`);
+    const ads = isObject(settings.ads) ? settings.ads : {};
+    const units = (Array.isArray(ads.units) ? ads.units : []).filter(isObject);
+    const appIdExample = 'ca-app-pub-0000000000000000~0000000000';
+    const unitIdExample = 'ca-app-pub-0000000000000000/0000000000';
+    for (const field of ['iosAppId', 'androidAppId']) {
+        if (!isBlank(ads[field]) && !AD_APP_ID_PATTERN.test(text(ads[field])))
+            add(`ads.${field}`, `AdMob App ID biçiminde olmalı (${appIdExample}; birim kimliğindeki '/' değil '~')`);
+    }
+    if (ads.enabled === true && isBlank(ads.iosAppId) && isBlank(ads.androidAppId))
+        add('ads.enabled', 'reklam açıkken en az bir platformun AdMob App ID\'si gerekir (ads.iosAppId / ads.androidAppId)');
+    if (units.length > AD_UNITS_MAX_COUNT)
+        add('ads.units', `en çok ${AD_UNITS_MAX_COUNT} yerleşim`);
+    const invalidNames = [...new Set(units.map(unit => text(unit.name)).filter(name => !AD_UNIT_NAME_PATTERN.test(name) || units.filter(unit => text(unit.name) === name).length > 1))];
+    for (const name of invalidNames)
+        add(`ads.units.${name}`, `yerleşim adı ${AD_UNIT_NAME_PATTERN.source} biçiminde ve tekil olmalı (adBanner.unit ve ad-show.value bu adla anar)`);
+    for (const unit of units.filter(entry => !invalidNames.includes(text(entry.name)))) {
+        const name = text(unit.name);
+        if (!AD_FORMATS.includes(text(unit.format)))
+            add(`ads.units.${name}.format`, `kabul edilen biçimler: ${AD_FORMATS.join(' | ')}`);
+        for (const platform of ['ios', 'android']) {
+            if (!isBlank(unit[platform]) && !AD_UNIT_ID_PATTERN.test(text(unit[platform])))
+                add(`ads.units.${name}.${platform}`, `AdMob reklam birimi kimliği biçiminde olmalı (${unitIdExample})`);
+        }
+        if (isBlank(unit.ios) && isBlank(unit.android))
+            add(`ads.units.${name}`, 'en az bir platformun reklam birimi kimliği gerekir (ios / android)');
+    }
+    if (!isBlank(ads.appOpenUnit) && text(units.find(unit => text(unit.name) === text(ads.appOpenUnit))?.format) !== 'appOpen')
+        add('ads.appOpenUnit', `'${text(ads.appOpenUnit)}' appOpen biçiminde tanımlı bir yerleşim değil`);
+    if (ads.enabled === true && isObject(settings.permissionModes) && settings.permissionModes[ADS_PERMISSION] === 'off')
+        add(`permissionModes.${ADS_PERMISSION}`, "reklam açıkken izleme izni (tracking) kapatılamaz — iOS'ta kişiselleştirilmiş reklam ATT ister; kipi auto ya da on yapın");
     return errors;
 }
 /**
@@ -288,6 +326,43 @@ export function permissionLaunchShellWarnings(permissions, shell) {
         return [];
     return [`${asked.join(', ')}: açılışta sorulacak diye ayarlı ama yayındaki kabuk paketi (${text(shell.version)}) açılışta izin sormuyor — ayar saklanır, mağaza derlemesi sormaz (ön kontrol P-12 uyarır). Daha yeni bir kabuk yayınlanana kadar izni bir akış adımından isteyin (MOB-025, ${guide}).`];
 }
+/**
+ * MOB-027 — izleme izni (kök ADR 0011): mağaza derlemesi `tracking`'i taşıyorsa App Store Connect App Privacy'de
+ * "Device ID — Used to Track You" ve Play Data safety'de "Advertising ID" beyanı insanın işidir; Apple izin penceresinden
+ * önce teşvik ya da ön pencereyi yasaklar (5.1.2). Taşınmayan izin için söylenecek bir şey yoktur.
+ */
+export function trackingDeclarationWarnings(permissions) {
+    const tracking = permissions.find(entry => entry.key === ADS_PERMISSION);
+    return isObject(tracking?.build) && tracking.build.carried === true
+        ? [`${ADS_PERMISSION}: mağaza derlemesi izleme iznini (ATT) taşıyor — 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 ödül/teşvik ya da kendi ön pencerenizi göstermeyin (App Store 5.1.2). Sonuçtaki advertisingId yalnız granted iken doludur (MOB-027, ${guide}).`]
+        : [];
+}
+/**
+ * MOB-026 — reklam açıkken ajanın bilmesi gereken, kayıttan okunabilen durumlar (kök ADR 0012). Satırlar `<konu>: …`
+ * biçimindedir. Test kipi mağaza yüklemesinde de test reklamı gösterir (ön kontrol P-13 `manual`); yerleşimsiz reklam
+ * SDK'yı bağlar ama hiçbir şey göstermez; App ID'si verilmiş platformda birimi olmayan yerleşim o platformda yer kaplamaz
+ * (`adBanner`) ya da `invalid` döner (`ad-show`). Beyan satırı her zaman gelir: App Privacy, Data safety ve AdMob rıza
+ * mesajı konsolda insanın işidir, gateway yazamaz.
+ */
+export function adsStoreWarnings(settings) {
+    const ads = isObject(settings.ads) ? settings.ads : {};
+    if (ads.enabled !== true)
+        return [];
+    const units = (Array.isArray(ads.units) ? ads.units : []).filter(isObject);
+    const platforms = [['ios', 'iOS', ads.iosAppId], ['android', 'Android', ads.androidAppId]];
+    const lines = [];
+    if (ads.testMode !== false)
+        lines.push(`testMode: test kipi açık — mağaza yüklemesinde de gerçek reklam yerine Google test reklamı gösterilir; yayından önce ads.testMode: false (ön kontrol P-13, MOB-026, ${guide}).`);
+    if (units.length === 0)
+        lines.push(`yerleşim: reklam açık ama hiç yerleşim yok — SDK bağlanır, hiçbir reklam gösterilmez; ads.units'e banner ya da tam ekran yerleşim ekleyin (MOB-026, ${guide}).`);
+    for (const unit of units) {
+        const missing = platforms.filter(([field, , appId]) => !isBlank(appId) && isBlank(unit[field])).map(([, label]) => label);
+        if (missing.length > 0)
+            lines.push(`${text(unit.name)}: ${missing.join(' ve ')}'de birim yok — o platformda adBanner yer kaplamaz, ad-show 'invalid' döner (MOB-026).`);
+    }
+    lines.push(`beyan: reklam izleme sayılır — App Store Connect App Privacy'de "Device ID — Used to Track You" (ve reklam verisi), Play Console Data safety'de "Advertising ID", AdMob konsolunda rıza (GDPR/UMP) mesajı insanın işidir; gateway yazamaz. Beyanı kullanıcı onaylayınca mobile_store_update { declarations } (MOB-026, ${guide}).`);
+    return lines;
+}
 /** MOB-022 — `definition` birleşmiş kayıttır; biçim hatası backend'in 422'siyle aynı ret (block), eksik alan uyarı. */
 export const mobileStorePolicyRules = [
     {

package/dist/knowledge/normalize.js

@@ -4,6 +4,7 @@ import { ensureWorkflowErrorPath } from './errorPath.js';
 import { DOCUMENT_STYLE_TYPES, TYPED_STYLE_COMPONENTS } from './styleResolve.js';
 import { STATE_STORAGE_KINDS, STEP_ALIASES } from './platform/profile.js';
 import { inlineStyleFields } from './componentCatalog.js';
+import { FUNCTIONS_NAMESPACE } from './functionGuards.js';
 const SORT_DEFAULT = { name: 'sortField', type: 'sortType', source: 'query-string' };
 const LIMIT_DEFAULT = { name: 'limit', offset: 'offset', source: 'query-string' };
 function asArray(value) {
@@ -362,6 +363,7 @@ const REQUIRED_COLLECTIONS = ['events', 'validations', 'stateBindings', 'childre
  *
  * - `states`: DesignComponentManagementSchema.ToDomain:47 `States.IsSticky`'yi guard'sız okur;
  *   Appearance'ın satır 24'te varsayılanı var, States'in yok.
+ * - `blocks` doldurulmaz: konum ebeveynin düzenine bağlıdır, eksikse PAGE-037 ile reddedilir.
  * - `events` / `validations` / `stateBindings`: yalnız **micro-op yolunda** zorunlu.
  *   `page_create` (POST /pages) bunlarsız 200 döner, `PATCH …/schema` NRE verir; canlı deneyde
  *   üçü birlikte verilince geçti, her biri tek başına verilince patladı (klinik H-005 eki).
@@ -675,6 +677,11 @@ export function styleKeyNote(fixed) {
             + 'değer kaydedilir ama hiç uygulanmaz ve tek işareti tarayıcı konsoludur (F-06). '
             + "Seçici anahtarlara ('&__body', ':hover', '--token') dokunulmadı."];
 }
+/** PAGE-009 ile aynı kural: JS tanımlayıcısı (tireler çıkarılınca) ve ayrılmış `Functions` değil. */
+function isDerivableComponentName(name) {
+    const bare = name.replace(/-/g, '');
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(bare) && bare !== FUNCTIONS_NAMESPACE;
+}
 /**
  * Kabın `states.isDroppable`ı KATALOĞUN kararıdır. Gateway düğümü kurarken bu alanı
  * yazmıyordu (`DEFAULT_STATES` hepsini `false` bırakır) ve Studio kanvası düğümü kap saymıyordu:
@@ -721,6 +728,7 @@ export function droppableStatesNote(fixed) {
  * hiç denetlemez (`PageSchemaValidator.cs`); Studio her düğüme `name = elementId` yazar
  * (`ScreenBuilderDroppable.svelte`). Kural deterministik olduğu için reddetmek yerine dolduruyoruz.
  * Doldurulan ad da PAGE-009'dan geçmek zorunda: çağıran bunu denetimden ÖNCE koşar. Dolu ada dokunulmaz.
+ * `normalizeComponentDefaults` aynı boşluğu yalnız geçerli bir elementId için ikinci kez kapatır (güvenlik ağı).
  */
 export function fillComponentNames(nodes) {
     const filled = [];
@@ -745,6 +753,16 @@ export function normalizeComponentDefaults(nodes) {
     const fixed = [];
     for (const node of asObjects(nodes)) {
         const missing = [];
+        // name'siz düğümü platform kabul eder ama sayfada bir akış ya da `{{ }}` kod prop'u varsa
+        // FlowEngine runCode "Cannot read properties of undefined (reading 'catch')" ile düşer, akış
+        // `running:1`'de takılır ve hata adsız düğümü işaret etmez (image ölçüm turu, 2026-10-04).
+        // Yalnız PAGE-009'un geçerli saydığı elementId'den türetilir: page_create/page_update/layout
+        // yollarında PAGE-009 denetimi bu normalizasyondan ÖNCE koşar; bozuk bir elementId'den türeyen
+        // ad denetimi atlatıp "Missing initializer in const declaration" ile sayfayı öldürürdü.
+        if ((typeof node.name !== 'string' || node.name.trim() === '') && typeof node.elementId === 'string' && isDerivableComponentName(node.elementId)) {
+            node.name = node.elementId;
+            missing.push('name');
+        }
         if (!node.states || typeof node.states !== 'object') {
             node.states = { ...DEFAULT_STATES };
             missing.push('states');
@@ -1012,7 +1030,7 @@ export const PAGE_CONTAINER_ELEMENT_ID = 'page_container';
  * Düzen prop'ları da kurulur (2026-08-25): `ContainerComponent` şemasının `layout` varsayılanı
  * `grid` → `flex` oldu ve Studio bırakma yolu katalogdaki `definition.defaults`'u düğümün
  * props'una YAZAR (`ScreenBuilderDroppable.svelte`); sayfa kökünü kuran öbür üreticiler de aynı seti
- * yazar (Studio `DEFAULT_CONTAINER_LAYOUT_PROPS`, studio-api `generatePageContainer`, platform
+ * yazar (Studio `DEFAULT_CONTAINER_LAYOUT_PROPS`, platform
  * `CreatePageWhenApplicationCreatedEventHandler` + `SeedData`). Renderer varsayılanı
  * BİLMEZ — `isFlexLayout` yalnız düğümün kendi prop'una bakar — bu yüzden gateway'in kurduğu
  * kapsayıcı da seti açıkça taşır; yoksa Studio'dan açılan sayfa flex, MCP'den açılan ızgara olurdu.
@@ -1502,10 +1520,9 @@ function collectLayout(nodes, collected) {
  */
 const MAX_REORDER_PASSES = 8;
 /**
- * Studio'da komponent tuvale bırakıldığında ızgara çakışmasını studio-api'nin sayfa kurma servisi
- * çözer: `SchemaHelper.mergeComponents` yeni komponenti kardeşlerine ekleyip `reorderComponents` →
- * `draggableElement.moveItem` ile çakışan kardeşleri aşağı iter (NgApps.UI
- * `apps/studio-api/src/domain/page/shared/page-schema.helper.ts:28`). Gateway o servisten geçmez —
+ * Studio'da komponent tuvale bırakıldığında ızgara çakışmasını Studio'nun ızgara motoru çözer:
+ * `moveItem` çakışan kardeşleri aşağı iter (`@ng-apps/screen-builder`
+ * `src/draggable/draggable.element.ts`). Gateway o motordan geçmez —
  * `page_create`/`page_update` şemayı POST/PUT ile KOMPLE yazar (`page_build` tool'u yok) — bu yüzden
  * ajanın verdiği koordinatlar olduğu gibi kayda giriyor ve aynı hücreleri isteyen komponentler
  * Studio tuvalinde üst üste biniyor. Burada aynı algoritma şemanın TAMAMINA uygulanır: en dıştaki

package/dist/knowledge/platform/mobile.js

@@ -116,7 +116,7 @@ export const mobileProfile = Object.freeze({
     },
     style: { freeStyle: false, hoverStyle: false, resolver: 'native' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show']),
         aliases: STEP_ALIASES,
         infoOnly: new Set(['download', 'setcookie'])
     },

package/dist/knowledge/platform/mobileRules.js

@@ -180,7 +180,7 @@ export const MOBILE_WEB_ONLY = {
     'layout-region': "tek slot'lu sıradan layout",
     'auth-layout': "tek slot'lu sıradan layout",
     popover: "'modal' widget'ı",
-    'theme-toggle': "uygulama içi tema ayarı: 'choice-chips' (variant: segmented, Sistem/Açık/Koyu) → storage adımı name: 'zeyrek:theme-mode', value: system | light | dark; barındırıcı temayı anında değiştirir, cihazda kalıcı (seçim yazılmadıysa cihaz teması)",
+    'theme-toggle': "uygulama içi tema ayarı: 'choice-chips' (variant: segmented, Sistem/Açık/Koyu) → storage adımı name: 'zeyrek:theme-mode', value: system | light | dark; barındırıcı temayı anında değiştirir, cihazda kalıcı (seçim yazılmadıysa açık tema; cihaz teması yalnız system seçilince)",
     pagination: "'repeater' + daha fazla yükle düğmesi",
     breadcrumb: "yığın gezinmesi (app-bar geri düğmesi)",
     fileUpload: "'fileInput' (alan) ya da 'filebutton' (düğme) — dokunmatikte sürükle-bırak yok; ikisi de aynı base64 değeri yazar"

package/dist/knowledge/platform/web.js

@@ -20,7 +20,7 @@ export const webProfile = Object.freeze({
     },
     style: { freeStyle: true, hoverStyle: true, resolver: 'css' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show']),
         aliases: STEP_ALIASES,
         infoOnly: new Set()
     },

package/dist/knowledge/rules.js

@@ -168,6 +168,7 @@ const flowBranchNames = {
     bpm: ['always', 'success', 'fail'],
     permission: ['always'],
     'open-settings': ['always'],
+    'ad-show': ['always', 'error'],
     end: []
 };
 /**
@@ -180,7 +181,7 @@ export const knownFlowStepTypes = new Set([
     'start', 'end', 'query', 'setter', 'download', 'condition', 'redirect', 'setcookie', 'alert', 'confirm',
     'microservice', 'validation', 'flow-trigger', 'storage', 'navigate', 'code', 'function', 'share',
     'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'bpm',
-    'permission', 'open-settings'
+    'permission', 'open-settings', 'ad-show'
 ]);
 /**
  * Cihaz yeteneği adımlarının kapalı kümeleri — `@ng-apps/flow` `tasks/device/device.functions.ts`
@@ -189,6 +190,11 @@ export const knownFlowStepTypes = new Set([
  */
 export const hapticStyles = new Set(['success', 'warning', 'error', 'light', 'medium', 'heavy', 'selection']);
 export const locationAccuracies = new Set(['low', 'balanced', 'high']);
+/**
+ * Reklam yerleşiminin adı — backend `MobileStoreSettingsValidator.AdUnitNamePattern`'ın aynası (kök ADR 0012); `ad-show.value`
+ * ve `adBanner.unit` bu adla mağaza ayarındaki yerleşimi anar.
+ */
+export const adPlacementNamePattern = /^[a-z][A-Za-z0-9]{0,39}$/;
 /** `permission` adımının kipleri — `@ng-apps/flow` `PERMISSION_MODES`'un aynası (kök ADR 0010); tür adını gateway bilmez, backend doğrular. */
 export const permissionStepModes = new Set(['request', 'check']);
 const flowFreeBranchTypes = new Set(['condition']);
@@ -2626,6 +2632,54 @@ export const policyRules = [
             return findings;
         })
     },
+    {
+        id: 'FLOW-039',
+        module: 'flow',
+        appliesTo: ['create', 'update'],
+        sourceRef: "Tam ekran reklam adımının argümanı StepManagementArgument.value'dur (kök docs/adr/0012-reklam-yerlesimleri-magaza-ayari-ve-kosullu-sdk.md): mağaza ayarındaki reklam yerleşiminin ADI, DÜZ METİN — AdMob birim kimliği değil (kimlik derlemenin platformuna göre manifestten çözülür). Backend FlowDtoValidator HasAdPlacement adı ^[a-z][A-Za-z0-9]{0,39}$ deseniyle denetler, uymayan 422 alır; unit/placement/adUnitId gibi anahtarlar sözleşmede YOKTUR ve 200 ile sessizce düşer. Yerleşimin mağaza ayarında tanımlı olduğu burada denetlenemez: mobile_store_get",
+        check: definition => flowAllSteps(definition)
+            .filter(step => step.type === 'ad-show')
+            .flatMap((step) => {
+            const args = (step.args ?? {});
+            const unit = typeof args.value === 'string' ? args.value : '';
+            const unquoted = unit.replace(/^['"`](.*)['"`]$/, '$1');
+            const stray = ['unit', 'placement', 'adUnitId', 'unitId', 'format'].filter(key => args[key] !== undefined && args[key] !== null && args[key] !== '');
+            const findings = [];
+            if (!unit.trim()) {
+                findings.push({
+                    ruleId: 'FLOW-039',
+                    severity: 'block',
+                    message: `'${flowStepLabel(step)}' ad-show adımının yerleşimi yok: args.value mağaza ayarındaki tam ekran yerleşimin ADINI ister (platform 422 döner). Yerleşimler: mobile_store_get — ads.units[] (format interstitial, rewarded ya da rewardedInterstitial).`,
+                    guide: 'ngapps://guides/mobile'
+                });
+            }
+            else if (unquoted !== unit) {
+                findings.push({
+                    ruleId: 'FLOW-039',
+                    severity: 'block',
+                    message: `'${flowStepLabel(step)}' ad-show adımının yerleşimi tırnaklı yazılmış: ${unit}. Bu alan DÜZ METİNDİR, ifade değil — args.value: '${unquoted}' yazın.`,
+                    guide: 'ngapps://guides/mobile'
+                });
+            }
+            else if (!adPlacementNamePattern.test(unit)) {
+                findings.push({
+                    ruleId: 'FLOW-039',
+                    severity: 'block',
+                    message: `'${flowStepLabel(step)}' ad-show adımının yerleşimi bir yerleşim adı değil: '${unit}'. Değer ifade ya da AdMob birim kimliği olamaz; mağaza ayarındaki yerleşimin adıdır (${adPlacementNamePattern.source}). Platform 422 döner. Yerleşimler: mobile_store_get — ads.units[].name.`,
+                    guide: 'ngapps://guides/mobile'
+                });
+            }
+            if (stray.length > 0) {
+                findings.push({
+                    ruleId: 'FLOW-039',
+                    severity: unit.trim() ? 'warn' : 'block',
+                    message: `'${flowStepLabel(step)}' ad-show adımında args.${stray.join('/args.')} alanı var: bu anahtar StepManagementArgument sözleşmesinde YOK, platform onu 200 ile sessizce düşürür. Yerleşimin adı args.value'ya düz metin olarak yazılır — ör. args: { value: '<yerleşim adı>' }.`,
+                    guide: 'ngapps://guides/mobile'
+                });
+            }
+            return findings;
+        })
+    },
     {
         id: 'FLOW-038',
         module: 'flow',
@@ -3086,6 +3140,29 @@ export const policyRules = [
                     }];
         })
     },
+    {
+        id: 'FLOW-027',
+        module: 'flow',
+        appliesTo: ['create', 'update'],
+        sourceRef: "2026-10-01 kanban ölçüm turu: steps ve errorSteps'te AYNI stepId ('start') flow_create'te 500 `An item with the same key has already been added. Key: start [ArgumentException]` verdi — platform adımları tek sözlüğe stepId anahtarıyla koyuyor, hata mesajı çakışmanın stepId olduğunu söylemiyor",
+        check: definition => {
+            const counts = new Map();
+            for (const step of flowAllSteps(definition)) {
+                if (!step.stepId)
+                    continue;
+                counts.set(step.stepId, (counts.get(step.stepId) ?? 0) + 1);
+            }
+            const repeated = [...counts].filter(([, count]) => count > 1).map(([stepId]) => stepId);
+            return repeated.length === 0
+                ? []
+                : [{
+                        ruleId: 'FLOW-027',
+                        severity: 'block',
+                        message: `stepId'ler akışta (steps + errorSteps birlikte) benzersiz olmalı; tekrar edenler: ${repeated.map(id => `'${id}'`).join(', ')}. Platform bunları tek sözlüğe anahtar olarak koyar ve "An item with the same key has already been added" ile 500 verir (mesaj stepId'den söz etmez). errorSteps'te de kendi 'start' adımı gerekiyorsa ona farklı bir stepId verin (örn. 'err_start').`,
+                        guide: 'ngapps://guides/page'
+                    }];
+        }
+    },
     {
         id: 'MS-013',
         module: 'microservice',
@@ -3309,7 +3386,7 @@ export const policyRules = [
         id: 'MW-003',
         module: 'workflow',
         appliesTo: ['create', 'update', 'preview'],
-        sourceRef: "set-user değişkeni istek kapsamındaki WorkflowContext'e yazılır (SetUserStep → AddVariable('user')) ve sonraki middleware'in motoru onu görür (WorkflowRunner her koşuda JavascriptEngineInstance'ı _variables'tan kurar; sıra ExecuteMicroserviceBehavior:96 / ExecutePageBehavior:121 → OrderBy(m => m.Name)). Ama kuran middleware set-user'a ULAŞMADAN biterse (çerez yok, koşul dalı) değişken hiç doğmaz ve okuyan middleware ham 'user is not defined' ile 500 verir — 401 değil (crm koşumu B-3)",
+        sourceRef: "set-user değişkeni istek kapsamındaki WorkflowContext'e yazılır (SetUserStep → AddVariable('user')) ve sonraki middleware'in motoru onu görür (WorkflowRunner her koşuda CreateJavascriptEngine() ile motoru _variables'tan kurar; sıra ExecuteMicroserviceBehavior:96 / ExecutePageBehavior:121 → OrderBy(m => m.Name)). Ama kuran middleware set-user'a ULAŞMADAN biterse (çerez yok, koşul dalı) değişken hiç doğmaz ve okuyan middleware ham 'user is not defined' ile 500 verir — 401 değil (crm koşumu B-3)",
         check: (definition, context) => {
             if (context.workflowKind !== 'middleware')
                 return [];