@appaflytech/zeyrek-ai-mcp 0.0.37 → 0.0.41

package/dist/resources/guides/page.md

@@ -135,9 +135,9 @@ alanlar denetlenmez); katalog okunamazsa denetim susar ve yazma eskisi gibi geç
   **Düğümü silip yeniden kurmayın:** o yol ona yazan akış setter'larını sessizce öldürür
   (`FLOW-018`, aşağıda Kural 2).
 - **Aynı ızgara hücrelerini iki komponente veremezsin.** Studio'da komponent tuvale bırakıldığında
-  çakışan kardeşleri aşağı itme işini studio-api'nin sayfa kurma servisi yapar
-  (`SchemaHelper.reorderComponents` → `draggableElement.moveItem`); komple şema yazan `page_create`
-  / `page_update` o servisten geçmez, yani verdiğin koordinatlar olduğu gibi kayda girer ve tuvalde
+  çakışan kardeşleri aşağı itme işini Studio'nun ızgara motoru yapar
+  (`@ng-apps/screen-builder` `moveItem`); komple şema yazan `page_create`
+  / `page_update` o motordan geçmez, yani verdiğin koordinatlar olduğu gibi kayda girer ve tuvalde
   komponentler üst üste biner. **Gateway aynı algoritmayı şemanın tamamına uyguluyor** (kök dizi +
   her `children`, yalnız desktop `blocks[]` girdisi; `x`/`w`/`h` ve dizi sırası korunur, çakışanın
   `position.y`'si aşağı kayar) ve yanıtta `gatewayNormalized: "çakışan komponentler ızgarada aşağı
@@ -174,10 +174,9 @@ alanlar denetlenmez); katalog okunamazsa denetim susar ve yazma eskisi gibi geç
 ## Kural 1b — `page_build` YOK
 
 Entity'den otomatik sayfa üreten `page_build` tool'u **kaldırıldı**. Platformun
-`POST /pages/{app}/build/{page}` ucu üretimi `PageBuilderApiOptions:Url` adresindeki **ayrı bir
-servise** delege ediyor (`PageBuilderApiClient`); dev'de `localhost:4000`, prod'da `studio-api…`.
-O servis bu ürünün parçası değil ve ayakta olmayabilir. Sayfa/komponent şemasının tam karşılığı
-platformda zaten var → doğru yol yukarıdaki micro-op hattıdır.
+`POST /pages/{app}/build/{page}` ucu ve onun delege ettiği sayfa üretme servisi de 2026-09-18'de
+kaldırıldı; otomatik sayfa üretimi yok. Sayfa/komponent şemasının tam karşılığı platformda zaten
+var → doğru yol yukarıdaki micro-op hattıdır.
 
 ## Kural 1c — Komponente VERİ bağlama: `mount` olayı + flow (setter adımı)
 
@@ -283,7 +282,8 @@ dalı bulamaz ve akışı **sessizce durdurur** (`flow-engine.ts:79`); Studio da
 İstisnalar: `condition` → dal adı rule id'sidir (ve o id bir **GUID**'dir — aşağıdaki tuzak 6),
 `confirm` → `yes|no|always`, `microservice` →
 `always` (eski akışlarda `success` de çalışır) **+ `error`** — bağlarsan hata anında `always`
-yerine ondan sürer (2026-09-26, ADR 0004; ayrıntı aşağıdaki §"4xx de hatadır").
+yerine ondan sürer (2026-09-26, ADR 0004; ayrıntı aşağıdaki §"4xx de hatadır"), `validation` →
+`success` (hepsi geçti) | `error` (biri düştü), ardından her durumda `always` (kuralları aşağıda).
 
 **2. `iteratees[].type` yalnız `change` | `fill`.** `setter.ts` başka değerde hiçbir dala
 girmez — adım çalışır, hiçbir şey yapmaz. `change` tek prop'a değer yazar, `fill` diziyi
@@ -446,13 +446,15 @@ göstermek error flow'un işidir.
 > | `Steps.<adımAdı>.error.body` | Ucun hata gövdesi — eski `Steps.<adımAdı>.data`'nın taşındığı yer | `microservice.ts` `.catch` |
 > | `Steps.<adımAdı>.data` | **HER ZAMAN `null`**'dır — başarı gövdesi değil, hiçbir gövde değil (eskiden hata gövdesiydi) | `microservice.ts` `.catch` |
 >
-> **`alert` adımının `message`'ı DÜZ METİNDİR — ifade yazarsan ekranda o ifade görünür.**
-> `alert.ts` `task.argument.message`'ı doğrudan `toast.error()`'a geçirir ve `args` hiçbir yerde
-> değerlendirilmez (`Runtime.svelte` `argument: step.args`): `{ "type": "alert", "args": {
-> "message": "Steps.error.message", "alertType": "error" } }` kullanıcıya harfi harfine
-> `Steps.error.message` gösterir. Sabit bir uyarı yetiyorsa `alert` en ucuz adımdır; **ucun ne
-> dediğini göstereceksen bir `setter` (ya da `code`) adımı zorunludur** — `value.type: 'code'`
-> ifadeyi orada gerçekten çalıştırır:
+> **`alert` adımının `message`'ı ve `description`'ı METİN ŞABLONUDUR — yalnız `{{ }}` içi çözülür.**
+> Bileşen prop bağlamasıyla aynı çözücü (`@ng-apps/flow` `resolveStepText` → `runPropertyCode`; web ve
+> cihaz aynı): `{ "type": "alert", "args": { "message": "{{ Steps.error?.message ?? 'İşlem başarısız' }}",
+> "alertType": "error" } }` ucun mesajını gösterir, `"{{ t('kayit.tamam') }}"` etkin dildeki çeviriyi.
+> `{{ }}` DIŞINDA yazılan ifade çözülmez: `"message": "Steps.error.message"` kullanıcıya harfi harfine
+> `Steps.error.message` gösterir (FLOW-022 uyarır). `{{ }}` içermeyen metin olduğu gibi kalır. 2026-10-08
+> öncesi runtime'da (yeniden yayımlanmamış kurulum, eski mobil derleme) bu alanlar düz metindi; orada
+> ucun mesajı bir `setter` (ya da `code`) adımıyla bir bileşene yazılır — mesajı ekranda kalıcı
+> göstermek için bugün de bu yol geçerlidir:
 >
 > ```jsonc
 > // errorSteps: start → bu setter. Metni bir notification/text komponentine yazar.
@@ -464,13 +466,14 @@ göstermek error flow'un işidir.
 >   "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }] }
 > ```
 
