@appaflytech/zeyrek-ai-mcp 0.0.7 → 0.0.8

package/dist/resources/guides/microservice.md

@@ -77,6 +77,12 @@ servis formunda görünür ve `microservice_get` outline görünümünde geri ok
      > (`'all'`) ve SQL'de ona bakan bir dal. Aynı davranış workflow query adımında da geçerli;
      > oradaki anlatım `platform_guide('workflow')` "Query adımı" bölümünde.
      >
+     > **`(@p = '' OR kolon = @p)` YAZMA** — "filtre boşsa hepsini getir" dalı hiçbir zaman
+     > çalışmaz, çünkü boş değer `NULL` bağlanır. Değeri form bileşeninden gelen parametrede
+     > dokunulmamış alanın `null` ya da `''` göndermesi fark etmez; ikisi de `NULL` olur
+     > (2026-09-15 bulgusu: pano 0 kart, `COALESCE`/`IS NULL` ile 141). Gateway bu kalıbı
+     > `query_create`/`query_update`/`query_preview`'da **QRY-007** (warn) ile işaretler.
+     >
      > **KAPSAM UYARISI: query kaynaklı ucun parametreleri ÇAĞRIDAN gelir.** Middleware'in
      > kurduğu `user` bu yola girmez — kimlik/tenant kapsamını gövdeye yazan bir uç
      > sahtelenebilir (ölçüldü 2026-09-07). Kapsam sunucuda zorlanacaksa sorguyu bir workflow
@@ -116,6 +122,11 @@ servis formunda görünür ve `microservice_get` outline görünümünde geri ok
 5. **Doğrulama akışı:** `microservice_preview` (kaydetmeden) → kaydet → `microservice_execute`
    (gerçek runtime yolu) → sonuç beklenmedikse **aynı parametrelerle `microservice_debug`** —
    adım adım executionItems ağacı döner.
+   Çağrı parametrelerini (sorgu parametresi, filtre değeri) üst düzey `parameters: { ad: değer }`
+   ile ver; gateway GET'te query-string'e, POST/PUT'ta gövdeye koyar. Değeri NULL bağlanan query
+   parametresini debug yanıtı `unboundParameters` ile söyler — ağaçta o satırın `value` anahtarı
+   görünmez. Tool'un tanımadığı bir üst düzey argüman artık reddedilir (GW-005); 2026-09-15'e
+   kadar `parameters` hata vermeden atılıyordu ve dört farklı filtre aynı gövdeyi döndürdü (G-13).
 
 ## Yanıt sözleşmesi (DTO) uca DEĞİL workflow'a bağlanır (MS-018, block)
 
@@ -159,8 +170,9 @@ DTO'dan süzülmez (WF-026 — `platform_guide('workflow')` §Hata yolu). Sözle
 ## Asgari doğru table-source microservice (platformda doğrulanmış kurallar)
 
 - `operation` enum'u **tam olarak** şudur ([MicroserviceTableOperation](../../../../zeyrek-backend/src/NgApps.Domain/Contexts/Studio/Microservices/MicroserviceTableOperation.cs)):
-  `get · create · update · delete · upsert · count`. **`list` yoktur** — liste için
-  `operation: 'get'` + `isSingle: false`, tek kayıt için `isSingle: true`.
+  `get · create · update · delete · upsert · count · bulk-create · bulk-update · bulk-delete`.
+  **`list` yoktur** — liste için `operation: 'get'` + `isSingle: false`, tek kayıt için
+  `isSingle: true`.
 - **`upsert` vardır ve tercih edilmelidir.** Aynı formun hem yeni kayıt hem düzenleme
   yapmasını iki ayrı uç + akışta condition dallanmasıyla kurmayın: tek `operation: 'upsert'`
   ucu yeterlidir. Aynı işlem workflow **table step**'inde de desteklenir
@@ -174,9 +186,42 @@ DTO'dan süzülmez (WF-026 — `platform_guide('workflow')` §Hata yolu). Sözle
 
 > **Upsert'te üretilen alan tuzağı.** `operation: 'upsert'` UPDATE yolunda da alan ifadelerini
 > yeniden değerlendirir; sicil/kod gibi üretilen bir değeri `source: 'expression'` ile yazarsan
