@appaflytech/zeyrek-ai-mcp 0.0.40 → 0.0.42

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
@@ -126,6 +127,32 @@ Son kullanıcı dili `language-selector` komponentiyle değiştirir (`platform_g
 prop'lar sayfa yenilenmeden yeniden çözülür — ayrı bir akış kurmana gerek yok, komponenti sayfaya
 eklemen yeterli. Projede dil tanımlı değilse (`languages` boşsa) liste boş çizilir.
 
+**Akıştan dil (2026-10-14 frontend; uzak kurulumda dağıtımdan sonra):** kod adımında ve `{{ }}` bağında
+`Page.language` etkin dil kodunu verir, `Page.setLanguage('en')` dili seçicinin yaptığı gibi değiştirir
+(saklanır, bütün bağlar yeni dilde çözülür; projede olmayan kod yok sayılır). "Girişten sonra
+kullanıcının kayıtlı diline geç" böyle kurulur — sayfayı yenilemek gerekmez. Seçicinin `self.value`'su
+`mount`'ta boştur; dili okumak için `Page.language` kullan.
+
+## İfade başka komponentin çeviri bağlı prop'unu okuyunca
+
+2026-10-14 frontend'inden (uzak kurulumda dağıtımdan) sonra ifade, kod adımı, `self`, `Widget.x`, setter'ın
+eleman kopyası ve uç argümanının Property kaynağı çeviriye bağlı prop'u **ekranda görünen metinle**
+okur — iç içe dizilerdekiler dahil (`{{ menu.navigations }}` başlıklarla gelir, `drawer.actions.map(a =>
+a.text)` düğme metinlerini verir). Akış okuduğu diziyi geri yazınca, yazılan metin o anki çeviriyle
+aynıysa çeviri bağı korunur ve dil sonradan değişince o metin de değişir; farklı metin yazılırsa bağın
+yerini o metin alır. Bu sürümden önceki kurulumda aynı okuma `null` verir (menü boş, geri yazılan düğme
+yazısı kaybolur) — orada geri okunan diziyi çeviriye bağlama.
+
+## html şablonunda çeviri: `{{#t}}anahtar{{/t}}`
+
+html bileşeninin `content`'inde `{{#t}}page.x.baslik{{/t}}` sözlükteki metni etkin dilde basar (zincir
+ekrandakiyle aynı), HTML kaçışlıdır ve dil değişince yeniden çizilir. Bölümün içi önce çizildiği için
+anahtar `context`'ten kurulabilir: `{{#t}}common.status.{{durum}}{{/t}}`. `context`'i akışlar baştan
+yazsa da şablondaki metin etkilenmez — birden çok akışın doldurduğu html'deki sabit metni çevirmenin yolu
+budur. Lambda yalnız `{{#t}}` geçen şablona eklenir; `context` kendi `t` alanını taşıyorsa o kazanır; markup taşıyan cümle yine `context` + `{{{…}}}` ile
+basılır; datatable'ın `html` hücresi bu sözdizimini tanımaz. 2026-10-14 frontend'i (frontend ADR 0021),
+uzak kurulumda dağıtımdan sonra.
+
 ## Kareyi ikinci dilde almak: `page_screenshot(language:)`
 
 Dil değiştirici **kanıt için gerekli değildir.** Runtime boot dilini şu sırayla seçer:
@@ -194,6 +221,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,6 +1,6 @@
 {
-  "hash": "63d0b9efc3b8d0c0d8ef9c8b7478b3abf8cb482e4e80276202b3faed73cedddf",
-  "generatedAt": "2026-10-08T09:32:48.956Z",
+  "hash": "ba18a5111614d9b1e63e0d50f1a06a4dce1081b3d482c88e7620ca4bda9a466b",
+  "generatedAt": "2026-10-14T08:45:02.944Z",
   "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.",

package/dist/resources/schemas/ResolveMergeConflictsCommand.json

@@ -41,6 +41,9 @@
           },
           "choice": {
             "$ref": "#/components/schemas/NgApps.Domain.Contexts.Organization.Merges.MergeChoice"
+          },
+          "value": {
+            "$ref": "#/components/schemas/System.Text.Json.Nodes.JsonNode"
           }
         },
         "additionalProperties": false
@@ -48,10 +51,36 @@
       "NgApps.Domain.Contexts.Organization.Merges.MergeChoice": {
         "enum": [
           "source",
-          "target"
+          "target",
+          "both",
+          "custom"
         ],
         "type": "string",
         "format": ""
+      },
+      "System.Text.Json.Nodes.JsonNode": {
+        "type": "object",
+        "properties": {
+          "options": {
+            "$ref": "#/components/schemas/System.Text.Json.Nodes.JsonNodeOptions"
+          },
+          "parent": {
+            "$ref": "#/components/schemas/System.Text.Json.Nodes.JsonNode"
+          },
+          "root": {
+            "$ref": "#/components/schemas/System.Text.Json.Nodes.JsonNode"
+          }
+        },
+        "additionalProperties": false
+      },
+      "System.Text.Json.Nodes.JsonNodeOptions": {
+        "type": "object",
+        "properties": {
+          "propertyNameCaseInsensitive": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
       }
     }
   }