-> **`confirm` adımının diyalog çerçevesi de yazılabilir.** `args` dört düz metin alanı taşır:
+> **`confirm` adımının diyalog çerçevesi de yazılabilir.** `args` dört metin alanı taşır:
 > `message` (gövde), `title` (başlık), `confirmText` (onay düğmesi, `yes` dalı), `cancelText`
 > (vazgeç düğmesi, `no` dalı). Son üçü isteğe bağlıdır; boş bırakılan alan dile göre sabit metne
 > düşer ("Emin misiniz?" / "Evet" / "Hayır" — `dialog.functions.ts` `resolveDialogFrame`).
-> Dördü de `alert`'in `message`'ı gibi DÜZ METİNDİR (FLOW-022 hepsini denetler):
-> `{ "type": "confirm", "args": { "message": "Bu risk ve 4 aksiyonu silinecek.", "title": "Riski sil",
-> "confirmText": "Sil", "cancelText": "Vazgeç" } }`.
+> Dördü de `alert`'in `message`'ı gibi METİN ŞABLONUDUR (FLOW-022 hepsini denetler); çok dilli
+> uygulamada çeviri anahtarıyla yazılır:
+> `{ "type": "confirm", "args": { "message": "{{ t('risk.sil.onay') }}", "title": "{{ Row.name }} silinsin mi?",
+> "confirmText": "{{ t('sil') }}", "cancelText": "Vazgeç" } }`.
 
 > **Hangi yolu seçeceksin — adımın kendi `error` dalı mı, `errorSteps` mi, ana akışta
 > `condition` mı?** Bir hatada sırayla denenir (yukarıdaki 4xx bölümü) — üçü birden TANIMLI
@@ -529,6 +532,30 @@ Tarif: `platform_guide('middleware')`.
 - Adım hedef akışı **bekler** (`await engine.run`), sonra `always` dalından devam eder.
 - Gateway boş/yarım `args`'ı **FLOW-014** ile yakalar.
 
+**`validation` adımının kuralları `args.validations` dizisindedir** (kök ADR 0014). Her kural
+`{ id?, component, property, type, errorMessage, settings }`: `component` sayfadaki bileşenin
+**elementId**'si (boş → bileşensiz kural; sayfada olmayan ad 404), `property` okunacak prop
+(çoğunlukla `value`), `type` ∈ `required · email · regex · min-length · max-length · min-value ·
+max-value`, `errorMessage` düz metin ya da `t:` anahtarı (düşen alanın `invalidText`'ine yazılır),
+`settings` tek parametredir — runtime **ilk değeri** okur (`{ "value": 8 }`, `{ "pattern": "^\\d+$" }`;
+parametresiz tipte `{}`). Kurallar dizi sırasıyla koşar; kuralsız adım yükte `[]` döner ve her
+çalıştırmada `success`'e gider.
+
+```jsonc
+{ "stepId": "kontrol", "name": "kontrol", "type": "validation", "kind": "normal",
+  "args": { "validations": [
+      { "component": "email", "property": "value", "type": "email", "errorMessage": "t:validation.email", "settings": {} },
+      { "component": "sifre", "property": "value", "type": "min-length", "errorMessage": "En az 8 karakter", "settings": { "value": 8 } } ] },
+  "branches": [ { "id": "<GUID>", "name": "success", "nextStepId": "kaydet" },
+                { "id": "<GUID>", "name": "error",   "nextStepId": null } ] }
+```
+
+- `always` `success`/`error`'dan **sonra** da koşar — kaydetmeyi `always`'e bağlarsan düşen
+  formda da kaydeder.
+- Bu şekil komponentin kendi `validations`'ından (`set_validations { type, message, value }`)
+  farklıdır; `message`/`value` burada sessizce düşer. Tanınmayan `type` runtime'da **geçer** sayılır
+  (platform kümeyi doğrulamaz). Gateway ikisini de **FLOW-041** ile yakalar.
+
 > **`code` adımının gövdesi `args.value` alanındadır — düz JS metni olarak.** Runtime onu
 > `(async () => { <value> })()` içinde koşturur (`code.ts:18`), yani `await` serbesttir ve dönüş
 > değeri akışa taşınmaz; etkiyi `Page`/`state`/komponent yazarak üretirsin. **Alan boşsa adım
@@ -619,7 +646,7 @@ değer tipleri: `static · page · property · storage · variable · code · it
 > **`platform_guide('functions')`**.
 >
 > **`share` adımı ("Share")** metin ve bağlantı paylaşır: `args: { title, message, path }`. `title`
-> DÜZ METİNDİR (ifade yazılırsa FLOW-022 uyarır); `message` ve `path` `storage.value` gibi
+> DÜZ METİNDİR — `{{ }}` şablonu da çözülmez (ifade ya da `{{ }}` yazılırsa FLOW-022 uyarır); `message` ve `path` `storage.value` gibi
 > İFADEDİR — düz metin tırnak ister (`"'Şuna bak'"`, `"'https://…/urun/' + Page.queryParams.id"`).
 > Bağlantının adı `url` DEĞİL `path`'tir: backend `Title`/`Message`/`Path` alanlarında saklar ve
 > tanımadığı anahtarı 200 ile sessizce düşürür (FLOW-035 `url`/`link`/`text`'i ve tırnaksız adresi
@@ -879,6 +906,14 @@ Tire yerine `_` kullan.
 > `component_schema_patch` yamalarında), `layout_create`, `layout_update(views)` ve `layout_patch`;
 > `page_schema_validate` aynı kararı verir. Ad doldurulduktan sonra denetlenir: geçersiz bir
 > elementId adsız gelirse o da reddedilir.
+>
+> **`name` hiç verilmezse** gateway onu `elementId` ile tamamlar ve `gatewayNormalized`'da `name`
+> diye bildirir: adsız 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. Tamamlama PAGE-009 denetiminden ÖNCE
+> koşar, yani `elementId` bu kuralın geçerli saydığı bir ad değilse (`'Ana Baslik'`, `'1abc'`,
+> `'Functions'`) tamamlanan ad da reddedilir. Yine de her `add_component` gövdesine
+> `name = elementId` yaz; tamamlama bir güvenlik ağıdır.
 
 ## Kural 1d — Sayfa iskeleti: `page_container` ve boyutlandırma
 
@@ -930,13 +965,16 @@ kapsayıcının kardeşi olarak yaşar (qm `[SY] Profil bilgilerim`: `page_conta
 > Bu tiplerde `size.h` gerçek yüksekliktir — göz kararı değil, içeriğe göre hesapla
 > (bir satır ≈ 10px; Kural 1f).
 
-## Kural 1d-2 — Sayfanın ve layout'un KENDİ olayları: `mount` · `destroy`
+## Kural 1d-2 — Sayfanın ve layout'un KENDİ olayları: `mount` · `destroy` (mobil sayfada + `focus`)
 
 Komponent olaylarından AYRI olarak sayfa ve layout kayıtları kendi olay listesini taşır
 (`events: [{ name, value: <flow id> }]`) ve geçerli adlar SABİTTİR: **`mount`**
 (yüklendiğinde) ve **`destroy`** (sayfadan/layouttan ayrılırken — runtime destroy akışlarını
-navigasyondan ÖNCE koşar). Başka ad platformca kabul edilir ama bağ sessizce ölü kalır —
-gateway **PAGE-011 / LAY-004** ile istek gitmeden reddeder.
+navigasyondan ÖNCE koşar). **Mobil uygulamanın SAYFASI** bir ad daha alır: **`focus`** — ekran
+her göründüğünde koşar (ilk açılışta `mount`'tan sonra, sonra yığından geri dönüşte ve sekme
+değişiminde; `platform_guide('mobile')`). Başka ad platformca kabul edilir ama bağ sessizce ölü
+kalır — gateway **PAGE-011 / LAY-004** ile istek gitmeden reddeder; `focus` layout'ta ve web
+sayfasında da reddedilir (web sayfayı her gezinmede baştan kurar, `mount` yeter).
 
 - Bağlama yolu `set_event` DEĞİLDİR (o komponent hedefler): sayfada `page_create` /
   `page_update`'in `events` parametresi, layout'ta `layout_create/update`'in `events`'i.