-> güncellemede **sessizce değişir** (İK koşusu M-3: EMP-0005 → EMP-0006). Alan bazlı
-> `writeOn: create | update | always` platformda **yok**; o gelene kadar oluşturma ve güncelleme
-> için iki ayrı uç kurun. Gateway **MS-016** ile uyarır.
+> güncellemede **sessizce değişir** (İK koşusu M-3: EMP-0005 → EMP-0006). Çözüm alan bazlı
+> **`writeOn: create | update | always`**'dir (varsayılan `always`) ve 2026-09-04'ten beri
+> platformdadır: üretilen alana `writeOn: 'create'` verirsen upsert'in UPDATE dalı o alanı satıra
+> hiç koymaz (`ToRow(entityDto, writeOn)` iki satırı ayrı kurar). `writeOn` YALNIZ
+> `operation: 'upsert'` ucunda anlamlıdır — başka operasyonda `always` dışında bir değer
+> **MS-017** ile reddedilir. Gateway **MS-016** ile uyarır; alan `writeOn: 'create'` taşıyorsa
+> susar. **`writeOn` bir "kısmi güncelleme" bayrağı DEĞİLDİR** — hangi DALIN yazacağını söyler,
+> "gövdede gelmeyen alanı atla" demez (aşağıdaki §Güncelleme sözleşmesi).
+- **Toplu yazma için `bulk-create` / `bulk-update` / `bulk-delete` vardır.** Aynı tabloya N satır
+  yazmak için akışta döngü kurmayın: bu üç uç gövdedeki **JSON diziyi** tek çağrıda işler
+  ([TableMicroserviceExecutor](../../../../zeyrek-backend/src/NgApps.Domain/Contexts/Studio/Microservices/Executors/TableMicroserviceExecutor.cs)).
+  Kurallar:
+  - Gövde bir **dizi** olur; her eleman bir satırdır. `bulk-delete` gövdesinde yalnız birincil
+    anahtar alanı aranır ve tek bir `IN` filtresine çevrilir.
+  - `filters` **kullanılmaz** — satırlar ve anahtarlar gövdeden okunur.
+  - Tek istekte en fazla **1000 satır** (`EntityConstants.BulkRowLimit`); aşılırsa
+    `BulkRowLimitException` (422).
+  - Parti **hep-ya-hiç**tir: bir satır doğrulamadan geçmezse `BulkRowFailedException` hangi
+    satırın (index) patladığını söyler ve hiçbir satır yazılmaz.
+  - **Dosya alanı olan tablolarda `bulk-create`/`bulk-update` da desteklenir** — her satırın
+    dosya (ve çoka-çok dosya) alanı, tekil `create`/`update` ile **aynı format** üzerinden
+    (`{ type, fileName, value, clone, override, id }`) satır satır `fileService`'e gönderilir;
+    artık dosya alanı yüzünden 422 dönmez. Aynı entegrasyon workflow **table step**'inde de
+    vardır (satır dizisindeki dosya değeri de aynı formatı izler).
+  - **Bulk upsert yoktur.**
+  - `bulk-update` gövdesinde birincil anahtar **bulunur ve zorunludur** — tekil `update`'in
+    aksine satırı belirleyen filtre değil, gövdedeki anahtardır. `UpdateRowsAsync` bu anahtarı
+    `SET` listesinden dışlayıp `WHERE`'e taşır, bu yüzden alan listesinde görünmesi doğrudur ve
+    GENERATED ALWAYS koruması onu es geçer.
+  - Workflow **table step**'inde de aynı üç işlem vardır; orada satır dizisi adımın `expression`
+    alanından (JS) gelir, gövdeden değil. **Ancak studio'nun workflow table formunda bu
+    `expression` alanı için editör henüz yoktur** — akış adımında bulk seçilirse satır dizisi
+    girilemez ve adım `MissingParameterException` ile düşer. v1'de bulk yalnız microservice
+    ucundan kullanılır.
+  - Adımda tanımlı ama değeri boş bırakılan alanlar gövdeden/expression'dan gelen veriyi
+    **ezmez**; yalnız değeri dolu olan sabitler her satıra uygulanır.
 - **`count` vardır** — kayıt sayısı için tüm satırları çekip uzunluğuna bakmayın; panel/KPI
   sayaçlarının doğru şekli budur.
 - Gövde kökünde **`entityId` zorunlu**. (Eski "kökte datasourceId zorunlu" bilgisi yanlıştı —
@@ -233,6 +278,61 @@ DTO'dan süzülmez (WF-026 — `platform_guide('workflow')` §Hata yolu). Sözle
 }
 ```
 
+## Güncelleme sözleşmesi: yazılan alan kümesi TANIMDAN gelir, gövdeden DEĞİL
+
+`create` / `update` / `upsert` ucunda **SET listesi `fields[]`'tir**; gövde yalnız o alanların
+DEĞERİNİ taşır. Studio'daki karşılığı "Oluşturulacak veya güncellenecek alanlar" ekranındaki
+**İstek alanları** listesidir: önce hangi alanların yazılacağı seçilir, gövde sonra gelir.
+İki yön de sessizdir, ikisi de 200 döner (ölçüm: 2026-09-15, `emrah/test`, `development`):
+
+| Tanımda (`fields[]`) | Gövdede | Sonuç |
+|---|---|---|
+| alan **var** | anahtar **yok** | kolona **NULL yazılır** — eski değer silinir |
+| alan **var** | anahtar var | değer yazılır |
+| alan **yok** | anahtar var | **yok sayılır** — o alan bu uçtan hiç değiştirilemez |
+
+Kod yolu: gövdede anahtar yoksa alan `null` değerini alır
+(`MicroserviceRuntimeCacheDto.SetSourceEntityFieldAndFilterValue`, `:145-148`), `ToRow` Default
+modlu **bütün** alanları sözlüğe basar (`:169-175`) ve `UpdateRowAsync` SET listesini doğrudan o
+sözlüğün anahtarlarından kurar (`PostgreSqlEntityConnector.cs:262-273`; null → `DBNull.Value`).
+"Yalnız gövdede gelen alanı yaz" diye bir bayrak **yoktur**.
+
+Ölçülen üç vaka (`pu_test`: `title` · `owner` · `status`):
+
+| # | Uç tanımı | Gövde | Sonuç |
+|---|---|---|---|
+| 1 | `fields: [title, owner, status]` | `{ id, status: 'done' }` | 200 — `status` değişti, **`title` ve `owner` NULL** oldu (`entity_audit_trails` ikisini de yalnız `previousValue` ile gösteriyor) |
+| 2 | `fields: [status]` | `{ id, status, title: '…', owner: '…' }` | 200 — yalnız `status` değişti; listelenmeyen iki alan **yazılmadı** |
+| 3 | `fields: [title, owner, status]`, `status` kolonu NOT NULL | `{ id, title }` | **400 `RowValidationFailed`** ("Please complete all required fields") — satır hiç değişmedi |
+
+Yani kolon `nullable` ise kayıp **sessizdir**, NOT NULL ise istek **gürültülü** düşer. Kanban'da
+kart sürüklemek, satır içi tek alan düzenlemek, "arşivle" düğmesi — hepsi 1. satırın tuzağıdır:
+kart doğru sütuna geçer, başlığı ve sorumlusu silinir.
+
+### Kısmi güncellemenin üç doğru yolu
+
+1. **Eylem başına uç (varsayılan tercih).** Kartı taşıyan uç yalnız `status` yazar, başlığı
+   düzenleyen uç yalnız `title`: `fields[]` = o eylemin gerçekten yazdığı alanlar. Fazladan okuma
+   yok, eşzamanlı düzenlemede birbirini ezme yok, yetki yüzeyi de dar kalır (2. ölçüm bunun
+   kanıtıdır — uç, gövdeye konan `title`/`owner`'ı yok sayar).
+2. **Tam form ucunda gövde de tam olur.** Düzenleme formu kaydediyorsa gövde `fields[]`'teki HER
+   alanı taşır; kullanıcının dokunmadığı alan da forma yüklendiği hâliyle geri gönderilir. Uçta
+   yapılacak bir şey yoktur — eksik gönderen istemci alanı siler.
+3. **Oku-birleştir (alan kümesi ancak çağrı anında belliyse).** Akışta önce `table get`, sonra
+   `table update`; gelmeyen alan okunan değere düşer:
+
+   ```js
+   typeof input.title !== 'undefined' && input.title !== null ? input.title : read_row.data.title
+   ```
+
+   Ölçüldü: `{ id, status }` gövdesiyle `title` ve `owner` korundu, `status` yazıldı. Bedeli iki
+   veritabanı turu ve **son yazan kazanır** — okuma ile yazma arasında başkasının yazdığı alan
+   geri alınır. Bu yüzden 1. yol varken bu yola girilmez.
+
+> Aynı kural workflow **table step**'inde birebir geçerlidir; orada değer gövdeden değil
+> ifadeden gelir ve `undefined` dönen ifade de `null` yazar —
+> `platform_guide('workflow')` §"Table update adımı".
+
 ## İlişki alanı: `row_list` NESNE döner, uç/step JOIN'siz DÜZ FK döner
 
 Aynı alan iki yoldan farklı şekilde gelir ve bu fark sessizce yanlış sonuç üretir:

package/dist/resources/guides/page.md

@@ -78,16 +78,18 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
   her turda çözümlenmiş metinle EZER — anahtar yalnız `ref`'te yaşar, `data`'ya yazıp
   güvenme (`code` prop'uyla aynı davranış). Tam şekil, fallback zinciri ve `translation_*`
   tool'ları için `platform_guide('translation')`.
-- **Kurulmuş bir düğümün prop TİPİNİ `set_prop_type` micro-op'u değiştirir.**
+- **Kurulmuş bir düğümün prop TİPİNİ yerinde değiştir — düğümü yeniden KURMA.** İki eş yol var:
+  `{ op: 'replace_prop', target: '<elementId>', prop: 'content', value: { type: 'translation', ref: 'dashboard.kpi.total' } }`
+  (applier `code` ve `translation` sarmalını tipiyle korur; gateway 2026-09-15'e kadar translation
+  sarmalını reddediyordu) ya da
   `{ op: 'set_prop_type', target: '<elementId>', prop: 'content', propType: 'translation', ref: 'dashboard.kpi.total' }`
-  bir `static` prop'u çeviriye, `propType: 'code'` + `ref: '<ifade>'` koda, `propType: 'static'` +
-  `data: <değer>` sabite bağlar. Bu bir **gateway emülasyonudur**: `replace_prop` gönderilen ham
-  değeri her zaman `static` Prop'una sarar ve sarmalanmış Prop nesnesini reddeder, yani prop tipini
-  yazamaz. Op olmadan tek yol düğümü `remove_component` + `add_component` ile yeniden kurmaktı;
-  2026-09-06 koşusunda on bir etiket bu yolla kuruldu ve onlara yazan **dokuz setter iteratee'si**
-  platform tarafından sessizce silindi (üç KPI kartı boş kaldı). Taşıyıcı alan tipe göre değişir —
-  `static` değeri `data`'da, `code` ve `translation` `ref`'te taşır; eksik taşıyıcı istek
-  gönderilmeden reddedilir ve `page_schema_validate` aynı kararı verir.
+  (gateway emülasyonu; mevcut `data`'yı tasarım yedeği olarak taşır). Taşıyıcı alan tipe göre
+  değişir — `static` değeri `data`'da, `code` ve `translation` `ref`'te taşır; eksik taşıyıcı istek
+  gönderilmeden reddedilir ve `page_schema_validate` aynı kararı verir. Eski yol
+  `remove_component` + `add_component` idi: 2026-09-06 koşusunda on bir etiket bu yolla kuruldu ve
+  onlara yazan **dokuz setter iteratee'si** sessizce silindi; 2026-09-15'te (G-04) aynı zincir bir
+  `daterangepicker` yer tutucusunu çeviriye bağlarken tekrarlandı — setter hedefi elementId değil
+  komponentin iç kimliğidir (aşağıda Kural 2, `FLOW-018`).
 
 - **`blocks[].size`, komponentin `component_get`'teki `maxSize`'ını aşamaz.** Dikkat: katalog
   varsayılanı aşabiliyor (`page-header` default `h:8`, `maxSize` `h:4`) — varsayılanı körü körüne
@@ -394,6 +396,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:
+> `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ç" } }`.
+
 > **Hangi yolu seçeceksin — `errorSteps` mi, ana akışta `condition` mı?** İkisi birden
 > kurulamaz (yukarıdaki 1. madde), yani bu bir tercih değil bir karar:
 >
