@appaflytech/zeyrek-ai-mcp 0.0.43 → 0.0.45

package/dist/resources/examples/flow-biometric-confirm.json

@@ -0,0 +1,199 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Ödeme gibi bir eylemden önce kullanıcıyı Face ID / parmak izi ile doğrulayan düğme akışı (kök docs/adr/0021-biyometrik-dogrulama-adimi-ve-uygulama-kilidi.md): başarı always dalında işi yapar, vazgeçme ve doğrulanamama error dalında kullanıcıya söylenir. 'Bu cihazda biyometri yok' metni Device.biometric.available'a bağlıdır.",
+    "harvestedFrom": "canlı doğrulama 2026-10-15: lokal test projesi mobile-app, /dev önizlemesinde 'Doğrulandı say' → Doğrulandı: {\"verified\":true}, vazgeç → Hata: cancelled; aynı akış page_screenshot ile (click → awaiting-user → preview-biometric__verify) sürüldü"
+  },
+  "_rules": {
+    "args": "args.title sistem penceresindeki gerekçe, args.cancelText vazgeç düğmesi (metin şablonu; boşsa uygulama dilindeki varsayılan). args.value yedek, DÜZ METİN: 'device' (biyometri olmazsa cihaz parolası; boş = bu) ya da 'none'. Küme dışı 422; fallback/reason/cancelLabel anahtarı sessizce düşer — FLOW-042.",
+    "branches": "Dallar 'always' ve 'error'. Vazgeçme bir HATADIR: error dalı → akışın hata adımları → ikisi de yoksa akış bu adımda BİTER ve always'e bağlı iş koşmaz (FLOW-042 uyarır).",
+    "output": "Başarı Steps.<adım ADI>.data = { verified: true }; hata Steps.<ad>.error.status: cancelled · not-enrolled · lockout · failed · unavailable · unsupported · invalid.",
+    "where": "Studio önizlemesi, canlı kip, /dev ve /branch sormaz: 'Doğrulandı say' / vazgeç penceresi açar. Production /view ve web uygulaması unsupported döner. Oynatıcıda (Expo Go) yedeği none olan adım hep unavailable.",
+    "security": "Yerel bir kapıdır, sunucu için kanıt değildir: sunucu tarafı yetkiyi ayrıca denetleyin.",
+    "binding": "Akışı olaya bağlamak ayrı adımdır: page_schema_patch set_event { target: 'btn_ode', event: 'click', eventValue: '<flow id>' }."
+  },
+  "pageOps": [
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "tx_biyometri_yok",
+        "name": "tx_biyometri_yok",
+        "type": "text",
+        "props": {
+          "content": "Bu cihazda biyometri ya da cihaz parolası kurulu değil",
+          "isHidden": {
+            "type": "code",
+            "ref": "{{ Device.biometric.available }}"
+          }
+        },
+        "blocks": [
+          {
+            "breakpoint": 1024,
+            "size": {
+              "w": 12,
+              "h": 1
+            },
+            "position": {
+              "x": 0,
+              "y": 1
+            }
+          }
+        ]
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "btn_ode",
+        "name": "btn_ode",
+        "type": "button",
+        "props": {
+          "text": "Ödemeyi onayla"
+        },
+        "blocks": [
+          {
+            "breakpoint": 1024,
+            "size": {
+              "w": 12,
+              "h": 1
+            },
+            "position": {
+              "x": 0,
+              "y": 2
+            }
+          }
+        ]
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "tx_sonuc",
+        "name": "tx_sonuc",
+        "type": "text",
+        "props": {
+          "content": ""
+        },
+        "blocks": [
+          {
+            "breakpoint": 1024,
+            "size": {
+              "w": 12,
+              "h": 1
+            },
+            "position": {
+              "x": 0,
+              "y": 3
+            }
+          }
+        ]
+      }
+    }
+  ],
+  "flowCreateArgs": {
+    "host": "page",
+    "hostId": "<page id>",
+    "name": "btn_ode - click",
+    "slug": "btn-ode-click",
+    "steps": [
+      {
+        "stepId": "start",
+        "name": "start",
+        "type": "start",
+        "kind": "normal",
+        "args": {},
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": "dogrula"
+          }
+        ]
+      },
+      {
+        "stepId": "dogrula",
+        "name": "dogrula",
+        "type": "biometric-auth",
+        "kind": "normal",
+        "args": {
+          "title": "Ödemeyi onaylayın",
+          "cancelText": "Vazgeç",
+          "value": "device"
+        },
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": "onaylandi"
+          },
+          {
+            "name": "error",
+            "nextStepId": "olmadi"
+          }
+        ]
+      },
+      {
+        "stepId": "onaylandi",
+        "name": "onaylandi",
+        "type": "setter",
+        "kind": "normal",
+        "args": {
+          "iteratees": [
+            {
+              "element": "tx_sonuc",
+              "property": "content",
+              "source": "component",
+              "mapping": {
+                "source": "",
+                "mappings": {}
+              },
+              "type": "change",
+              "value": {
+                "type": "code",
+                "ref": "'Onaylandı'"
+              }
+            }
+          ]
+        },
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": null
+          }
+        ]
+      },
+      {
+        "stepId": "olmadi",
+        "name": "olmadi",
+        "type": "setter",
+        "kind": "normal",
+        "args": {
+          "iteratees": [
+            {
+              "element": "tx_sonuc",
+              "property": "content",
+              "source": "component",
+              "mapping": {
+                "source": "",
+                "mappings": {}
+              },
+              "type": "change",
+              "value": {
+                "type": "code",
+                "ref": "Steps.dogrula.error.status === 'cancelled' ? 'Vazgeçildi' : 'Doğrulanamadı: ' + Steps.dogrula.error.status"
+              }
+            }
+          ]
+        },
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": null
+          }
+        ]
+      }
+    ],
+    "errorSteps": []
+  }
+}