package/dist/resources/guides/theme.md

@@ -18,6 +18,7 @@ yazmalarının aksine burada "önce development'ta dene" diye bir ayrım YOKTUR.
 | Alan | Ne yapar | Ürettiği değişken(ler) |
 |---|---|---|
 | `mode` | `'light'` (varsayılan) \| `'dark'` — yayınlanan uygulamanın modu | palet tabanını seçer |
+| `direction` | `'ltr'` \| `'rtl'` \| `'auto'` — sayfanın okuma yönü; `auto` uygulama dilinden türetir (`ar` `he` `fa` `ur` `ps` `sd` `ug` `yi` `dv` → rtl). Ayar YOKSA `dir` hiç yazılmaz (sayfa üst öğenin yönünü miras alır): `ar` ile kurulmuş mevcut proje bu ayar açılmadan aynalanmaz. Sayfa oluşturucu tuvali yönü uygulamaz. Grid yerleşimi kendiliğinden aynalanır; bileşenlerin ok simgeleri ve fiziksel `left/right` CSS'i bileşen bazında düzeltilir (ADR 0006) | CSS değişkeni üretmez, kap `dir` özniteliğine yazılır |
 | `palette` | AYDINLIK moddaki renk override'ları; `accent.onPrimary` isteğe bağlıdır — accent ÜSTÜNDEKİ metin, verilmezse kontrasttan türer (`#4787FA` gibi açık bir mavi siyah metin üretir, tasarımda beyazsa buraya yazın) | `--ng-accent-*` · `--ng-background-*` · `--ng-text-*` · `--ng-border-*` · `--ng-status-*` · `--ng-text-on-accent` |
 | `paletteDark` | KARANLIK moddaki renk override'ları | aynı küme |
 | `fontFamily` · `headingFontFamily` | Gövde ve başlık yazı tipi (Google Fonts adı) | `--ng-font` · `--ng-font-heading` |

package/dist/resources/guides/translation.md

@@ -55,7 +55,8 @@ diye bir alan **hiç görünmez**; blok tam olarak bunu görünür kılmak için
 | Tool | Ne yapar |
 |---|---|
 | `translation_list` | Application'ın tüm `(language, key, value)` kayıtlarını düz liste döner |