package/dist/tools/activities.js

@@ -13,6 +13,8 @@ const activityKind = z.enum([
     'merge.applied_with_drift',
     'merge.discarded',
     'merge.failed',
+    'merge.replanned',
+    'merge.resolutions_carried',
     'deployment.started',
     'deployment.completed',
     'deployment.failed',
@@ -25,7 +27,7 @@ export function registerActivityTools(server, platform) {
     const config = platform.config;
     server.registerTool('activity_list', {
         title: 'Proje etkinlik günlüğü',
-        description: "Projenin dal, merge ve dağıtım geçmişini en yeniden eskiye listeler: kim, ne zaman, ne yaptı. Her satırda kind, actor, actorSource (human|ai|system), occurredAt ve türe göre değişen bir summary vardır — merge.applied'da message ve counters, environment.created'da branchName, deployment.*'da süre ya da hata. subjectId merge satırlarında plan id'sidir; ayrıntı için merge_get ile okuyun. actorSource='ai' satırları bu gateway üzerinden yapılan işlerdir.",
+        description: "Projenin dal, merge ve dağıtım geçmişini en yeniden eskiye listeler: kim, ne zaman, ne yaptı. Her satırda kind, actor, actorSource (human|ai|system), occurredAt ve türe göre değişen bir summary vardır — merge.applied'da message ve counters, merge.resolutions_carried'da carried/dropped (tazelemede korunan ve yeniden sorulan karar sayısı), environment.created'da branchName, deployment.*'da süre ya da hata. subjectId merge satırlarında plan id'sidir; ayrıntı için merge_get ile okuyun. actorSource='ai' satırları bu gateway üzerinden yapılan işlerdir.",
         inputSchema: {
             projectId: guid,
             kind: activityKind,

package/dist/tools/applications.js

@@ -2,6 +2,7 @@ import { guid, pagingParams, readOnly, writes, updates, destructive } from './co
 import { handle } from '../platform/responses.js';
 import { forgetApplication, readApplicationPlatform, resolveApplication } from '../knowledge/platform/resolve.js';
 import { mobileTabsProblems, readMobileTabs } from '../knowledge/platform/mobileTabs.js';
+import { mobileTransitionProblems } from '../knowledge/platform/pageTransition.js';
 import { findingLine } from '../knowledge/platform/profile.js';
 import { listComponents } from './components.js';
 import { z } from 'zod';
@@ -37,6 +38,19 @@ export async function mobileTabsWarnings(platform, applicationId, projectSlug, h
         guide: "platform_guide('mobile') §Gezinme"
     }));
 }
+/**
+ * MOB-029 (varsayılan sayfa geçişi) — `properties.mobile.transition` yazan mobil uygulama çağrısının denetimi.
+ * Yazım platforma YİNE gider (backend `properties`'i doğrulamaz); cihaz sözlük dışı değeri sessizce düşürdüğü için
+ * bulgunun söylendiği tek yer `platformWarnings`'tir.
+ */
+export function mobileTransitionWarnings(properties) {
+    return mobileTransitionProblems(properties).map(message => findingLine({
+        code: 'MOB-029',
+        severity: 'warn',
+        message,
+        guide: "platform_guide('page') §Kural 1g-2"
+    }));
+}
 function withPlatformWarnings(response, warnings) {
     if (warnings.length === 0 || !response || typeof response !== 'object' || Array.isArray(response))
         return response;
@@ -77,7 +91,7 @@ export function registerApplicationTools(server, platform) {
         annotations: writes
     }, handle(config, async ({ projectId, ...body }) => {
         const warnings = readApplicationPlatform(body.type) === 'mobile'
-            ? await mobileTabsWarnings(platform, undefined, undefined, undefined, body.properties)
+            ? [...await mobileTabsWarnings(platform, undefined, undefined, undefined, body.properties), ...mobileTransitionWarnings(body.properties)]
             : [];
         const response = await platform.org('POST', `/applications/${projectId}`, { body });
         forgetApplication(platform);
@@ -100,7 +114,7 @@ export function registerApplicationTools(server, platform) {
     }, handle(config, async ({ id, ...body }) => {
         const current = await resolveApplication(platform, id);
         const warnings = current?.platform === 'mobile'
-            ? await mobileTabsWarnings(platform, id, current.projectSlug, body.homepageId, body.properties)
+            ? [...await mobileTabsWarnings(platform, id, current.projectSlug, body.homepageId, body.properties), ...mobileTransitionWarnings(body.properties)]
             : [];
         const response = await platform.org('PUT', `/applications/${id}`, { body });
         forgetApplication(platform, id);

package/dist/tools/components.js

@@ -1,8 +1,8 @@
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
-import { normalizeComponentDefaults, componentDefaultsNote, assertComponentBlocks, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, normalizeDroppableStates, withNormalization } from '../knowledge/normalize.js';
+import { normalizeComponentDefaults, assertNoRetiredNodes, componentDefaultsNote, assertComponentBlocks, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, normalizeDroppableStates, withNormalization } from '../knowledge/normalize.js';
 import { eventContractsFor, eventPayloadNote } from '../knowledge/componentEvents.js';
 import { componentPresetDefaults, readProjectTheme } from '../knowledge/themeSchema.js';
-import { knowledgeFor, knowledgeNote, APPEARANCE_TOKEN_SETS, STATE_FLAG_NOTES, INTERNAL_ROLES_BY_TYPE } from '../knowledge/componentCatalog.js';
+import { knowledgeFor, knowledgeNote, retiredComponent, APPEARANCE_TOKEN_SETS, STATE_FLAG_NOTES, INTERNAL_ROLES_BY_TYPE } from '../knowledge/componentCatalog.js';
 import { MOBILE_STATE_FLAG_NOTES, mobileComponentKnowledge } from '../knowledge/mobileComponentCatalog.js';
 import { mobileComponentEventContracts } from '../knowledge/mobileComponentEvents.js';
 import { componentUpdateBody, fetchHost, schemaParam, unwrap } from './screens.js';
@@ -184,7 +184,7 @@ export function registerComponentTools(server, platform) {
     const config = platform.config;
     server.registerTool('component_list', {
         title: 'Komponent sözlüğünü listele',
-        description: "Sayfaya konabilecek kayıtlı komponent tiplerini (slug, name, kategori, droppable) kompakt listeler; tek tipin tam sözlüğü + davranış bilgisi için component_get, komponent modelinin geneli için platform_guide('component'). scope:'all' platformun varsayılan kataloğunu da getirir.",
+        description: "Sayfaya konabilecek kayıtlı komponent tiplerini (slug, name, kategori, droppable) kompakt listeler; retired: true taşıyan tip katalogdan kaldırılmıştır, yerine replacedBy kullanılır; tek tipin tam sözlüğü + davranış bilgisi için component_get, komponent modelinin geneli için platform_guide('component'). scope:'all' platformun varsayılan kataloğunu da getirir.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -207,13 +207,16 @@ export function registerComponentTools(server, platform) {
                 categories: component.categories,
                 isDroppable: component.isDroppable,
                 kind: component.kind,
-                widgetType: component.widgetType
+                widgetType: component.widgetType,
+                ...(retiredComponent(typeof component.slug === 'string' ? component.slug : undefined)
+                    ? { retired: true, replacedBy: retiredComponent(String(component.slug)).replacedBy }
+                    : {})
             }))
         };
     }));
     server.registerTool('component_get', {
         title: 'Komponent sözlüğünü getir',
-        description: "Tek komponent tipinin tam sözlüğü: prop'lar (tip/enum/default), event'ler (yükleriyle), davranış bilgisi (knowledge) ve boyut sınırları. Şemaya uydurma prop yazmayın — yalnız burada dönenleri kullanın. Yanıtta guide alanı dönerse derin rehberi platform_guide ile okuyun (örn. html). slug ya da id ile çağrılır.",
+        description: "Tek komponent tipinin tam sözlüğü: prop'lar (tip/enum/default), event'ler (yükleriyle), davranış bilgisi (knowledge) ve boyut sınırları. Şemaya uydurma prop yazmayın — yalnız burada dönenleri kullanın. Yanıtta guide alanı dönerse derin rehberi platform_guide ile okuyun (örn. html). Yanıtta retired alanı dönerse tip katalogdan kaldırılmıştır (kayıt defterinde eşitleme silmediği için durur): o tipi yeni düğümde kullanmayın, replacedBy'ı kullanın. slug ya da id ile çağrılır.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -242,6 +245,7 @@ export function registerComponentTools(server, platform) {
             : [];
         const componentSlug = typeof component.slug === 'string' ? component.slug : undefined;
         const knowledge = knowledgeFor(componentSlug);
+        const retired = retiredComponent(componentSlug);
         // Mobil uygulamada kayıt mobil kataloğun satırıdır (`listComponents` type=mobile); davranış
         // notları web runtime'ından gelir (`knowledge` — mobil şema web sınıfını genişletir), bileşenin
         // mobil farkları `mobileKnowledge`'ta, bütün mobil bileşenlere geçen notlar `mobileNotes`'ta (G4).
@@ -262,6 +266,7 @@ export function registerComponentTools(server, platform) {
             slug: component.slug,
             name: component.name,
             description: component.description,
+            ...(retired ? { retired } : {}),
             kind: component.kind,
             widgetType: component.widgetType,
             isDroppable: component.isDroppable,
@@ -282,7 +287,7 @@ export function registerComponentTools(server, platform) {
             ...(componentSlug && INTERNAL_ROLES_BY_TYPE[componentSlug]
                 ? {
                     internalRoles: INTERNAL_ROLES_BY_TYPE[componentSlug],
-                    internalRolesNote: "Bu komponentin İÇ kontrolleri dışarıdan adreslenebilir: page_screenshot actions hedefine '<elementId>__<rol>' yazın (ör. 'tbl_vacancy__pager-next'). Kimlikler runtime'ın data-element-id özniteliğidir; ikinci bir mekanizma yoktur."
+                    internalRolesNote: "Bu komponentin İÇ kontrolleri dışarıdan adreslenebilir: page_screenshot actions hedefine '<elementId>__<rol>' yazın (ör. 'tabs_ayar__tab-genel'). Kimlikler runtime'ın data-element-id özniteliğidir; ikinci bir mekanizma yoktur."
                 }
                 : {}),
             ...(themeDefaults ? { themeDefaults } : {}),
@@ -322,6 +327,7 @@ export function registerComponentTools(server, platform) {
         if (body.kind === 'widget' && !body.widgetType) {
             throw new PlatformApiError("kind:'widget' için widgetType (container | modal | drawer) zorunludur.");
         }
+        assertNoRetiredNodes(body.schema);
         const wrapped = body.kind === 'widget' && body.widgetType && (body.schema ?? []).length > 0
             ? wrapWidgetRoot(body.schema ?? [], body.widgetType, await listComponents(platform, project, environment, applicationId).catch(() => []))
             : { schema: body.schema, notes: [] };

package/dist/tools/designSchemaPatch.js

@@ -1,5 +1,5 @@
-import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, normalizeSchemaOps, assertAddComponentIds, validationNote, componentNameNote, componentDefaultsNote, replacePropNote, flexSizeWarnings, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, verticalGapWarnings, withNormalization, FLEX_LAYOUT_PROP_NAMES } from '../knowledge/normalize.js';
-import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, styleTargetTypesFrom, simulateLayoutOps, removeNodeFromTree, planEventRemovals, planResizes, planPropTypes, assertOpBodies, applySkeletonOps, reshapesSkeleton } from './schemaOps.js';
+import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, normalizeSchemaOps, assertAddComponentIds, assertNoRetiredTypes, validationNote, componentNameNote, componentDefaultsNote, replacePropNote, flexSizeWarnings, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, verticalGapWarnings, withNormalization, FLEX_LAYOUT_PROP_NAMES } from '../knowledge/normalize.js';
+import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, removeNodeFromTree, planEventRemovals, callerSlots, planEmulatedOps, recordsWithEventRemovals, serverOpsInOrder, assertOpBodies, applySkeletonOps, reshapesSkeleton } from './schemaOps.js';
 import { guid, projectParam, environmentParam, updates, microOps } from './common.js';
 import { fetchHost, hostPath } from './screens.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
@@ -10,6 +10,7 @@ import { PlatformApiError } from '../platform/errors.js';
 import { connectDataOpIssues, connectedPropKeys } from '../knowledge/connectDataDefinition.js';
 import { handle } from '../platform/responses.js';
 import { slotWarning } from './layouts.js';
+import { batchEnvelopeNote, openBatchEnvelopes } from '../knowledge/platform/batchOps.js';
 import { applicationTypeField, resolveProfile } from '../knowledge/platform/resolve.js';
 import { boundFlowSteps, layoutPatchWarnings, screenProfileWarnings } from './profileWrite.js';
 import { z } from 'zod';
@@ -57,12 +58,14 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, ops, operations, allowFlowDeletion, view }) => {
-        const allOps = microOps(spec.tool, ops, operations).map(op => op);
+        const opened = openBatchEnvelopes(spec.tool, microOps(spec.tool, ops, operations).map(op => op));
+        const allOps = opened.ops;
         const removeEventOps = allOps.filter(entry => entry.op === 'remove_event');
         const resizeOps = allOps.filter(entry => entry.op === 'resize_component');
         const propTypeOps = allOps.filter(entry => entry.op === 'set_prop_type');
         const opRecords = allOps.filter(entry => !['remove_event', 'resize_component', 'set_prop_type'].includes(String(entry.op)));
         assertAddComponentIds(opRecords);
+        assertNoRetiredTypes(opRecords);
         const record = await fetchHost(platform, host, project, environment, applicationId, id);
         // Platform ucu kaydın türüne bakmaz: sıradan bir komponentin id'si verilirse kataloğundaki
         // tanımın yanına bir şema yazılırdı.
@@ -78,15 +81,13 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         const sectionToggles = expandSectionToggles(opRecords, nodes, sectionIds);
         const sectionNotes = boxSectionNote([...createdSections, ...sectionToggles.created], sectionToggles.removed);
         const events = host === 'layout' ? record.events : undefined;
-        // Normalizasyon kayıttan SONRA koşar: stil anahtarı çevirisi hedefin komponent TİPİNE bakar
-        // (TB-129, table.style.th/td kebab-case kalır) ve tip yalnız okunan ağaçta var. Gövde hataları
-        // bu yüzden bir okuma sonrasında rapor edilir; karar hiç değişmez, yalnız sıra değişti.
-        const normalized = normalizeSchemaOps(opRecords, styleTargetTypesFrom(opRecords, nodes));
+        const normalized = normalizeSchemaOps(opRecords);
         assertOpBodies(opRecords, propTypeOps);
         // CD-005 layout ve widget host'unda da: bağlı prop'u (iç içe yol dahil) ezen yazma ve bağlı olmayan prop'ta
         // remove_connect_data okunan ağaca bakarak reddedilir (gövde denetimi assertOpBodies'te koştu).
         const connectedProps = connectedPropKeys(nodes);
-        const connectionIssues = opRecords.flatMap(entry => connectDataOpIssues(entry, connectedProps).map(issue => `${issue.code} — ${issue.message}`));
+        // `set_prop_type` ayrı listededir; bağlı prop'u ezen yazımı o da yapar (sayfa yamasıyla aynı kapı).
+        const connectionIssues = [...opRecords, ...propTypeOps].flatMap(entry => connectDataOpIssues(entry, connectedProps).map(issue => `${issue.code} — ${issue.message}`));
         if (connectionIssues.length > 0)
             throw new PlatformApiError(`Connect Data op gövdesi geçersiz (istek gönderilmedi): ${connectionIssues.join(' · ')}`, 400);
         if (opRecords.some(entry => entry.op === 'set_event' || entry.op === 'add_event')) {
@@ -102,7 +103,9 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
                 throw new PlatformApiError(`PAGE-008 — geçersiz olay adı (istek gönderilmedi): ${unknown.join(' · ')}`, 400);
         }
         stripGatewayEventFields(opRecords);
-        const deletedFlows = orphanedFlowPlan(nodes, events, [...opRecords, ...removeEventOps]);
+        // Bölüm anahtarı op'larını yukarıda ekledi; buradan sonra `opRecords` yeni op almaz.
+        const slots = callerSlots(allOps, opRecords);
+        const deletedFlows = orphanedFlowPlan(nodes, events, recordsWithEventRemovals(slots, opRecords));
         if (deletedFlows.length > 0 && allowFlowDeletion !== true)
             throw new PlatformApiError(orphanedFlowMessage(deletedFlows), 400);
         const added = opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component);
@@ -120,7 +123,7 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         // her yamada koşsaydı kayıtlı ağacında zaten iç içe repeater olan layout hiç yamalanamazdı.
         const simulatable = opRecords.some(entry => ['add_component', 'move_component'].includes(String(entry.op))
             || (entry.op === 'replace_prop' && FLEX_LAYOUT_PROP_NAMES.has(String(entry.prop ?? ''))));
-        const nested = simulatable ? nestedRepeaterNodes(simulated) : [];
+        const nested = simulatable ? nestedRepeaterNodes(simulated, resolved.profile.platform) : [];
         if (nested.length > 0)
             throw new PlatformApiError(nestedRepeaterMessage(nested, resolved.profile.platform), 400);
         const reshaped = simulatable || opRecords.some(entry => entry.op === 'remove_component');
@@ -145,9 +148,10 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
             layoutWarnings.push(...layoutPatchWarnings(resolved, nodes, skeleton));
         }
         const removedEvents = planEventRemovals(removeEventOps);
-        const resized = resizeOps.length > 0 ? planResizes(nodes, resizeOps, spec.readTool) : { serverOps: [], applied: [], warnings: [] };
-        const propTypes = propTypeOps.length > 0 ? planPropTypes(nodes, propTypeOps, spec.readTool) : { serverOps: [], applied: [] };
-        const serverOps = [...removeEventOps, ...resized.serverOps, ...propTypes.serverOps, ...opRecords];
+        // Sayfa yamasıyla aynı iki söz (`pages.ts` `planPageWrite`, PAGE-050): öykünülen op ağacın o andaki hâline göre
+        // planlanır ve liste platforma çağıranın sırasıyla gider.
+        const { resized, propTypes } = planEmulatedOps(nodes, slots, opRecords, spec.readTool);
+        const serverOps = serverOpsInOrder(slots, { sent: opRecords, resized: resized.groups, propTypes: propTypes.serverOps });
         const response = ((await platform.tenant('PATCH', project, `${hostPath(host, applicationId, id)}/schema`, {
             environment,
             body: { ops: serverOps }
@@ -181,6 +185,7 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
             }
         }
         return withWriteDiff(withNormalization(response, [
+            ...batchEnvelopeNote(opened),
             ...componentNameNote(normalized.names),
             ...sectionNotes,
             ...componentDefaultsNote(normalized.components),

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/layouts.js

@@ -2,8 +2,8 @@ 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 { fillComponentNames, componentNameNote, normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
-import { fetchHost, layoutUpdateBody, schemaParam, eventsParam, modeParam, summarize, findNode } from './screens.js';
+import { fillComponentNames, componentNameNote, normalizeComponentDefaults, assertNoRetiredNodes, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.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';
@@ -15,7 +15,7 @@ import { jsonArray } from '../platform/jsonArray.js';
 import { z } from 'zod';
 const patchOperationsParam = jsonArray(z.array(z.record(z.unknown())).min(1))
     .describe("JSON Patch listesi (RFC 6902): { op, path, value }. Yol seçici alabilir — '/views/0/children[elementId=baslik]/props/content/data'.");
-const viewsParam = schemaParam.describe("Layout'un komponent ağacı: her düğümde elementId, name (= elementId), type, blocks zorunlu — blocks: [{ breakpoint: 1024, size: { w, h }, position: { x, y } }], gateway doldurmaz (PAGE-037). DİKKAT: layout'ta şema alanının adı 'schema' değil 'views'tir; ağaçta hedefli değişiklik için tam ağaç yerine layout_schema_patch micro-op'larını kullanın. İçinde MUTLAKA bir { type: 'slot' } komponenti olmalı — sayfa içeriği YALNIZ slot'un içine render edilir, slot'suz layout'a bağlanan sayfalar boş görünür. 2026-09-08'den beri views, page_schema_patch'in doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile REDDEDİLİR (kabul edilen değer listesiyle) ve hiçbir şey kaydedilmez — eskiden sessizce kaydediliyordu (P1-2).");
+const viewsParam = schemaParam.describe("Layout'un komponent ağacı: her düğümde elementId, name (= elementId), type, blocks zorunlu — blocks: [{ breakpoint: 1024, size: { w, h }, position: { x, y } }], gateway doldurmaz (PAGE-037). DİKKAT: layout'ta şema alanının adı 'schema' değil 'views'tir; ağaçta hedefli değişiklik için tam ağaç yerine layout_schema_patch micro-op'larını kullanın. İçinde MUTLAKA bir { type: 'slot' } komponenti olmalı — sayfa içeriği YALNIZ slot'un içine render edilir, slot'suz layout'a bağlanan sayfalar boş görünür. 2026-09-08'den beri views, page_schema_patch'in doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile REDDEDİLİR (kabul edilen değer listesiyle) ve hiçbir şey kaydedilmez — eskiden sessizce kaydediliyordu (P1-2). layout_create'te katalogdan kaldırılan tipte düğüm (component_list'te retired: true) PAGE-051 ile reddedilir.");
 function countSlots(nodes) {
     if (!Array.isArray(nodes))
         return 0;
@@ -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.");
@@ -103,6 +118,7 @@ export function registerLayoutTools(server, platform) {
         const resolved = await resolveProfile(platform, applicationId);
         const named = fillComponentNames(views);
         assertScreenWriteGuards('layout', { schema: views, events }, resolved.profile.platform);
+        assertNoRetiredNodes(views);
         const fixed = normalizeComponentDefaults(views);
         const catalogNotes = await assertScreenCatalog(platform, project, environment, applicationId, views, 'layout_create');
         const gaps = [
@@ -212,6 +228,10 @@ export function registerLayoutTools(server, platform) {
         const profile = await resolveProfile(platform, applicationId);
         const named = fillComponentNames(overrides.views);
         assertScreenWriteGuards('layout', { schema: overrides.views, events: overrides.events }, profile.profile.platform);
+        // PAGE-051: ağacın tamamı değil yalnız yamanın EKLEDİĞİ düğümler — kayıtlı emekli düğüm yazılabilir kalır.
+        assertNoRetiredNodes(resolved.operations
+            .filter(op => op.op === 'add' && /\/(views|children)\/(\d+|-)$/.test(String(op.path ?? '')))
+            .map(op => op.value));
         const fixed = normalizeComponentDefaults(overrides.views);
         const catalogNotes = await assertScreenCatalog(platform, project, environment, applicationId, overrides.views, 'layout_patch');
         const body = layoutUpdateBody({ ...current, applicationId }, overrides);