package/dist/resources/examples/microfunction-node-dependencies.json

@@ -0,0 +1,19 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "microfunction-faz-2/development ortamında gerçek uçta doğrulandı (2026-09-29): publish:true ile kayıt 'publishing' döndü, Fission builder dayjs ve ms paketlerini kurdu (build günlüğü 'added 2 packages'), ~4-6 sn sonra 'published' oldu; microfunction_invoke {} → ok:true output {year:2026, twoDays:172800000}. Kurallar: dependencies SATIR BAŞINA BİR PAKET, node'da 'ad@aralık' (aralıksız satır latest olur); inline kaynakta entrypoint GÖNDERİLMEZ; paketler yalnız Built-In'de kurulur (aws-lambda'da MF-007 uyarısı); kurulum düşerse publish-failed ve publishError build günlüğünün son 4 KB'ını taşır."
+  },
+  "microfunction": {
+    "name": "tarih-araci",
+    "description": "dayjs ve ms paketleriyle yılı ve iki günün milisaniye karşılığını döner.",
+    "language": "node",
+    "provider": "built-in",
+    "sourceKind": "inline",
+    "code": "const dayjs = require('dayjs')\nconst ms = require('ms')\nexports.handler = async () => ({ year: dayjs('2026-09-29').year(), twoDays: ms('2d') })\n",
+    "dependencies": "dayjs@^1.11\nms@^2.1",
+    "timeoutSeconds": 30,
+    "memoryMb": 256,
+    "environmentVariables": {},
+    "publish": true
+  }
+}

package/dist/resources/guides/access.md

@@ -691,9 +691,9 @@ Ağacın bugünkü kuralları — hepsi 2026-09-20'de ölçüldü (S2-17 · S2-1
 ## Toplu işlem
 
 Kapsam ve koşul her satırda ayrı ayrı uygulanır; dolayısıyla "hepsini birden onayla" bir POLİTİKA