-| `translation_update` | `keys` (ekle/güncelle, `componentId` opsiyonel) ve/veya `deletedKeys` (sil) — ikisi de aynı çağrıda verilebilir, en az biri dolu olmalı |
+| `translation_update` | `keys` (ekle/güncelle, `componentId` opsiyonel) ve/veya `deletedKeys` (sil) — ikisi de aynı çağrıda verilebilir, en az biri dolu olmalı. `file` kipi: doldurulmuş Excel'i içe aktarır (aşağıda) |
+| `translation_export` | Çevirmene verilecek Excel dosyasını yerel yola yazar (aşağıda) |
 | `project_update` | `languages`/`defaultLanguage` — proje dillerini kurar/değiştirir |
 
 ```jsonc
@@ -194,6 +195,45 @@ Runtime `t:` ile başlayan bir mesajı anahtar sayar ve normal zincirden çözer
 olduğu gibi gösterilir. Çözüm çalışma anında olduğu için şema varsayılanlarını değiştirmek
 gerekmez — `schema.ts`'e dokunulmaz, katalog yeniden yüklenmez.
 
+## Dosyayla toplu çeviri (Excel)
+
+İnsan bir çevirmene yeni bir dil yaptıracaksa: sözlük Excel'e iner, çevirmen hedef sütunu doldurur,
+dosya geri yüklenir. **Çeviriyi sen yapacaksan dosyaya gerek yok** — `translation_list` ile oku,
+`translation_update { keys }` ile yaz.
+
+```jsonc
+// 1. dışa aktar — dosya YALNIZ outPath'e yazılır, Sürücü'ye yüklenmez
+{ "applicationId": "<app id>", "targetLanguage": "es", "outPath": "C:/ceviri/crm-es.xlsx" }   // translation_export
+// → { keys: 120, targetMissing: 120, sourceLanguage: "en", note: "… TR-004 …" }
+
+// 2. çevirmen C sütununu doldurur; 3. önce kuru koşu
+{ "applicationId": "<app id>", "file": "C:/ceviri/crm-es.xlsx", "targetLanguage": "es", "dryRun": true }   // translation_update
+// → { created: 118, skippedEmpty: 2, unknownKeyCount: 0, targetLanguageInProject: false, note: "… ekleyecek …" }
+
+// 4. gerçek içe aktarma
+{ "applicationId": "<app id>", "file": "C:/ceviri/crm-es.xlsx", "targetLanguage": "es" }                   // translation_update
+// → { created: 118, languageAdded: true, … }
+```
+
+Dosya: tek sayfa, `A` Key · `B` kaynak dil (yalnız referans, okunmaz) · `C` hedef dil; başlıklar
+`Key` · `Default Language (EN)` · `Target Language (ES)`. İçe aktarma **başlık satırını okumaz**:
+değerler `translation_update`'in zorunlu `targetLanguage`'ındaki dile yazılır, `C1`'deki `(ES)` yalnız
+çevirmen içindir ve dili belirlemez. Gizli `_zeyrek`
+sayfası dosyanın hangi application'dan çıktığını söyler; başka bir application'ın dosyası yine
+yazılır ama yanıt `applicationMismatch: true` ve not taşır.
+
+- **Dolu hücre mevcut değeri ezer**, boş/boşluk hücre atlanır, hiçbir şey silinmez.
+- **Application'da olmayan key açılmaz** — `unknownKeys`'e düşer. Yeni key `keys` kipiyle açılır.
+- Key eşleşmesi önce birebir, yoksa büyük/küçük harf duyarsız tek aday; aynı key dosyada iki satırda
+  ise 422 ve hiçbir şey yazılmaz.
+- **Hedef dil projede yoksa içe aktarma onu projeye ekler — bütün ortamlara** (TR-004). Önce
+  `project_update` gerekmez; ama dil production'a da gider ve orada çeviriler deployment'la gelene
+  kadar runtime varsayılan dile düşer.
+- Dosya platformda **saklanmaz**: ne dışa aktarma ne içe aktarma Sürücü'ye bir şey bırakır.
+- Studio'nun çeviri panelindeki JSON içe aktarma bundan farklıdır: o yalnız boşları doldurur ve
+  projede olmayan dili atlar.
+- Sınırlar: `.xlsx` (`.xls`, csv, json reddedilir), 10 MB, 10.000 satır.
+
 ## Bilinen sınırlar
 
 - **Flow adımlarında Translation kaynağı YOK.** `value.type` sözlüğünde (`platform_guide('page')`

package/dist/resources/guides/workflow.md

@@ -286,7 +286,10 @@ Global-error dalında `error` değişkeni tanımlıdır:
 ```
 
 Fail dalında aynı zincir `<adım adı>.error.cause`'tadır (`<adım adı>.error` = `{ code, message, detail,
-type, cause }`).
+type, cause }`). Serbest `error` değişkenini YALNIZ global-error dalı kurar
+(`ActivityContext.EnterGlobalErrorHandling`): bağlı `fail` dalının hedefi `error.message` okursa
+`undefined` alır — orada `<adım adı>.error.message` / `.code` okuyun (WF-035 uyarır; hedef aynı zamanda
+global-error dalının hedefi olsa da).
 
 `error.step` hangi adımın patladığını söyler. `input`/`data` alanları ifade değerlerini ve adım
 çıktısını taşır — gövdeye yalnız ihtiyaç duyduğun alt kümeyi yaz (gateway'in varsayılanı
@@ -575,6 +578,33 @@ Tam örnek, ölçülen çıktı şekli ve `code` çocuğu tuzağının çıkış
 > `The JSON value could not be converted to System.Guid` ile reddetti. Geçerli önek harfleri
 > yalnız `a`–`f`'tir.
 
+## `file-upload` adımı: çıktı, dosya alanının tablo okuma biçimidir (K10, 2026-10-08)
+
+Adım `rule.fileString`'i (base64, JS ifadesi) `rule.folderId` klasörüne `rule.fileName` (JS ifadesi;
+boşsa GUID) adıyla yazar, dosyayı geri okur ve **tablo okumasının FILE alanında döndürdüğü nesneyi**
+üretir (`FileUploadStep.OutputSchema`; iki yol aynı `FilePathMapper`'ı kullanır):
+
+```json
+{
+  "id": "0199c3a2-7b1e-7c4d-9a10-3f2b8c6d5e41",
+  "path": "uploads/photo.png",
+  "absolute_path": "https://acme.example.com/dev/uploads/photo.png",
+  "type": "ref",
+  "value": "0199c3a2-7b1e-7c4d-9a10-3f2b8c6d5e41",
+  "fileName": "photo.png"
+}
+```
+
+- Sonraki adımlar **adım adı + `.data`** ile okur: adres `yukle.data.absolute_path`, kimlik
+  `yukle.data.id` (`value` aynı id'dir). `absolute_path` = uygulamanın dosya sunum ucu (org slug +
+  ortamın depolama öneki) + `/` + `path`; `path` boşsa `""`. Görsel için ikinci okuma gerekmez.
+- **Aynı içerik klasörde varsa** yeni dosya yazılmaz: `id`, adres ve `fileName` var olan dosyanındır.
+- **Mobil görsel:** `response` adımı nesneyi döndürür (`bodyExpression: "({ foto: yukle.data })"`),
+  sayfa akışı `Steps.<sayfa adımı>.data.foto`'yu `image.src`'ye verir — nesnenin kendisi ya da
+  `.absolute_path`; `.value` dosya kimliğidir, görsel çizilmez (`platform_guide('mobile')` §Dosya ve fotoğraf).
+- 2026-10-08'den eski backend imajı yalnız `{ id }` döndürür: `yukle.data.absolute_path` `undefined`
+  çıkıyorsa imaj bayattır. Kaynak: backend `FileUploadStepTests`; canlı koşuyla henüz ölçülmedi.
+
 ## Table step kuralları
 
 - `rule` içinde `datasourceId` + `entityId` zorunlu; `selectFields`/`filters` öğelerinde

package/dist/resources/schema-fingerprint.json

@@ -1,7 +1,7 @@
 {
-  "hash": "ca0c6a8ebec39612cfa74fe6e1cb170b141038c1fbf63804e3ae3dd0cc418ec9",
-  "generatedAt": "2026-10-06T09:02:39.999Z",
-  "types": 335,
+  "hash": "1766032527c4215282c73fb003cbe3526babafabc8588b80289dc28fd4e8b393",
+  "generatedAt": "2026-10-12T12:46:03.355Z",
+  "types": 337,
   "files": 167,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",
   "missing": [

package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json

@@ -273,7 +273,8 @@
           "authority-limit",
           "case-instance",
           "partner-relationship",
-          "connector-credential"
+          "connector-credential",
+          "monitoring"
         ],
         "type": "string",
         "format": ""

package/dist/resources/schemas/OrganizationProjectDto.json

@@ -194,6 +194,14 @@
             "type": "string",
             "nullable": true
           },
+          "slug": {
+            "type": "string",
+            "nullable": true
+          },
+          "displayName": {
+            "type": "string",
+            "nullable": true
+          },
           "isProduction": {
             "type": "boolean"
           },

package/dist/resources/schemas/UpsertMobileStoreSettingsCommand.json

@@ -117,6 +117,9 @@
       "review": {
         "$ref": "#/components/schemas/NgApps.Domain.Contexts.Organization.MobileStore.MobileStoreReviewModel"
       },
+      "ads": {
+        "$ref": "#/components/schemas/NgApps.Domain.Contexts.Organization.MobileStore.MobileStoreAdsModel"
+      },
       "expectedUpdatedAt": {
         "type": "string",
         "format": "date-time",
@@ -255,6 +258,40 @@
         },
         "additionalProperties": false
       },