@@ -893,6 +903,16 @@ Beş şeyi bilmeden flex kurma:
    aradaki boşluklar çizilmez. Yine de bitişik ver (0,1,2…): kapsayıcı ileride `grid`'e
    döndürülürse şema geçerli kalsın. Gateway bu yüzden **flex kapsayıcının İÇİNDE PAGE-010
    boşluk uyarısı üretmez** (ızgarada üretmeye devam eder).
+   **Dizi sırası çizimi belirlemez** — `children[]` içindeki yer değil `y` kazanır; `y`'si eşit
+   iki çocukta dizi sırası kazanır. Bu yüzden flex kapta sıralamanın yolu `index`'tir:
+   `add_component`/`move_component`'e verilen `index` **görünen sıradaki yeri** belirler ve gateway
+   kardeşlerin konumunu Studio'nun flex tuvali gibi yeniden yazar (x=0, alt alta birikimli y;
+   yanıtın `gatewayNormalized` notu hangi `y`'nin değiştiğini söyler). Grafiğin üstüne başlık:
+   `{ "op": "add_component", "parent": "<flex kap>", "index": 0, "component": { … } }` — koordinat
+   hesaplamak gerekmez, `remove_component` + `add_component` hiç gerekmez. **Izgara kapta `index`
+   çizimi değiştirmez** (her çocuk kendi `position`'ında mutlak çizilir): sırayı
+   `move_component { target, position: { x, y } }` ile ver; sona eklemeyen `index` orada
+   **PAGE-033 (uyarı)** üretir.
 3. **Flex kapsayıcının yüksekliği içeriğine oturur.** `verticalAlign`'ın dağıtacak boşluğu
    olması için `appearance.heightType: 'fixed'` vermelisin — ölçü `heightString`'den
    (serbest CSS uzunluğu, ör. `"30vh"`), o yoksa `size.h × 10px`'ten gelir. `heightString`
@@ -1010,7 +1030,8 @@ UYGULAMAZ** — koordinatları aynen kaydeder (aşağı itme yalnız `page_creat
 > sarmalayıcıya bağla (yukarıdaki `box_multi`). Sarmalayıcıyı **`isWrapper:false`** kur
 > (Kural 1f: wrapper = `min-height:80vh`) ve çerçevesini `style` ile kapat:
 > `{ background:'transparent', border:'none', '&__body': { padding:'0px' } }`.
-> `appearance.isHidden` diye bir kaçış yolu YOKTUR — runtime onu hiç okumaz.
+> `appearance.isHidden` diye bir alan YOKTUR (2026-09-15'te platformdan kaldırıldı, S-16) —
+> görünürlük yalnız `props.isHidden`'dır.
 
 > **Satır BAŞINA doğrulama kurulamaz.** `validations` komponentin kendisindedir, tüm satırlar
 > onu paylaşır — "3. soru zorunlu, 4. soru değil" şemayla ifade edilemez. Zorunluluk satır
@@ -1559,6 +1580,19 @@ alanına dokunur. **Komponenti silip yeniden eklemeyin:** `remove_component` + `
 turu o komponente bağlı setter hedeflerini koparır (Kural 1e sonundaki not) ve komponentin tek
 referans verdiği akışları kalıcı olarak sildirir (Kural 2'deki yan etki notu).
 
+**Kurulu düğümün appearance'ını değiştirmek: `set_appearance`.** Aynı gerekçeyle appearance için
+de silip yeniden ekleme gerekmez:
+
+```jsonc
+{ "op": "set_appearance", "target": "box_summary", "appearance": { "heightType": "auto", "tooltip": null } }
+```
+
+Op **birleştirir**: yalnız verilen alanları yazar, gerisini korur; `null` alanı temizler. Alan
+adları `page_schema_get`'in döndürdüğü appearance anahtarlarıdır; bilinmeyen alan
+`unknown-appearance-field`, tanınmayan enum değeri (`heightType: "tall"`) 400 ile reddedilir.
+**`isHidden` bir appearance alanı DEĞİLDİR** — gizlemek için `replace_prop { prop: 'isHidden' }`
+ya da `set_binding { prop: 'isHidden' }` (Kural 7a'daki `isHidden` notu).
+
 **Kip ayrımı query parametresidir:** aynı sayfa `?id=<kayıt>` ile edit, parametresiz create.
 
 `mount` akışı (`page_container` ya da `form` üzerine bağlanır):
@@ -1671,10 +1705,12 @@ start → [setter] btn_save.isLoading = true
 > artık doğrudan `props.isHidden` yazılabilir; sırf gizlemek için `container`'a sarmak
 > GEREKMEZ. Tek doğru kaynak `component_get` + `page_schema_validate` kuru koşusudur.
 >
-> **`appearance.isHidden` bir kaçış yolu DEĞİLDİR:** kaydedilir ama runtime hiçbir yerde okumaz
-> (renderer yalnız `props.isHidden`'a bakar) — komponent görünmeye devam eder. Başlangıçta gizli
-> göstermek için ya komponenti `isHidden`'ı OLAN bir `container`'a sar (Kural 1g) ya da
-> görünürlüğü sayfa açılış akışının setter'ıyla kur.
+> **Appearance'ta `isHidden` alanı YOKTUR** (2026-09-15'te platformdan kaldırıldı, S-16): renderer
+> yalnız `props.isHidden`'a bakar. Başlangıçta gizli bildirim şemada
+> `"props": { "isHidden": { "type": "static", "data": true } }` ile kurulur, açılışı akıştaki
+> setter yapar. `add_component` / `page_update` gövdesine yine de `appearance.isHidden` konursa
+> gateway değeri `props.isHidden`'a taşır ve `gatewayNormalized`'da bildirir (prop zaten verilmişse
+> o kazanır); `set_appearance` ile `isHidden` yazmak istek gönderilmeden reddedilir.
 
 ### 7b — Liste → form geçişi
 
@@ -1864,6 +1900,18 @@ hiçbiri** bağlı değildi; üç portalın da rol menüsü boş çıkıyor, pan
 > hiç görünmeyen düğüm var; `zeroSized` çizilmemiş komponenti gösterir. Runtime düğümleri
 > `data-element-id` basmıyorsa yanıt `layoutReportUnavailable` der — tool tahmin üretmez.
 >
+> **Sürükle-bırakı gerçekten sınamak (G-09).** `kanban` ve `eventcalendar` iç öğelerine
+> `<elementId>__<rol>` kimliği yazar (tablonun `__row-<n>`'i ile aynı kalıp):
+> kart `kb_board__card-<id>`, kolon `kb_board__col-<value>`; etkinlik `cal_plan__event-<id>`,
+> gün `cal_plan__day-<yyyy-MM-dd>`, tüm gün hücresi `cal_plan__allday-<yyyy-MM-dd>`, saat dilimi
+> `cal_plan__slot-<yyyy-MM-dd>T<HH>`. `id`, `idField`'ın değeridir (yoksa `card-<sıra>` /
+> `event-<sıra>`); tarih yereldir. Tıklama yolu `click` ile, taşıma `drag` ile sınanır:
+> `actions: [{ action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned' }]`.
+> `actionsReport[].flowRuns`/`requests` sıfırsa `cardMove`/`eventMove` bağı kurulu görünse de
+> taşıma kalıcılaşmamıştır. Kaynak `draggable` değilse (`isDraggable`/`isEditable` kapalı)
+> adım `applied:false` ve notla döner. Çok günlü etkinlik aynı kimliği her gün hücresinde taşır;
+> hedef ilk eşleşmedir.
+>
 > **Üye kimliğiyle doğrulama (`asUser`).** Kapının kapalı olduğunu görmek yarısıdır; açık
 > olduğunu görmek diğer yarısı. `page_runtime_get` ve `page_screenshot` aynı `asUser` alanını
 > alır: uygulamanın kendi giriş ucundan (`microservice_execute`) aldığın üye jetonunu verirsin,
@@ -1951,10 +1999,22 @@ micro-op hattına dönün.
 >
 > **Gateway artık bunu söylüyor (FLOW-018).** `remove_component` içeren bir yamada gateway sayfanın
 > akışlarını okur ve silinen düğümü hedefleyen setter adımlarını uyarı olarak listeler: hangi akış,
-> hangi adım, hangi hedef. Uyarıyı gördüğünde yapılacak tek şey `flow_update` ile aynı gövdeyi
-> yeniden kaydetmektir. Ters yönü (`silinen düğümün referans verdiği` akışların platformca kalıcı
+> hangi adım, hangi hedef. Ters yönü (`silinen düğümün referans verdiği` akışların platformca kalıcı
 > silinmesi) ayrı bir uyarı kapsar; ikisi birlikte çıkabilir. Ölçüm 2026-09-04 (benchmark 4. koşu):
 > uyarı yokken aynı tuzak ~8 dakika teşhis aldı ve yalnız ekran görüntüsüyle görüldü.
+>
+> **Mekanizma ve onarım (2026-09-15, G-04).** Setter iteratee'si hedefini elementId olarak DEĞİL,
+> komponentin iç kimliği olarak saklar (`step_iterates.DesignComponentId`, FK `SetNull`); düğüm
+> yeni kimlikle yazılınca eski satır silinir ve alan boşalır — `flow_get` iteratee'yi `element`'siz
+> döndürür. Bu yüzden **`flow_get`'ten okunan gövdeyi aynen yeniden kaydetmek onarmaz** (element
+> zaten yok; `flow_update` FLOW-017'ye takılır). İki güvence var: (1) backend artık AYNI yamada
+> silinip aynı `elementId` ile eklenen düğüme (alt ağaç dahil) eski kimliğini geri veriyor, bağ
+> kopmuyor; (2) gateway yamadan sonra akışları yeniden okur ve kopan her iteratee için yanıtta
+> `flowTargetsLost` ile hazır onarımı verir:
+> `flow_patch` `{ op: 'add', path: '/steps[stepId=s4]/args/iteratees/0/element', value: 'f_range' }`.
+> `flow_get` de hedefsiz setter iteratee'sini `flowWarnings` (`FLOW-017 (okuma)`) ile gösterir.
+> Ayrı isteklerle (önce sil, sonra ekle) yapılan yeniden kurulum ve komple şema yazan `page_update`
+> bu korumanın DIŞINDADIR — prop tipini değiştirmek için düğümü hiç yeniden kurmayın.
 
 ## Bilinen sınırlar
 
@@ -2029,8 +2089,11 @@ micro-op hattına dönün.
   (süssüz) ekrana ifadenin **kendisini** basar; ifade yalnız `data`'da olursa prop **boş**
   render edilir. `set_binding` micro-op'u eski sürümlerde `data`'ya yazıyordu — bu davranış
   düzeltildi, ama daha önce kurulmuş sayfalarda kalıntı olabilir. Prop nesnesini birebir
-  kontrol etmen gerekirse `remove_component` + `add_component` ile
-  `{"type":"code","ref":"{{ … }}","data":"<yedek>"}` yaz; `replace_prop` her zaman `static` kurar.
+  kontrol etmen gerekirse `replace_prop` ile
+  `value: {"type":"code","ref":"{{ … }}"}` yaz — code tipi ve `ref` olduğu gibi kaydedilir
+  (platform code prop'unda `data`'yı saklamaz).
+  `replace_prop`'a `expression` alanı verme: platform onu yalnız `set_binding`'de okur (gateway
+  code sarmalına çevirir).
 
 - **Ana sayfa sayfadan değil application'dan değişir:** `page_create/update` gövdesindeki
   `isHomepage` platformca yok sayılır (tasarım). Doğru yol `application_update` →

package/dist/resources/guides/translation.md

@@ -81,22 +81,23 @@ backend'de zaten tanımlı, Studio'nun "Translate" aksiyonunun ürettiği şekil
   "value": { "type": "translation", "ref": "home.welcome", "data": "Hoş geldiniz" } }
 ```
 
-> **`replace_prop` ile kurulamaz, `set_prop_type` ile kurulur.** Micro-op applier her `value`'yu
-> `Static` (ifade verilmişse `Code`) Prop'a çevirir (`PageSchemaMicroOpApplier.cs:77`);
-> `translation` sarmalı gönderildiğinde sarmal `Data`'nın içine düşer ve prop sessizce bozulur.
-> Gateway `replace_prop`'un bu kullanımını **reddeder**. Kurulu bir prop'u çeviriye bağlamanın
-> yolu `set_prop_type`'tır:
+> **Yukarıdaki `replace_prop` sarmalı olduğu gibi çalışır (2026-09-15, G-04).** Micro-op applier
+> `{type, ref, data}` sözlüğünün tipini korur ve `Translation` Prop'unu `Ref` + metin `Data` ile
+> kurar (`PageSchemaMicroOpApplier.ApplyOne`). Gateway bu kullanımı eskiden reddedip komponenti
+> yeniden eklemeyi öneriyordu; o öneri uygulanınca düğüme yazan setter iteratee'lerinin `element`'i
+> silindi (bir panoda alt başlık ve tarih aralığı boş kaldı). Ref'siz translation sarmalı istek
+> gönderilmeden reddedilir; nesne `data` silinir. Eş yol `set_prop_type`'tır — mevcut `data`'yı
+> tasarım yedeği olarak taşır ve layout ağacında (micro-op hattı yok) tek yoldur:
 >
 > ```jsonc
 > { "op": "set_prop_type", "target": "welcome_text", "prop": "text",
 >   "propType": "translation", "ref": "home.welcome" }
 > ```
 >
-> Gateway şemayı okur, prop'un TİPİNİ yerinde değiştirir ve sayfayı tam gövdeyle geri yazar —
-> düğümün olay/setter bağları korunur. Eski yol (`remove_component` + `add_component`) düğümü
-> yeniden kurduğu için ona yazan setter iteratee'lerini sessizce öldürüyordu; artık gerekmiyor.
-> Taşıyıcı alan tipe göre değişir: `static` → `data`, `code` ve `translation` → `ref`. Eksik
-> taşıyıcı istek platforma gitmeden reddedilir ve `page_schema_validate` aynı kararı verir.
+> İkisi de düğümün olay/setter bağlarını korur. **Prop tipini değiştirmek için
+> `remove_component` + `add_component` yapmayın.** Taşıyıcı alan tipe göre değişir: `static` →
+> `data`, `code` ve `translation` → `ref`. Eksik taşıyıcı istek platforma gitmeden reddedilir ve
+> `page_schema_validate` aynı kararı verir.
 >
 > Ölçüldü 2026-09-08 (yerel `dil-dogrulama/dil-app`): kurulu bir `statcard`'ın `title` prop'u tek
 > `set_prop_type` op'uyla `f11.tam` anahtarına bağlandı; gerçek ekranda `tr` → "iki dilde dolu",

package/dist/resources/guides/workflow.md

@@ -375,6 +375,22 @@ Tek uçta "başlık + N alt kayıt" yazmanın yolu budur (anket + sorular + seç
   başka alana ihtiyacı varsa bunları **`returnFields`** ile iste
   (`{ alias, fieldId, fieldSlug }` öğeleriyle) — `selectFields` write operasyonunda sessizce
   yok sayılır.
+- **Bulk yazma (`bulk-create`/`bulk-update`/`bulk-delete`) table step'te de vardır**, ama tek
+  satırlık `create`/`update`'in aksine satır dizisi `fields`'tan değil, adımın **`expression`**
+  alanının (JS) sonucundan gelir: `rule.expression` bir **dizi** döndürmeli, dizideki her
+  nesnenin anahtarı alan **slug**'ıdır (fieldId değil). `bulk-delete`'te dizi ya birincil anahtar
+  değerlerinin düz listesi (`{ value: [...] }` şeklinde tek elemanlı sarmalayıcı) ya da her öğesi
+  `{ <pk slug>: <değer> }` olan nesne dizisidir. Tek istekte en fazla 1000 satır
+  (`EntityConstants.BulkRowLimit`); aşarsa `BulkRowLimitException`. `fields`'ta tanımlı ve
+  **değeri dolu** bir sabit varsa her satıra uygulanır; boş bırakılan alanlar `expression`
+  sonucundaki satırı ezmez.
+  - **Dosya (ve çoka-çok dosya) alanı `bulk-create`/`bulk-update`'te desteklenir** — microservice
+    tarafındaki `bulk-create`/`bulk-update` ile **aynı format**
+    (`{ type, fileName, value, clone, override, id }`); her satırın dosya değeri ayrı ayrı
+    `fileService`'e yüklenir, dosya alanı olan tabloda bulk artık reddedilmez.
+  - **Studio'nun workflow table formunda bulk için `expression` editörü henüz yoktur** — akışı
+    UI'dan kurarken bulk operasyonu seçilemez; `rule.expression`'ı JSON/`workflow_patch` ile elle
+    yazmak gerekir, yoksa adım `MissingParameterException` ile düşer.
 - **Çıktının ŞEKLİ `isSingle`'a bağlıdır** (ölçüm: 09-04 koşusu Y-15). `isSingle: true` ise
   `<step>.data` nesnedir ve `<step>.data.id` çalışır; **`isSingle: false` ise `data` bir
   DİZİDİR** — `<step>.data.id` `undefined` olur, akış `RowValidationFailed` ile düşer ve hata
@@ -395,6 +411,38 @@ Tek uçta "başlık + N alt kayıt" yazmanın yolu budur (anket + sorular + seç
 > **Gateway table step'lerinde `path`/`sort`/`limit` eksiklerini otomatik dolduruyor**
 > (yanıtta `gatewayNormalized`). Dolu değerlere dokunmaz; yanlış path yine WF/MS block'una takılır.
 
+## Table update adımı: yazılan alan kümesi ADIMDAN gelir
+
+`operation: 'update'` (aynısı `create`/`upsert`) adımında SET listesi `rule.fields[]`'tir.
+`PrepareParameters` listedeki **her** alanın ifadesini değerlendirir (`TableStep.cs:508-530`),
+`undefined` dönen sonucu `Parse` `null`a çevirir (`CommonFieldType.cs:59`) ve satır sözlüğü
+süzgeçsiz kurulur (`TableStep.ByUpdateAsync`, `:254-262`). İki sonucu vardır:
+
+- Gövdede o anahtar yoksa `input.x` **`undefined`**'dır ve kolona **NULL yazılır** — eski değer
+  silinir, yanıt yine 200'dür.
+- Adımda listelenmeyen alan hiçbir gövdeyle **değiştirilemez**.
+
+Ölçüm (2026-09-15): `fields: [title, owner, status]` olan bir update adımına `{ id, status }`
+gövdesi gitti; uç 200 döndü, `status` değişti, `title` ve `owner` **NULL** oldu. Microservice
+`update` ucuyla birebir aynı davranış; tam tablo ve kısmi güncellemenin üç doğru yolu
+`platform_guide('microservice')` §"Güncelleme sözleşmesi"nde.
+
+Gateway bunun tanımdan görülebilen hâlini **WF-031 (warn)** ile keser: yazma adımı akışın giriş
+DTO'sunda OLMAYAN bir `input.x` alanını bağlıyorsa o ifade kesinlikle `undefined` döner ve kural
+eksik alanları adıyla sayar. Uyarıyı susturmanın doğru yolu adımı **eylem başına daraltmaktır**
+(`fields[]` yalnız o eylemin yazdığı alanlar); alanı DTO'ya eklemek yalnız izin verir, çağıranın
+her istekte göndereceğini garanti etmez.
+
+Akışta kısmi güncelleme gerekiyorsa **oku-birleştir**: önce `table get`, sonra `table update`,
+gelmeyen alan okunan değere düşsün —
+
+```js
+typeof input.title !== 'undefined' && input.title !== null ? input.title : read_row.data.title
+```
+
+(ölçüldü: `{ id, status }` gövdesiyle `title`/`owner` korundu). Bedeli fazladan bir okuma turu ve
+**son yazan kazanır**; eylem başına ayrı uç kurmak hâlâ daha ucuz ve daha güvenlidir.
+
 ## Response step'i gövdeyi `bodyExpression`'dan üretir
 
 `rule: { dataTransferObjectId }` **hiçbir şey döndürmez** (`result: null`). Çalışan şekil:
@@ -615,7 +663,8 @@ Kaydedilen sözleşme üç tüketim yolunda da aynı şekilde bağlanır:
 |---|---|
 | `queryStepSourceType: 'library'` (workflow query adımı) | Adımın ifadeleri: `rule.expression` (nesne literali) ya da `rule.queryParameters[]` — ikisi de **JavaScript ifadesidir**; istek girdisini (`input.year`), önceki adım çıktısını **ve bağlı middleware'in `user.*` değişkenini** okur |
 | Query kaynaklı microservice (`source: 'query'`) | Yalnız çağrının kendisi: **body → query-string → header** (`MicroserviceExecuteParameter.FindValue`); ifade YOKTUR, `user.*` bu yola girmez |
-| `query_preview` | `parameters` alanı — davranış yukarıdaki ikisiyle aynıdır |
+| `query_preview` | Komutun `definition.parameters[].value` alanı; tool'un üst düzey `parameters` argümanı (ad → değer) gateway'de oraya bağlanır. Değer almayan parametre yanıtta `unboundParameters` ile listelenir |
+| `microservice_execute` / `microservice_debug` | Üst düzey `parameters` (ad → değer): gateway GET/DELETE'te query-string'e, POST/PUT'ta gövdeye koyar — yukarıdaki query kaynaklı uç satırının okuduğu yer. `microservice_debug` NULL bağlanan parametreyi `unboundParameters` ile adıyla verir |
 
 > **Boş string parametre `NULL`'a çevrilir.** `Query.NormalizePreviewParameters` değeri normalize
 > ederken boş ya da yalnız boşluktan oluşan değeri `null` yapar. `WHERE status = {{durum}}` yazıp

package/dist/resources/schema-fingerprint.json

@@ -1,6 +1,6 @@
 {
-  "hash": "7702a2d5d690f0d9b1aeab42e9253096f68dfaca040952b07d6c2911f1a37a7f",
-  "generatedAt": "2026-09-14T09:08:38.743Z",
+  "hash": "cafe3a6b082c7828cece4eaa1c0115ba28581f157eac3288abcf068c7f6f8533",
+  "generatedAt": "2026-09-15T10:24:42.398Z",
   "types": 185,
   "files": 107,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",

package/dist/resources/schemas/CreateMicroserviceCommand.json

@@ -322,7 +322,10 @@
           "get",
           "delete",
           "upsert",
-          "count"
+          "count",
+          "bulk-create",
+          "bulk-update",
+          "bulk-delete"
         ],
         "type": "string",
         "format": ""

package/dist/resources/schemas/CreateWorkflowCommand.json

@@ -805,7 +805,10 @@
           "get",
           "delete",
           "upsert",
-          "count"
+          "count",
+          "bulk-create",
+          "bulk-update",
+          "bulk-delete"
         ],
         "type": "string",
         "format": ""

package/dist/resources/schemas/PreviewMicroserviceCommand.json

@@ -341,7 +341,10 @@
           "get",
           "delete",
           "upsert",
-          "count"
+          "count",
+          "bulk-create",
+          "bulk-update",
+          "bulk-delete"
         ],
         "type": "string",
         "format": ""

package/dist/resources/schemas/PreviewWorkflowCommand.json

@@ -650,7 +650,10 @@
           "get",
           "delete",
           "upsert",
-          "count"
+          "count",
+          "bulk-create",
+          "bulk-update",
+          "bulk-delete"
         ],
         "type": "string",
         "format": ""

package/dist/resources/schemas/StepDto.json

@@ -555,7 +555,10 @@
           "get",
           "delete",
           "upsert",
-          "count"
+          "count",
+          "bulk-create",
+          "bulk-update",
+          "bulk-delete"
         ],
         "type": "string",
         "format": ""

package/dist/resources/schemas/UpdateMicroserviceCommand.json

@@ -307,7 +307,10 @@
           "get",
           "delete",
           "upsert",
-          "count"
+          "count",
+          "bulk-create",
+          "bulk-update",
+          "bulk-delete"
         ],
         "type": "string",
         "format": ""

package/dist/resources/schemas/UpdateWorkflowCommand.json

@@ -805,7 +805,10 @@
           "get",
           "delete",
           "upsert",
-          "count"
+          "count",
+          "bulk-create",
+          "bulk-update",
+          "bulk-delete"
         ],
         "type": "string",
         "format": ""

package/dist/server.js

@@ -19,6 +19,7 @@ import { registerKnowledgeResources } from './resources/knowledge.js';
 import { registerSchemaResources } from './resources/schemas.js';
 import { registerRuleResources } from './resources/rules.js';
 import { instrumentServer } from './observability/trace.js';
+import { rejectUnknownArguments } from './platform/strictArguments.js';
 import { registerProjectTools } from './tools/projects.js';
 import { registerEntityTools } from './tools/entities.js';
 import { registerDependencyTools } from './tools/dependencies.js';
@@ -72,7 +73,7 @@ const moduleRegistrations = {
     revision: registerRevisionTools
 };
 export function createGatewayServer(platform) {
-    const server = instrumentServer(new McpServer({ name: 'ngapps', version: '0.1.0' }), platform.config);
+    const server = rejectUnknownArguments(instrumentServer(new McpServer({ name: 'ngapps', version: '0.1.0' }), platform.config));
     for (const moduleName of platform.config.modules) {
         moduleRegistrations[moduleName](server, platform);
     }

package/dist/tools/flows.js

@@ -1,7 +1,7 @@
 import { fetchHost, flowPath, hostParam, hostUpdateBody, unwrap } from './screens.js';
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive, microOps } from './common.js';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
-import { normalizeFlowSteps, unknownSetterTargetWarnings, withNormalization } from '../knowledge/normalize.js';
+import { normalizeFlowSteps, targetlessSetterWarnings, unknownSetterTargetWarnings, withNormalization } from '../knowledge/normalize.js';
 import { flowBodyWarnings } from '../knowledge/coverage.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
@@ -243,10 +243,16 @@ export function registerFlowTools(server, platform) {
     }));
     server.registerTool('flow_get', {
         title: 'Akış getir',
-        description: 'Tek akışı adımlarıyla getirir; yeni akış yazarken en iyi şablon budur.',
+        description: "Tek akışı adımlarıyla getirir; yeni akış yazarken en iyi şablon budur. Hedefi silinmiş (element'siz) setter iteratee'si varsa yanıttaki flowWarnings söyler — o adım koşar ama hiçbir şeye yazmaz.",
         inputSchema: { project: projectParam, environment: environmentParam, host: hostParam, applicationId: guid, hostId: guid, flowId: flowIdParam },
         annotations: readOnly
-    }, handle(config, ({ project, environment, host, applicationId, hostId, flowId }) => platform.tenant('GET', project, flowPath(host, applicationId, hostId, flowId), { environment })));
+    }, handle(config, async ({ project, environment, host, applicationId, hostId, flowId }) => {
+        const response = await platform.tenant('GET', project, flowPath(host, applicationId, hostId, flowId), { environment });
+        const warnings = targetlessSetterWarnings(response);
+        if (warnings.length === 0 || !response || typeof response !== 'object' || Array.isArray(response))
+            return response;
+        return { ...response, flowWarnings: warnings };
+    }));
     server.registerTool('flow_create', {
         title: 'Akış oluştur',
         description: "Sayfa/layout/komponent için olay akışı oluşturur. Platform bu uçta barındırıcının TAM gövdesini de ister (akış ile şemadaki olay bağı tek işlemde tutarlı kalsın diye); gateway barındırıcıyı okuyup gövdeye kendisi koyar. Akışı bir komponent olayına bağlamak ayrı adımdır: page_schema_patch ile set_event {target, event, eventValue: <flow id>}.",

package/dist/tools/layouts.js

@@ -2,7 +2,7 @@ import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, u
 import { resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import fastJsonPatch from 'fast-json-patch';
-import { normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
+import { normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
 import { fetchHost, layoutUpdateBody, schemaParam, eventsParam, modeParam, summarize, findNode } from './screens.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
 import { applyPropTypesToSchema, isSetPropTypeOp, setPropTypeErrors } from '../knowledge/propTypes.js';
@@ -93,7 +93,7 @@ export function registerLayoutTools(server, platform) {
         assertScreenWriteGuards('layout', { schema: views, events });
         const fixed = normalizeComponentDefaults(views);
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, views);
-        const gaps = [...verticalGapWarnings(views ?? [], 'LAY-003 (uyarı)'), ...flexSizeWarnings(views ?? [], 'LAY-007 (uyarı)', 'LAY-008 (uyarı)')];
+        const gaps = [...verticalGapWarnings(views ?? [], 'LAY-003 (uyarı)'), ...flexSizeWarnings(views ?? [], 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'), ...spacingLayerWarnings(views ?? [], 'LAY-010 (uyarı)', 'LAY-011 (uyarı)')];
         const response = await platform.tenant('POST', project, `/layouts/${applicationId}`, {
             environment,
             body: { name, views: views ?? [], events: events ?? [], parameters: parameters ?? null }
@@ -126,7 +126,7 @@ export function registerLayoutTools(server, platform) {
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, overrides.views);
         const body = layoutUpdateBody({ ...current, applicationId }, overrides);
         await platform.tenant('PUT', project, `/layouts/${applicationId}/${id}`, { environment, body });
-        const gaps = overrides.views === undefined ? [] : [...verticalGapWarnings(body.views, 'LAY-003 (uyarı)'), ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)')];
+        const gaps = overrides.views === undefined ? [] : [...verticalGapWarnings(body.views, 'LAY-003 (uyarı)'), ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'), ...spacingLayerWarnings(body.views, 'LAY-010 (uyarı)', 'LAY-011 (uyarı)')];
         const summary = { id, changed: Object.keys(overrides), preserved: { viewNodes: body.views.length } };
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
@@ -193,7 +193,7 @@ export function registerLayoutTools(server, platform) {
             body: { baseVersion: baseVersionOf(document, 'layout_get'), ops: netOps }
         });
         const written = patchResult(saved, finalDocument);
-        const gaps = [...verticalGapWarnings(body.views, 'LAY-003 (uyarı)'), ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)')];
+        const gaps = [...verticalGapWarnings(body.views, 'LAY-003 (uyarı)'), ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'), ...spacingLayerWarnings(body.views, 'LAY-010 (uyarı)', 'LAY-011 (uyarı)')];
         const summary = {
             id,
             applied: patchOps.length,