-sorusu değil bir UÇ sorusudur ve table-source `update` bunu **filtreyle yapamaz** — tam olarak bir
-tekil alan filtresi ister (`InvalidFilterCountException` · `FilterFieldMustUniqueException`,
-ölçüldü 2026-09-20, S2-22). Doğru kurulum: anahtarlar elindeyse `bulk-update` ucu (tek çağrı, tek
+sorusu değil bir UÇ sorusudur ve table-source `update` bunu **filtreyle yapamaz** — hedefi her
+zaman tek satırdır: tek kök filtre, benzersiz alan + `eq`, ek koşullar yalnız AND grubunda
+(MS-019; `platform_guide('microservice')` §"Güncelle/sil filtresi"). Doğru kurulum: anahtarlar elindeyse `bulk-update` ucu (tek çağrı, tek
 transaction), satır başına sonuç ve satır başına yetki kararı gerekiyorsa **iş akışı + döngü**
 (liste → her satır için `microservice` adımı → özet). Akış içinden yazmak yetki YÜKSELTMEZ: her
 satır çağıranın kimliğiyle denetlenir ve reddedilen satır ötekileri geri almaz. Reçete:

package/dist/resources/guides/component.md

@@ -51,8 +51,21 @@ Komponentlerin KENDİ arayüz metni (tablo sayfalaması, filtre operatörleri, b
 düğmeleri) ve sayı/tarih biçimleri uygulamanın aktif dilinden gelir — prop vermene gerek yok.
 İki ayrı kural işliyor ve karıştırılmamalı:
 
-- **Metin İngilizceye düşer.** Kütüphanenin sözlüğü tr/en taşır; projede `de` seçiliyse o metinler
-  İngilizce çıkar. Yeni dil eklemek sözlüğe satır eklemektir, komponent değişikliği değil.
+- **Metin önce uygulama sözlüğünden gelir; Metin İngilizceye düşer** (bileşen kelimeleri, frontend ADR 0023 / 0024;
+  2026-10-15).
+  Kelime listesi olan bileşen (tablo, sürüm karşılaştırma, qm'in kullandığı form ve gösterim bileşenleri) her kelimesini
+  önce uygulama sözlüğünde arar: kendi kelimesi `compProp.<bileşen>.<kelime>`, birçok bileşende geçen kelime ("Yükleniyor…",
+  "Kapat", "Ara") tek satır `compProp.common.<kelime>`. Satır yoksa kütüphanenin tr/en/ar tohumu, o da yoksa İngilizce.
+  Yeni dil eklemek sözlüğe satır eklemektir. Ayrıntı ve yazım yolları: `platform_guide('translation')` §Bileşenin kendi
+  kelimeleri.
+- **`texts` ayarı:** kelimesi olan web bileşeninin gizli `texts` ayarı yalnız o düğümde değiştirilen kelimeleri taşır
+  (`{ rowsPerPage: { type: 'translation', ref: 'page.x.y' } }` ya da düz metin). Bütün bileşenlerin kelimesini değiştirmek
+  için `texts`'e değil sözlüğe yaz. Mobil bileşenlerde `texts` yoktur.
+- **Kelime gibi çalışan ayar boş bırakılır.** Açılır kutu ve çoklu seçim `placeholder`'ı, etiket kutusu `placeholder` /
+  `createNewLabel`'ı, ağaç görünümü `searchPlaceholder` / `emptyText` / `actionsTitle`'ı, tarih-saat `placeholder` /
+  `timePlaceholder`'ı, tarih-saat aralığının saat yer tutucuları, seçicinin `trueLabel` / `falseLabel`'ı boşken ortak kelimeyi
+  gösterir ("Bir seçenek seçin", "Ara", "Açık / Kapalı" …). Web kataloğunda bunların varsayılanı yoktur; yalnız sayfaya özel
+  metin yaz. Ayarı hiç yazmamak kelimeyi gösterir; bilerek boş metin (`''`) yazmak yer tutucuyu / etiketi kaldırır.
 - **Biçim düşmez.** Sayı ayraçları ve tarih adları seçilen dilin kendi kuralını kullanır
   (`de` → `1.234,5`). Dili olmayan bir biçim yoktur; dil verilmediğinde taban İngilizcedir.
 
@@ -60,7 +73,9 @@ Bazı komponentlerin `locale` prop'u geriye uyum için durur ve **doluysa kazan
 sabitleme içindir. Boş bırakmak doğru varsayılandır.
 
 Doğrulama mesajını çeviriye bağlamak ayrı bir sözleşmedir (`t:` öneki, `platform_guide('page')`
-§validasyon); prop'ları bağlamak için `set_prop_type` (`platform_guide('translation')`).
+§validasyon); prop'ları bağlamak için `set_prop_type` (`platform_guide('translation')`). **Kuralın mesajı boşsa** ekran
+kuralın varsayılan kelimesini gösterir (`compProp.common.validationRequired`, `…MinLength` "En az {value} karakter girin" …;
+sayı kuralın `value`'sundan) — varsayılan mesaj için kurala İngilizce cümle yazma, `message`'ı boş bırak.
 
 ## Olay modeli
 
@@ -93,7 +108,8 @@ arayüzdür**, yetkiyi backend her istekte yeniden denetler.
   "Göster" yalnız erişim özeti yüklüyken çıkar: `off`'ta (basit proje hep `off`) hiç çıkmaz —
   backend her reveal'i reddeder; `shadow`'da çıkar — backend reveal'i yine denetler, yetkisiz
   kullanıcı ret mesajını görür; `enforce`'ta yalnız entity'nin `actions`'ında `reveal` varsa.
-  Değeri boş maskeli hücrede "Göster" çıkmaz. Tasarımcı kanvasında (**View as user**) düğme seçilen
+  Değeri boş maskeli hücrede "Göster" çıkmaz. Web tasarımcı kanvasında (**Kullanıcı gözüyle** / View as user; mobil
+  ekran tasarımcısındaki karşılığı **Kim olarak** çipidir; mobil `datatable` `revealEntity`'yi düşürür) düğme seçilen
   kullanıcıya sunulacağı yerde etkisiz çizilir (kullanıcı seçili değilken tasarımcının
   `project.data.reveal` izni karar verir); gerçek açma önizlemededir.
   Açılan değer prop'a, akışa, olaya yazılmaz. Entity `revealEntity` prop'undan (slug ya da id) ya

package/dist/resources/guides/deployment.md

@@ -0,0 +1,98 @@
+# Deployment Rehberi (development → production)
+
+`deployment_start` projeyi `development`'tan `production`'a taşır; production'a giden **tek** yol
+budur ve **insan onaylıdır**. Bu rehber deploy'un neyi taşıdığını, neyi taşımadığını ve production'da
+eksik çıkan satırın ya da dosyanın neden eksik olduğunu anlatır. Dal açma ve merge için
+`platform_guide('merge')`.
+
+## Varsayılan: yalnız tanım taşınır
+
+Deploy bir **tanım** aktarımıdır. Ayar açılmadıkça tablo satırları ve dosyalar production'a gitmez —
+development'ta doldurulan bir tablo production'da boş, development'a yüklenen bir görsel production'da
+404 çıkar. Bu tasarım gereğidir, hata değildir: development verisini production'a kopyalamak bir veri
+kazasıdır, bu yüzden her tablo ve her dosya ayrıca seçilir.
+
+| Ne | Taşınır mı | Kural |
+|---|---|---|
+| Entity, alan, index, sayfa, layout, workflow, DTO, query, microservice, fonksiyon, çeviri, tema | evet | her deploy'da |
+| Süreç tanımı ve iş takvimi | evet | yalnız aktif model; yayınlanmamış taslak taşınmaz (`deployment_start` yanıtı `unpublishedDrafts`) |
+| Microfunction | evet | yalnız YAYINLANMIŞ kod; hedefte yayınlanır (DEP-006) |
+| Tablo satırları | **yalnız tabloda kayıt taşıma açıksa** | §Tablo satırları |
+| Dosyalar | **yalnız id referansıyla** | §Dosyalar |
+| Kullanıcı, rol ataması, süreç örneği, görev, defter | hayır | ortama özgüdür |
+
+Kaynak yalnız `development`'tır (DEP-003); deploy başlamadan production verisi ön denetimden geçer
+(DEP-004). İkisinin ayrıntısı `deployment_start` açıklamasında.
+
+## Tablo satırları (recordTransferMode)
+
+Satırlar **tablo başına** açılan kayıt taşıma ayarıyla gider. Ayar entity tanımındadır:
+
+| `recordTransferMode` | Ne taşınır |
+|---|---|
+| yok (`null`, varsayılan) | hiçbir satır |
+| `'all'` | tablonun bütün satırları |
+| `'specific'` + `transferRowIds: ['<id>', …]` | yalnız seçilen satırlar ve bu satırların FK ile gösterdiği satırlar |
+
+- **Yazmak:** `entity_patch` ile `{op:'replace', path:'/recordTransferMode', value:'all'}` (seçili
+  satırlar için ayrıca `/transferRowIds`), ya da `entity_update` tam gövdesi. `'specific'` iken
+  `transferRowIds` dolu, tekil ve boşsuz olmalıdır (ENT-018).
+- **Studio karşılığı:** Tablo paneli → **"Sistem kayıtlarını dağıtımlar/şablonlar üzerinden aktar"**.
+  Aynı ayar şablon kurulumunda da geçerlidir.
+- **Birlikte giden:** çok dilli tablonun `*_localization` çeviri tablosu ve junction (çoka-çok)
+  satırları ana tabloyla **otomatik** gider; onlara ayrıca ayar açılmaz. Junction satırı yalnız iki
+  tarafı da taşınıyorsa gider (dosya tarafı her zaman geçer).
+- **Kimlikler 1:1 korunur:** satır production'a aynı birincil anahtarla yazılır, identity sayacı
+  taşınan id'lerin ötesine ilerletilir. Production'da aynı id'li satır varsa üzerine yazılır.
+- **`'all'` = ayna (DEP-005, backend ADR 0011):** promote'ta production o tabloda development'ın
+  aynasıdır. Kaynakta olmayan satır, çevirisi ve junction satırı production'da **silinir** —
+  production'a doğrudan girilmiş satırlar dahil. Kaynak tablo boşsa hedef tablo boşalır. Platformun
+  kendi tabloları (`users`, `roles`, `permissions`) taşımaya açılabilir ama aynalanmaz.
+- **`'specific'` silmez:** yalnız upsert yapar. Seçili satırın FK ile gösterdiği satırlar zincirleme
+  gelir (bir satır seçmek birkaçını taşıyabilir); seçilmemiş bir satıra giden çoka-çok bağı düşer.
+- **İlişki sırası:** `'all'` açılan tablonun ilişki hedefinde de taşıma açık olmalıdır, yoksa kayıt
+  `RelationTransferNotEnabledException` ile reddedilir — önce hedef (ebeveyn) tabloyu açın. `'all'`
+  bir tablonun gösterdiği tabloda taşımayı kapatmak da reddedilir. `'specific'` bu denetimden muaftır:
+  seçili satırın ilişki sütunu taşınmayan bir satırı gösterirse hata production'da FK ihlali olarak
+  çıkar.
+
+Kayıt taşıma deploy'un kuralıdır. Dal açarken `includeRecords: true` bu ayara bakmadan bütün veri
+tablolarını kopyalar; merge satır taşımaz (`platform_guide('merge')` §Dalda çalışmak).
+
+## Dosyalar
+
+`files` tablosu ortama aittir ve **toptan taşınmaz**. Bir dosya production'a yalnız iki yoldan biriyle,
+**id'siyle başvurulduğu için** gider:
+
+1. **Dosya tipli prop:** sayfa ya da komponent prop'unda `{ type:'file', ref:'<fileId>' }` —
+   Studio panelinin dosya seçicisinin yazdığı şekil budur. Tasarım bu dosyayı id'siyle tutar.
+2. **Taşınan bir satırın dosya sütunu:** kayıt taşıması açık tabloda tekil dosya alanının ya da dosya
+   çoka-çok alanının taşıdığı dosya id'leri. Satır gitmiyorsa dosyası da gitmez.
+
+Dosya production'a **aynı id'yle** yazılır. Production'da o id zaten varsa yalnız adı güncellenir;
+içerik yeniden yüklenmez ve kaynakta değişen içerik production'a geçmez.
+
+**Sabit URL tuzağı.** Sayfaya metin olarak yazılmış bir dosya adresi (görselin `src`'sine düz URL,
+html içeriği, stil) deploy'da **yeniden yazılır** — development serve öneki `…/files/serve/d/…`
+production'da `…/files/serve/p/…` olur (dal öneki de aynı biçimde çevrilir). Ama bu yalnız metin
+değişimidir: adresin gösterdiği **dosya kopyalanmaz**, production'da adres **404** döner. Görseli
+production'a taşımak için onu dosya tipli prop'a (`ref`) ya da taşınan bir satırın dosya sütununa
+bağlayın.
+
+## Production'a doğrudan yazılmaz
+
+Eksik satır ya da dosya production'da elle tamamlanamaz. Production ortamında `file_upload`,
+`row_create`, `row_update`, `row_delete` ve `import_*` araçları backend'de yazma korumasına
+(`ProductionWriteGuardBehavior`) takılır ve **400 `CantWriteInProductionException`** döner. Yol her
+zaman aynıdır: düzeltmeyi development'ta yapın (ayarı açın, prop'u bağlayın), sonra insan onaylı
+yeni bir deploy.
+
+## Production'da eksik veri teşhisi
+
+| Belirti | Bak | Düzeltme (development'ta) |
+|---|---|---|
+| Tablo production'da boş ya da eksik | `entity_get` → `recordTransferMode` | `'all'` ya da `'specific'` + `transferRowIds`; ilişki hedeflerini önce açın |
+| Çeviriler eksik, satırlar var | ana tablonun ayarı | çeviri tablosu ana tabloyla gider; ana tabloda ayar açık olmalı |
+| Görsel production'da 404 | `page_schema_get` → prop düz URL mi, `{ type:'file', ref }` mi | prop'u `ref` ile bağlayın ya da dosyayı taşınan satırın dosya sütunundan okuyun |
+| Satırın dosyası 404, satır var | satır taşınıyor mu (`recordTransferMode`) | dosya yalnız taşınan satırla gider |
+| Production'da silinmiş satırlar | tablo `'all'` mı | ayna kuralı (DEP-005); production'a girilen veri bu tabloda tutulmaz |

package/dist/resources/guides/entity.md

@@ -624,7 +624,7 @@ karakter, primaryKey yok). Tam katalog, kaynak referanslı JSON: `ngapps://rules
 | `folderId` | yalnız `commonType: 'file'` alanında | ENT-017 |
 | `properties.generationType` | yalnız `commonType` `guid` ya da `number` | ENT-017 |
 | `commonType` / `defaultValueType` / `relationType` | sözlükten; bilinmeyen değer 400 `InvalidEnumTokenException` (`multiFile` diye bir tip YOK) | ENT-017 |
-| `recordTransferMode: 'specific'` | `transferRowIds` dolu, tekil, boşsuz | ENT-018 |
+| `recordTransferMode: 'specific'` | `transferRowIds` dolu, tekil, boşsuz; ayar yoksa deploy satır taşımaz — `platform_guide('deployment')` §Tablo satırları | ENT-018 |
 | `indexes[]` | ad önek hariç en fazla 32, `fieldIds` dolu ve tekil, adlar tekil | ENT-013 |
 
 **Birincil anahtar kalıbı** (bu rehberde yoktu; 2026-09-08 koşusunda iki hatalı çağrı + bir

package/dist/resources/guides/expressions.md

@@ -10,6 +10,10 @@
 
 Uydurma fonksiyon adı runtime'da `X is not defined` 500'üdür — yalnız buradakileri kullan.
 
+**Hiçbir ifade görünen metinle karşılaştırılmaz** (`durum === 'Onaylandı'`, `title !== 'Aksiyonlar'`,
+`/Klasörler/.test(...)`): kod değerine, state'e, değişkene, `Page.queryParams`'a, elementId / sınıfa bağlanır. UI flow
+yazımında gateway yeni kancayı TR-005 ile durdurur — `platform_guide('translation')` §Mantık görünen metne bağlanmaz.
+
 ## 1. Backend ifadeleri — kullanılabilir bağlam
 
 **Değişkenler:** step çıktıları (`<stepAdı>.data`), middleware değişkenleri (`user`,
@@ -107,7 +111,7 @@ dalından devam eder.
 | `setComponentProperty(name, key, value)` / `getComponentProperty(name, key)` | fonksiyon alternatifi |
 | `resetForm(name)` | Formu sıfırlar: alanlar başlangıç değerine döner, form "gönderilmemiş" olur, doğrulama mesajları silinir. Kayıt sonrası "yeni kayıt" için alanları tek tek `null`'a çekme — gönderilmiş formda her biri "zorunlu alan" mesajı çıkarır. Ad ya da komponent değişkeni alır: `resetForm('risk_form')` / `resetForm(risk_form)`. **Yalnız UI flow kodunda** |
 | `LocalStorage` · `Widget` · `params` | yerel veri · widget bağlamı · olay parametreleri. `LocalStorage` barındırıcının deposudur, salt okunur ve değerler METİNdir: web'de uygulamanın kökenindeki `localStorage` (Studio önizlemesinde Studio'nun kendi anahtarları da görünür), cihazda akışın `storage` deposu. `storage` adımı düz bir anahtara yazınca `LocalStorage.<anahtar>` aynı akışta yeni değeri verir ve sayfanın bağları yeniden değerlendirilir (`isSelected: {{ LocalStorage['zeyrek:theme-mode'] === 'dark' }}`). `state.page\|app.<key>`'e yazan adım `LocalStorage`'a girmez (ARC-147, 2026-09-29) |
-| `Device` | Salt okunur cihaz durumu, barındırıcı günceller: `Device.isOnline` — ağ bağlantısı var mı (bilinmiyorsa `true`). Değişince sayfanın bütün bağları yeniden değerlendirilir; çevrimdışı bandı: `isHidden: {{ Device.isOnline }}`. Cihazda `expo-network`, web'de tarayıcının `online`/`offline` olayları. `Device` adında komponent ifade bağlamından süzülür (ayrılmış ad) |
+| `Device` | Salt okunur cihaz durumu, barındırıcı günceller: `Device.isOnline` — ağ bağlantısı var mı (bilinmiyorsa `true`). Değişince sayfanın bütün bağları yeniden değerlendirilir; çevrimdışı bandı: `isHidden: {{ Device.isOnline }}`. Cihazda `expo-network`, web'de tarayıcının `online`/`offline` olayları. `Device.biometric = { available, enrolled, kinds }` (kök ADR 0021): `available` cihaz kullanıcıyı şu an doğrulayabilir (biyometri **ya da** cihaz parolası kurulu), `enrolled` biyometri kayıtlı, `kinds` ⊆ `face · fingerprint · iris`; barındırıcı vermezse (web, derleme taşımıyor) `{ available: false, enrolled: false, kinds: [] }`, Studio önizlemesi ve kanvas senaryosu `{ true, true, ['face'] }`. Uygulama ön plana dönünce yeniden okunur. `Device` adında komponent ifade bağlamından süzülür (ayrılmış ad) |
 | **Ayrılmış adlar** | Bu tablodaki globallerle (ve önsözün iç adlarıyla: `payload`, `error`, `repeaterId`, `_` ile başlayanlar…) aynı `name`'i taşıyan komponent (runtime yalnız İLK `-`'yi siler: `ite-m` da `item` sayılır) ifadede kendi adıyla GÖRÜNMEZ — süzülür, uyarı loglanır (liste: `@ng-apps/flow` `EXPRESSION_PRELUDE_NAMES`). Eskiden aynı ad sayfanın BÜTÜN ifadelerini `SyntaxError`'la düşürürdü (ARC-143). Gateway artık bu adların HEPSİNİ **PAGE-009** ile sayfa/layout yazma yollarında ve `page_schema_validate`'te istek gitmeden reddeder — komponente `t`, `state`, `event`, `item`, `self`, `Page`, `Row` gibi ad verme |
 | `t(key)` | Çeviri anahtarını çözer: aktif dil → projenin varsayılan dili → anahtarın kendisi. Boş string de "eksik" sayılır. Sözlük `machine.context.state.translations`'tan gelir; dil `language-selector` ile değişince bir sonraki çağrı yeni dili görür. **Yalnız UI flow kodunda vardır** — backend ifadelerinde karşılığı `Loc()`'tur (`platform_guide('workflow')`) | `t('home.welcome')` |
 | `log(...)` | console (proxy'leri temizler) |

package/dist/resources/guides/external-component.md

@@ -109,10 +109,12 @@ platform yeniden başlamaz, açık oturumlar bozulmaz.
 
 ## Editor modu
 
-`zxContext.editorMode` true olduğunda element Studio kanvasında statik bir
-önizleme olarak duruyor: zamanlayıcı kurmayın, ağ çağrısı yapmayın, tıklamayı
-işlemeyin. Kanvasta etkileşim host tarafından zaten engellenir, ama gereksiz iş
-yapmamak kanvası hızlı tutar.
+`zxContext.editorMode` yalnız web sayfa tasarımcısının kanvasında true'dur;
+önizlemede ve runtime'da false. True iken element statik bir önizleme olarak
+duruyor: zamanlayıcı kurmayın, ağ çağrısı yapmayın, tıklamayı işlemeyin.
+Kanvasta etkileşim host tarafından zaten engellenir, ama gereksiz iş yapmamak
+kanvası hızlı tutar. Mobil uygulamada dış bileşen çizilmez; mobil ekran
+tasarımcısının Düzenle / Dene kipi bu bayrağı taşımaz.
 
 ## Geliştirici kiti
 

package/dist/resources/guides/merge.md

@@ -10,6 +10,10 @@ onaylıdır**. Buradaki tool'ların hiçbiri production'a yazmaz.
 - **Production'a merge eden tool yoktur.** Production'a giden tek yol insan onaylı deployment'tır.
 - Sabit environment'lar (`development`, `production`) silinemez; `environment_delete` bunu HTTP'ye
   gitmeden reddeder.
+- **Şablondan kurulup güncellemeleri alan projede dal açılamaz, var olan dal değiştirilemez** (`project_get` →
+  `templateMetadata.installedTemplateReceiveUpdates: true`): dal açma/silme ve merge planının her adımı
+  400 döner (MRG-018). Değişiklik şablonun kaynak projesinde yapılır, `template_create` ile yayımlanır,
+  abone projede `template_check_updates` → `template_receive_updates` ile alınır.
 
 ## Akış
 
@@ -36,9 +40,9 @@ yazmaya çalışmak 400 döner — `environment_list` ile durumu doğrula.
 Dal açılırken **yalnız tanımlar** kopyalanır. `includeRecords: true` verirsen projenin kendi
 veritabanındaki **bütün** veri tablolarının satırları da gelir — entity'de kayıt taşıması ayarı
 açık olmasa bile (çok dilli companion tablolar ve junction'lar dahil; `files`/`folders` ve audit
-trail tabloları hariç, dış datasource'lara dokunulmaz). Kayıt taşıması ayarı deployment'ın
-(`promote`) kuralıdır ve orada aynen geçerlidir. **Satırlar merge'de geri taşınmaz** — merge yalnız
-tanım işidir.
+trail tabloları hariç, dış datasource'lara dokunulmaz). Merge'de geri gelen satırlar yalnız **kayıt
+taşıması ayarı açık** tablolarınkidir; promote (`platform_guide('deployment')`) ve şablonla aynı
+ayar, ama kural üç yollu: aşağıda "Tablo kayıtları".
 
 Tanım sayılan ve merge'in taşıdığı üç şey 2026-09-25'ten beri listede: **çeviriler**
 (translation kalemi, adı çeviri anahtarı), **microfunction'lar** (kod ve arşiv; hedefte **taslak**
@@ -169,6 +173,16 @@ runtime'ın çizdiği satırlar `….children`. **Kararı `ref`'e verin**; `chil
 seçimi aynen geçer; `both` ve `custom` satırlara listeden yeniden kurulur. `children`'a ayrı ve farklı karar vermek
 ekranda listenin değil satırların çizilmesine yol açar.
 
+**Widget prop'unda da yollar aynıdır** (2026-10-15'ten beri). Widget prop'larını düz satırda tutar ama merge onları
+sayfa gibi ağaç olarak karşılaştırır: dizi prop'unun satırları `widgetComponentProps[id=<prop>].children` yolunda gelir,
+kararı `widgetComponentProps[id=<prop>].ref`'e verin. Öncesinde satırlar ayrı ayrı `add` geliyordu. İki taraf aynı
+widget'ı kaydedince satırlar çoğalıyor, `ref` kararı satırlara geçmiyordu (MRG-017). O tarihten önce açılmış plan
+eski yollarla da doğru uygulanır; ağaç görünümü için `merge_refresh` yeter.
+
+**Sınır (sayfa ve widget):** iki taraf listenin öğe sayısını değiştirmeden aynı öğeyi farklı değiştirdiyse liste
+konumsal karşılaştırılır. `ref`'in alt yollarında (`….ref[1].label.data`) ve satırlarda (`….children[2].ref`) ayrı
+çakışmalar gelir; `ref` kararı satırlara geçmez. Hepsine **aynı tarafı** seçin, yoksa liste ile satırlar ayrışır (P-19).
+
 **Nesne prop'unda** (butonun `icon`'u, `surfaceStyle`) aynı kural anahtar düzeyindedir: anahtarın değeri
 `….ref.<anahtar>…`, runtime'ın çizdiği satırı `….children[name=<anahtar>]…`. İki taraf aynı anahtara farklı yazdıysa
 ikisi de çakışma gelir; **kararı `ref.<anahtar>`'a verin**. Satır karar istemez ve `summary.unresolved`'a girmez:
@@ -220,7 +234,7 @@ yine ayrı eklenir.
 |---|---|---|
 | `unresolved` | error | çözülmemiş çakışma ya da `slug` taşıyan çözümsüz kopya; apply 409 döner. Dizi prop'unun `children`'ı `ref` açıkken, nesne prop'unun satırı (`children[name=…]`) değeri çakışırken, türetilmiş DTO elemanı kaynağı açıkken ayrı satır almaz ve `summary.unresolved`'a girmez: kaynağı çözünce kendiliğinden çözülür |
 | `duplicate-open` | warning | çözümsüz kopya (`combinable: true`), ikisi de yazılacak |
-| `name-clash` | warning | birleşik gövdede aynı adla iki kardeş (örneğin iki `telefon` sütunu) |
+| `name-clash` | warning | birleşik gövdede aynı adla iki kardeş (örneğin iki `telefon` sütunu). Widget prop'unda kardeş, aynı öğenin aynı üst prop ve satırdaki prop'udur; iki ayrı öğenin aynı adlı prop'u uyarı vermez |
 | `dangling-reference` | warning | merge'ün sildiği ya da kopya kararında düşen bir kimliğe hâlâ başvuru var |
 
 Uyarılar apply'ı engellemez; ama okunmadan `merge_apply` çağrılmaz.