+      "NgApps.Domain.Contexts.Organization.MobileStore.MobileStoreAdsModel": {
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "type": "boolean"
+          },
+          "iosAppId": {
+            "type": "string",
+            "nullable": true
+          },
+          "androidAppId": {
+            "type": "string",
+            "nullable": true
+          },
+          "testMode": {
+            "type": "boolean"
+          },
+          "consentForm": {
+            "type": "boolean"
+          },
+          "appOpenUnit": {
+            "type": "string",
+            "nullable": true
+          },
+          "units": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/NgApps.Domain.Contexts.Organization.MobileStore.MobileStoreAdUnitModel"
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "NgApps.Domain.Contexts.Organization.MobileStore.MobileStoreAppleCategoriesModel": {
         "type": "object",
         "properties": {
@@ -268,6 +305,28 @@
           }
         },
         "additionalProperties": false
+      },
+      "NgApps.Domain.Contexts.Organization.MobileStore.MobileStoreAdUnitModel": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "format": {
+            "type": "string",
+            "nullable": true
+          },
+          "ios": {
+            "type": "string",
+            "nullable": true
+          },
+          "android": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
       }
     }
   }

package/dist/tools/applications.js

@@ -3,11 +3,14 @@ import { handle } from '../platform/responses.js';
 import { forgetApplication, readApplicationPlatform, resolveApplication } from '../knowledge/platform/resolve.js';
 import { mobileTabsProblems, readMobileTabs } from '../knowledge/platform/mobileTabs.js';
 import { findingLine } from '../knowledge/platform/profile.js';