@@ -229,6 +243,51 @@ Uyarılar apply'ı engellemez; ama okunmadan `merge_apply` çağrılmaz.
 yoktur; kalan çakışmalar için `merge_get {planId, view:"conflicts"}` çağırın.
 `summary.unresolved` 0 olduğunda `merge_apply` yolu açıktır.
 
+## Tablo kayıtları
+
+2026-10-17'den beri merge, **kayıt taşıması ayarı açık** tabloların satırlarını da taşır ("Transfer system records
+through deployments/templates"; `specific`'te yalnız seçili satırlar). Ayarın kapsamı toplayıcınındır: tablonun
+çeviri tablosu ve iki ucu ayarlı bağlantı tablosu da gelir. Kullanıcılar ve kullanıcı ↔ grup üyelikleri hiçbir ayarla
+taşınmaz; roller için aşağıdaki **Roller** maddesi.
+
+- **Kalem tablodur:** `module: "row"`, `recordId` = entity kimliği, `name` = tablo adı. Satır farkı `rows.<anahtar>`,
+  hücre farkı `rows.<anahtar>.<sütun>` yolundadır; etiket anahtar + satırın okunur alanıdır (`571 · dm-documents-compare`).
+- **Yalnız dalın değişiklikleri kalem üretir.** Taban dal açılışındaki satırlardır. Development'ın kendi eklediği ya da
+  değiştirdiği satır plana girmez ve apply ona dokunmaz. Denetim sütunları (`sys_created_at`, `sys_updated_at`,
+  `sys_created_user_id`, `sys_updated_user_id`) sayılmaz.
+- **Silme** yalnız dalda `all` olan tabloda çıkar: dalın sildiği, development'ın dokunmadığı satır `delete` gelir.
+  `specific` ve çeviri tablolarında dalın silmesi taşınmaz. **Ek alansız bağlantı tablosu** (junction, iki bağ alanı)
+  satırını `(sol, sağ)` çiftiyle tanır: anahtar `rows.<sol>|<sağ>`'dir, aynı bağ iki tarafta farklı kimlikle tek bağdır;
+  sahibi (sol taraf) dalda `all` ise dalın kaldırdığı bağ development'tan da kalkar (ADR 0031).
+- **Kimlik çakışması:** iki taraf tabanda olmayan aynı anahtarla farklı satır açtıysa `rows.<anahtar>` yolunda tek
+  `conflict` gelir, `base` boştur. `source` dalın satırını yazar, development'ınki ezilir. `target` dalın satırını düşürür.
+  `custom` `value`'daki satırı yazar. `both` ikisini de tutar: development'ın satırı yerinde kalır, dalın satırı
+  **yeni anahtarla** eklenir. Sayı anahtarda en büyüğün bir fazlası, `uuid`'de yeni kimlik verilir. Dalın o satıra bakan
+  satırları yeni anahtara çevrilir. `both` yalnız `combinable: true`'da geçer; metin anahtarda 400 döner.
+- **Development tabloyu taşımıyorsa** (entity var, ayarı kapalı) development'ın satırları bilinmez: tablo kökünde tek
+  çakışma gelir. `source` dalın satırlarını yazar (silmeden), `target` atlar. Tablo development'ta hiç yoksa satırlar
+  `add`'dir.
+- **Veri olmadan açılmış dal**da taban yoktur: yalnız dalda olan satır `add`, iki tarafta farklı olan satır kimlik
+  çakışması gelir.
+- **Roller `[SY] Roles`'un kendi ayarıyla gelir** (2026-10-18). Rol kalemi `module: "role"`dur, satır kalemi değil;
+  gövdesi uygulamanın `roles`'a eklediği alanları (`code` …) da taşır. Dalda `roles` `all` ya da `specific` ise ayarın
+  kapsadığı roller `add` / `update` gelir (`delete` yalnız `all`'da), rolün kendi bağları (rol ↔ izin) satır kalemidir.
+  **Ayar kapalıysa** yalnız dalın bir sayfası, ucu, klasörü, erişim politikası ataması ya da taşınan bir satırı
+  kimliğiyle, bir süreç tanımı slug'ıyla gösterdiği **yeni** rol `add` gelir; rol ↔ izin bağları gelmez, development'taki
+  rol değişmez. Dalın yeni rolleri ve bağları gidecekse `merge_plan`'dan önce dalda `entity_patch roles` ile
+  `recordTransferMode`'u `all` ya da `specific` (+ `transferRowIds`) yapın. Başka tablonun role bağı (grup ↔ rol) o
+  tablonun ayarıyla gelir, gösterdiği rol development'ta yoksa kurulur. İki tarafın da eklediği aynı bağ (ek alansız
+  bağlantı tablosu) tek bağ sayılır, `23505` vermez. Development'ta ayar kapalıyken dalda ilk açılışta rolün bağ tablosu
+  kökte tek çakışma gelir → `source` (o ilk merge'te silme çıkmaz, development'ın bağları bilinmiyordur). Ayar iki
+  tarafta da açıkken dalda kaldırılan izin ve silinen rolün bağları development'tan da kalkar, rol de silinir.
+- **Apply ayna yapmaz.** Yalnız planın değiştirdiği satırlar yazılır, silinecek anahtarlar önce silinir.
+  Development'ta ayarlı bir tablo plandan sonra değişirse plan bayatlar (`isStale`) ve `merge_refresh` ister.
+  `merge_revert` satırları da ters çevirir: merge'ün eklediği satır `delete` gelir.
+
+```json
+{ "itemKey": "row:01a0…", "path": "rows.571", "choice": "both" }
+```
+
 ## Apply'ın reddettiği üç durum
 
 | Durum | Kod | Ne yapmalı |