+import { listComponents } from './components.js';
 import { z } from 'zod';
 /**
  * MOB-007 (sekme ayarı) — `properties.mobile.tabs` yazan mobil uygulama çağrısının denetimi. Yazım
  * platforma YİNE gider (D3; backend `properties`'i doğrulamaz): bulgu `platformWarnings`'e düşer.
- * Sayfa ve widget listesi okunamazsa o denetimler atlanır, biçim denetimi yine koşar.
+ * Sayfa ve widget listesi okunamazsa o denetimler atlanır, biçim denetimi yine koşar. Widget listesi
+ * `listComponents`'tan gelir: uç `type` verilmezse yalnız web bileşenlerini döner ve mobil widget'ı
+ * gösteren sekme ayarı yanlış MOB-007 alırdı (ARC-245).
  */
 export async function mobileTabsWarnings(platform, applicationId, projectSlug, homepageId, properties) {
     const tabs = readMobileTabs(properties);
@@ -19,8 +22,8 @@ export async function mobileTabsWarnings(platform, applicationId, projectSlug, h
             .catch(() => undefined)
         : undefined;
     const widgetIds = applicationId && projectSlug
-        ? await platform.tenant('GET', projectSlug, `/components/${applicationId}`, { query: { pageIndex: 0, pageLength: 999 } })
-            .then(response => new Set((response?.data ?? []).filter(entry => entry.kind === 'widget').map(entry => String(entry.id ?? ''))))
+        ? await listComponents(platform, projectSlug, undefined, applicationId)
+            .then(components => new Set(components.filter(entry => entry.kind === 'widget').map(entry => String(entry.id ?? ''))))
             .catch(() => undefined)
         : undefined;
     return mobileTabsProblems(tabs, {

package/dist/tools/common.js

@@ -61,12 +61,12 @@ export const pagingParams = {
     isDescending: z.boolean().optional()
 };
 /**
- * Dal adı kuralı: `Environment` ctor'unun aynası, gerçek koruma backend'dedir. Ad yalnız
- * `environment_create`'i değil, `page_screenshot`'ın `/branch/{env}` şeridini de ilgilendirdiği
- * için tek yerde durur — iki kopya birbirinden ayrılırsa gateway kabul ettiği bir adı
- * görüntüleyemez hâle gelir.
+ * Dal adı kuralı: `Environment` ctor'unun birebir aynası (`/` ve `-` serbest, 3-31 karakter),
+ * gerçek koruma backend'dedir. Ad yalnız `environment_create`'i değil, `page_screenshot`'ın
+ * `/branch/{slug}` şeridini de ilgilendirdiği için tek yerde durur — iki kopya birbirinden
+ * ayrılırsa gateway kabul ettiği bir adı görüntüleyemez hâle gelir.
  */
-export const branchNamePattern = /^[a-z][a-z0-9_]{2,30}$/;
+export const branchNamePattern = /^(?=.{3,31}$)[a-z][a-z0-9_-]*(\/[a-z0-9][a-z0-9_-]*)*$/;
 const reservedEnvironmentNames = new Set(['development', 'production', 'public', 'information_schema', 'dev', 'view', 'api', 'files', 'hubs']);
 /** Sabit ortamlar, url sözcükleri ve postgres şemaları: dal adı olamazlar */
 export function isReservedEnvironmentName(name) {
@@ -76,6 +76,10 @@ export function isReservedEnvironmentName(name) {
 export function isBranchName(name) {
     return branchNamePattern.test(name) && !isReservedEnvironmentName(name);
 }
+/** Dalın adres parçası: her `/` → `-` (backend `Environment.Slug`); `feature/x` → `feature-x` */
+export function branchSlug(name) {
+    return name.replace(/\//g, '-');
+}
 export const readOnly = { readOnlyHint: true, openWorldHint: false };
 export const writes = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
 export const updates = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };

package/dist/tools/entities.js

@@ -26,6 +26,40 @@ function preserveApplicationBinding(definition) {
     if (applicationIds.length > 0)
         definition.applicationIds = applicationIds;
 }
+/**
+ * 37 S-1: platform PATCH op'larını `EntityDto` OKUMA şekline uygular (`PatchEntityCommandHandler` →
+ * `UpdateEntityCommand.FromDto`, `ApplicationIds = Applications.Select(a => a.ApplicationId)`). Bağ
+ * `/applications` yolunda `{ applicationId }` öğeleriyle yazılır; `/applicationIds` belgede yoktur
+ * (gateway önizlemesi `OPERATION_PATH_UNRESOLVABLE` ile düşer), çıplak guid 500 `JsonException`,
+ * `{ id }` boş `applicationId` ile "This record is in use" verir. Ajan yazma adını bilerek geldiği
+ * için reddetmek yerine çevrilir ve `gatewayNormalized` ile söylenir (microservice `/roleIds` emsali).
+ */
+function normalizeApplicationBindingOps(operations) {
+    const notes = [];
+    const asBinding = (entry) => {
+        if (typeof entry === 'string')
+            return { applicationId: entry };
+        if (entry && typeof entry === 'object' && !('applicationId' in entry) && typeof entry.id === 'string')
+            return { applicationId: entry.id };
+        return entry;
+    };
+    for (const operation of operations) {
+        const path = typeof operation.path === 'string' ? operation.path : '';
+        if (path === '/applicationIds' || path.startsWith('/applicationIds/')) {
+            operation.path = `/applications${path.slice('/applicationIds'.length)}`;
+            notes.push(`patch yolu '${path}' → '${operation.path}': yamalanan belge entity_get'in OKUMA şeklidir (EntityDto) ve uygulama bağı orada 'applications' [{ applicationId }] alanıdır; 'applicationIds' yalnız create/update GÖVDESİNDE vardır.`);
+        }
+        const target = operation.path;
+        if (target !== '/applications' && !target.startsWith('/applications/'))
+            continue;
+        const before = JSON.stringify(operation.value);
+        operation.value = target === '/applications' && Array.isArray(operation.value) ? operation.value.map(asBinding) : target.split('/').length === 3 ? asBinding(operation.value) : operation.value;
+        if (JSON.stringify(operation.value) !== before) {
+            notes.push(`'${target}' değeri { applicationId } öğesine çevrildi — çalışan şekil: { op: 'replace', path: '/applications', value: [{ applicationId: '<application id>' }] }.`);
+        }
+    }
+    return notes;
+}
 /**
  * `UpdateEntityCommandHandler` gövdedeki `Indexes` null ise onu BOŞ LİSTEYE çeviriyor
  * (`request.Indexes?…ToList() ?? []`) ve `Entity.FindProcessedIndexes` boş listede entity'nin
@@ -178,7 +212,7 @@ export function registerEntityTools(server, platform) {
     }));
     server.registerTool('entity_patch', {
         title: 'Entity\'ye patch uygula',
-        description: "YENİ alanı korumayla ya da türetilmiş alan olarak eklemek için de kullanılır (PROT-003/PROT-004); eklenen ya da kuralı değişen türetilmiş alanı dolu satırlarda derived-fill işi doldurur (tablo kilitlenmez, bitiş import_history { entityId }). VAR OLAN alanın korumasını değiştirmez — platform 400 ProtectionChangeNotAllowed döner, gateway istek göndermeden durdurur ve yol entity_protection_update'tir. Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut tanımı okur, yolları çözer ve op'ları platformun PATCH /entities/{id} ucuna `{ baseVersion, ops }` olarak geçirir — tam gövde PUT'u ATILMAZ, yalnız fark yazılır. Yanıt outline özetidir. YOLLARDA SEÇİCİ KULLANIN, indeks değil: '/fields[slug=email]/nullable' — indeksle yazmak alan sırası değişince SESSİZCE yanlış alanı yazar. Gateway seçiciyi indekse çevirir ve hangi kayda indiğini yanıttaki patchTargets ile söyler. `baseVersion` okunan kaydın `version` alanından gelir; kayıt bu arada değiştiyse platform 409 döner ve HİÇBİR op uygulanmaz. 'applications' → 'applicationIds' çevirisini artık platform yapar. `fields[].isLocalized: true` alanı ana tablodan çıkarıp companion `<slug>_localization` entity'sine taşır (yalnız düz METİN alanı; anahtar/unique/ilişki olamaz) — platform_guide('entity') §'Çoklu dilli alan'.",
+        description: "YENİ alanı korumayla ya da türetilmiş alan olarak eklemek için de kullanılır (PROT-003/PROT-004); eklenen ya da kuralı değişen türetilmiş alanı dolu satırlarda derived-fill işi doldurur (tablo kilitlenmez, bitiş import_history { entityId }). VAR OLAN alanın korumasını değiştirmez — platform 400 ProtectionChangeNotAllowed döner, gateway istek göndermeden durdurur ve yol entity_protection_update'tir. Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut tanımı okur, yolları çözer ve op'ları platformun PATCH /entities/{id} ucuna `{ baseVersion, ops }` olarak geçirir — tam gövde PUT'u ATILMAZ, yalnız fark yazılır. Yanıt outline özetidir. YOLLARDA SEÇİCİ KULLANIN, indeks değil: '/fields[slug=email]/nullable' — indeksle yazmak alan sırası değişince SESSİZCE yanlış alanı yazar. Gateway seçiciyi indekse çevirir ve hangi kayda indiğini yanıttaki patchTargets ile söyler. `baseVersion` okunan kaydın `version` alanından gelir; kayıt bu arada değiştiyse platform 409 döner ve HİÇBİR op uygulanmaz. UYGULAMA BAĞI '/applications' yolundadır ve öğeleri { applicationId } nesneleridir: {op:'replace', path:'/applications', value:[{applicationId:'<application id>'}]} — tam listeyi yazar; tek bağ eklemek {op:'add', path:'/applications/-', value:{applicationId:'<application id>'}}. '/applicationIds' yolunu ya da çıplak guid / { id } öğesini gateway bu şekle çevirir ve gatewayNormalized ile söyler; 'applications' → 'applicationIds' gövde çevirisini platform yapar. `fields[].isLocalized: true` alanı ana tablodan çıkarıp companion `<slug>_localization` entity'sine taşır (yalnız düz METİN alanı; anahtar/unique/ilişki olamaz) — platform_guide('entity') §'Çoklu dilli alan'.",
         inputSchema: { project: projectParam, environment: environmentParam, datasourceId: guid.optional().describe('Verilmezse gateway datasource ağacından bulur'), id: entityRef, operations: patchOperationsParam.optional(), ops: patchOperationsParam.optional().describe("'operations' ile aynı alan (eşanlamlı) — sayfa micro-op tool'larıyla aynı adı kullanabilmeniz için"), policyOverride: policyOverrideParam },
         annotations: updates
     }, handle(config, async ({ project, environment, datasourceId, id, operations: givenOperations, ops, policyOverride }) => {
@@ -187,7 +221,10 @@ export function registerEntityTools(server, platform) {
         const entity = datasourceId && isGuid(id) ? { entityId: id, datasourceId } : await resolver.entity(id);
         const current = await platform.tenant('GET', project, `/entities/${entity.datasourceId}/${entity.entityId}`, { environment });
         const definition = structuredClone((current?.data ?? current));
-        const resolvedOps = resolvePatchOperations(definition, operations, 'entity_get');
+        // Bağ yolu seçici çözümünden ÖNCE çevrilir: '/applicationIds' belgede yoktur (37 S-1).
+        const bindingOperations = structuredClone(operations);
+        const bindingNotes = normalizeApplicationBindingOps(bindingOperations);
+        const resolvedOps = resolvePatchOperations(definition, bindingOperations, 'entity_get');
         // Politika, yazmadan önce sonucu görmeli; yerel kopya YALNIZ değerlendirme için, gövde olarak gönderilmez.
         const preview = fastJsonPatch.applyPatch(definition, resolvedOps.operations, true, false).newDocument;
         const protectionChanges = changedExistingProtections(current?.data ?? current, preview);
@@ -208,7 +245,7 @@ export function registerEntityTools(server, platform) {
         });
         const written = patchResult(saved, preview);
         const touched = patchedSections(written.data, resolvedOps.operations);
-        return attachFindings(withUnmappedMembers(withResolved({
+        return attachFindings(withUnmappedMembers(withResolved(withNormalization({
             applied: operations.length,
             newVersion: written.newVersion,
             patchTargets: resolvedOps.targets,
@@ -216,7 +253,7 @@ export function registerEntityTools(server, platform) {
             // S-8: yazılanın kanıtı yanıtta dursun; dokunulmayan bölümler outline'da kalır.
             ...(Object.keys(touched).length > 0 ? { touched } : {}),
             outline: entityOutline(written.data)
-        }, resolver.resolved), drift), findings);
+        }, bindingNotes), resolver.resolved), drift), findings);
     }));
     server.registerTool('entity_protection_update', {
         title: 'Alan korumasını değiştir',

package/dist/tools/environments.js

@@ -4,7 +4,7 @@ import { handle } from '../platform/responses.js';
 import { z } from 'zod';
 /** Aggregate kuralının aynası (`Environment` ctor); gerçek koruma backend'dedir. Kural `common.ts`'te. */
 const branchName = z.string().regex(branchNamePattern)
-    .describe("Dal adı: küçük harfle başlar, yalnız küçük harf/rakam/alt çizgi, 3-31 karakter. Bu ad PG şema adı olur.");
+    .describe("Dal adı: küçük harfle başlar; küçük harf/rakam/alt çizgi/tire ve '/' ile ayrılmış parçalar (ör. feature/odeme), 3-31 karakter. Bu ad PG şema adı olur ve değişmez; adres parçası (slug) '/' yerine '-' taşır.");
 function assertBranchName(name) {
     if (isReservedEnvironmentName(name)) {
         throw new PlatformApiError(`environment_create: '${name}' rezerve bir şema adı — dal adı olarak kullanılamaz. Başka bir ad seçin.`, 400);

package/dist/tools/flows.js

@@ -515,10 +515,14 @@ export function registerFlowTools(server, platform) {
         };
         const authored = { steps: steps ?? [], errorSteps: errorSteps ?? [] };
         const normalized = [...normalizeFlowSteps(authored.steps), ...normalizeFlowSteps(authored.errorSteps)];
+        // Kurallar yalnız GÖNDERİLEN adımlara bakar (kayıtlı gövdeyi suçlamamak için); stepId
+        // benzersizliği ise birleşik akışta ölçülür: yalnız steps verilip kayıtlı errorSteps'le
+        // çakışan kimlik de platformda 500 verir.
         const findings = steps || errorSteps
             ? [
                 ...enforcePolicy(evaluatePolicy(config, policyRules, 'flow', authored, { operation: 'update' }, policyOverride)),
-                ...enforcePolicy(config.policyMode === 'off' ? [] : applyPolicyMode(config, connectedSetterFindings(authored.steps, authored.errorSteps, hostNodes(hostRecord)), policyOverride))
+                ...enforcePolicy(config.policyMode === 'off' ? [] : applyPolicyMode(config, connectedSetterFindings(authored.steps, authored.errorSteps, hostNodes(hostRecord)), policyOverride)),
+                ...enforcePolicy(evaluatePolicy(config, policyRules, 'flow', flow, { operation: 'update' }, policyOverride).filter(finding => finding.ruleId === 'FLOW-027'))
             ]
             : [];
         const parameterWarnings = [

package/dist/tools/layouts.js

@@ -3,7 +3,7 @@ import { resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import fastJsonPatch from 'fast-json-patch';
 import { fillComponentNames, componentNameNote, normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
-import { fetchHost, layoutUpdateBody, schemaParam, eventsParam, modeParam, summarize, findNode } from './screens.js';
+import { fetchHost, layoutUpdateBody, schemaParam, eventsParam, modeParam, summarize, findNode, readFullSchema } from './screens.js';
 import { assertScreenWriteGuards, assertScreenCatalog } from './screenWrite.js';
 import { applyPropTypesToSchema, isSetPropTypeOp, setPropTypeErrors } from '../knowledge/propTypes.js';
 import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
@@ -58,24 +58,39 @@ export function registerLayoutTools(server, platform) {
     }));
     server.registerTool('layout_schema_get', {
         title: "Layout komponent ağacını oku",
-        description: "Layout'un komponent ağacını (views) okur — page_schema_get'in layout karşılığı. Ağaçta hedefli değişiklik için layout_schema_patch (sayfa ile aynı micro-op sözlüğü, PATCH /layouts/{app}/{id}/schema). Ad/parametre/olay alanlarında ya da düz JSON Patch yolu gerektiğinde layout_patch — o araç buradaki updatedAt'i expectedUpdatedAt olarak kabul eder. Tam ağacı kendiniz yazacaksanız layout_update.",
+        description: "Layout'un komponent ağacını (views) okur — page_schema_get'in layout karşılığı. Ağaçta hedefli değişiklik için layout_schema_patch (sayfa ile aynı micro-op sözlüğü, PATCH /layouts/{app}/{id}/schema). Ad/parametre/olay alanlarında ya da düz JSON Patch yolu gerektiğinde layout_patch — o araç buradaki updatedAt'i expectedUpdatedAt olarak kabul eder. Tam ağacı kendiniz yazacaksanız layout_update. full ve subtree yanıtı nodeCount taşır; full tek yanıta sığmazsa HATA döner (sessiz kırpma yok): cursor:'0' ile parça parça okuyun — page_schema_get ile aynı sözleşme (items[] { parentElementId, index, node }, nextCursor bitene kadar; layout okuma arasında değişirse 409). allowTruncated:true kırpılmış gövdeyi açıkça verir — o gövdeyi layout_update'e geri yazmayın.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
             applicationId: guid,
             id: guid,
-            mode: modeParam,
-            componentId: z.string().optional().describe("subtree kipinde kök alınacak komponentin elementId'si")
+            mode: modeParam.describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm views; tek yanıta sığmazsa HATA döner — cursor:'0' ile parça parça okuyun (nextCursor bitene kadar) ya da allowTruncated:true ile kırpılmış gövdeyi açıkça isteyin."),
+            componentId: z.string().optional().describe("subtree kipinde kök alınacak komponentin elementId'si"),
+            cursor: z.string().min(1).optional().describe("Yalnız mode:'full': parçalı okuma. İlk çağrıda '0', sonra yanıttaki nextCursor; nextCursor gelmeyince views bitmiştir. Layout okuma arasında değişirse (updatedAt) 409 döner — cursor:'0' ile baştan başlayın."),
+            allowTruncated: z.boolean().optional().describe("Yalnız mode:'full': true verilirse sığmayan views hata yerine kırpılarak döner (nodeCount toplamı söyler, düşen düğümler söylenmez). Varsayılan false.")
         },
         annotations: readOnly
-    }, handle(config, async ({ project, environment, applicationId, id, mode, componentId }) => {
+    }, handle(config, async ({ project, environment, applicationId, id, mode, componentId, cursor, allowTruncated }) => {
         const layout = await fetchHost(platform, 'layout', project, environment, applicationId, id);
         const typeField = applicationTypeField(await resolveProfile(platform, applicationId));
         const audit = layout.audit;
         const updatedAt = audit?.updatedAt ?? audit?.createdAt;
         const views = (layout.views ?? []);
-        if (mode === 'full')
-            return { updatedAt, ...typeField, views };
+        if (cursor !== undefined && mode !== 'full') {
+            throw new PlatformApiError(`cursor yalnız mode:'full' ile çalışır (verilen mode: '${mode ?? 'summary'}'); parçalı okuma tüm views içindir. mode:'full' ile cursor:'0' verin ya da cursor'ı kaldırın.`, 400);
+        }
+        if (mode === 'full') {
+            return readFullSchema({
+                noun: 'Layout',
+                field: 'views',
+                nodes: views,
+                versionKey: String(updatedAt ?? ''),
+                base: { updatedAt, ...typeField },
+                cursor,
+                allowTruncated,
+                maxResponseBytes: config.maxResponseBytes
+            });
+        }
         if (mode === 'subtree') {
             if (!componentId)
                 throw new PlatformApiError("mode='subtree' için componentId zorunludur.");