@@ -239,6 +298,17 @@ yoktur; kalan çakışmalar için `merge_get {planId, view:"conflicts"}` çağı
 
 Aynı `merge_apply` çağrısını tekrarlamak sonucu değiştirmez — 409 geçici bir hata değildir.
 
+Bir kararın yazılacağı yer development'ın gövdesinde yoksa `merge_get { checks: true }` hata düzeyinde bir
+`not-applicable` kontrolü döner (yol `path`'tedir). O hâlde apply etme: planı yenile (`merge_refresh`), o yoldaki kararı
+yeniden ver ve kontrolleri tekrar oku. Kontrol sürerse `platform_gap_report` ile bildir; bu, motorun eşleyemediği bir
+dizi demektir.
+
+Kontrol okunmadan apply edilirse süreç `MergeResolutionNotApplicableException` ile hataya düşer. Plan `failed` olur ve
+yenilenemez; yeni plan gerekir.
+
+2026-10-18 öncesinde bu kararlar sessizce düşüyordu. Workflow dalları artık adla eşlenir (`branches[name=…]`); adı
+değişen dal kayıt kimliğiyle tanınır, kimliği Studio'da yenilenmiş dal da kaybolmaz.
+
 ## Başlık zorunludur
 
 İsteğin adı **plan açılırken** `merge_plan`'ın `title` alanında verilir; `merge_apply` ve `merge_revert` ayrı bir
@@ -332,6 +402,13 @@ plan `applied` kalır.
 - `applied` → dal `merged` olur ve **şeması düşer**; `environment_list` artık göstermez.
 - `applied-with-drift` → dal ve şeması **durur**. `verification.driftTables` dal ile development
   arasında hâlâ farklı olan tabloları listeler; incelenmeden dal silinmez.
+  - **Bilinen yanlış alarm — platform tabloları (geçici çözüm, 2026-10-15).** `driftTables` yalnız `users`,
+    `roles`, `files`, `folders` ve `permissions`'tan oluşuyorsa fark gerçek değildir. Bu tabloların zorunlu
+    sütunları, platformun 2026-10-06 öncesi koduyla dokunulmuş bir development'ta `NOT NULL`, yeni açılan dalda
+    `NULL`'dır; doğrulama bu farkı görür. Merge'ün içeriği development'a tam geçmiştir. Dal ise `merged` ve aktif
+    kalır: proje başına 5 dal sınırından yer tutar, taban görüntüsü temizlenmez. Bu tablolara dokunan her merge'de
+    tekrar eder. Yapılacak: dalı elle silin — `environment_delete {projectId, environmentId}` (`merged` dal
+    silinir, şeması düşer). `driftTables`'ta bunların dışında bir tablo varsa dalı silmeden önce o farkı inceleyin.
 - `failed` → plan `failed`, dal `ready`'ye döner. Dal ve içindeki iş kaybolmaz; yeniden planlanır.
 
 ## Sınırlar