@appaflytech/zeyrek-ai-mcp 0.0.7 → 0.0.9

package/dist/platform/screenshotMemory.js

@@ -0,0 +1,55 @@
+import { createHash } from 'node:crypto';
+/** Alan sırasından bağımsız anahtar: aynı istek her çağrıda aynı sha256'yı üretmeli. */
+function stable(value) {
+    if (Array.isArray(value))
+        return value.map(stable);
+    if (value && typeof value === 'object') {
+        const source = value;
+        return Object.keys(source).sort().reduce((target, key) => {
+            if (source[key] !== undefined)
+                target[key] = stable(source[key]);
+            return target;
+        }, {});
+    }
+    return value;
+}
+export function captureKey(parts) {
+    return createHash('sha256').update(JSON.stringify(stable(parts))).digest('hex');
+}
+export function imageHash(image) {
+    return createHash('sha256').update(image).digest('hex');
+}
+export class CaptureMemory {
+    limit;
+    entries = new Map();
+    constructor(limit = 50) {
+        this.limit = limit;
+    }
+    recall(key) {
+        return this.entries.get(key);
+    }
+    remember(key, entry) {
+        // Yeniden yazılan anahtar halkanın SONUNA gider: sık çekilen sayfa düşmesin.
+        this.entries.delete(key);
+        this.entries.set(key, entry);
+        while (this.entries.size > this.limit) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.entries.delete(oldest);
+        }
+    }
+    get size() {
+        return this.entries.size;
+    }
+}
+/**
+ * SÜREÇ düzeyinde tek bellek.
+ *
+ * HTTP taşıması her POST için YENİ bir gateway sunucusu kuruyor (`index.ts` `app.post('/mcp')`
+ * → `createGatewayServer`), yani `registerPageTools` istek başına koşuyor. Bellek o fonksiyonun
+ * içinde yaratıldığında her çağrı boş bir halkayla başlıyor ve `diff` her seferinde "ilk kare"
+ * diyordu — ölçüldü 2026-09-16, dört ardışık çağrının dördü de `baselineAt` yok. Stdio
+ * taşımasında sunucu oturum boyu yaşadığı için kusur orada görünmüyordu.
+ */
+export const sharedCaptureMemory = new CaptureMemory();

package/dist/platform/strictArguments.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+function isRawShape(value) {
+    if (!value || typeof value !== 'object' || '_def' in value)
+        return false;
+    return Object.values(value).every(entry => entry instanceof z.ZodType);
+}
+/**
+ * GW-005 — tanınmayan üst düzey argüman REDDEDİLİR.
+ *
+ * SDK ham şekli `z.object(shape)` ile sarar ve zod'un varsayılanı bilinmeyen anahtarı hata vermeden
+ * ATMAKTIR: şemada olmayan bir alan doğrulamadan geçer, handler'a hiç ulaşmaz ve çağrı başarıyla
+ * biter. 2026-09-15 G-13'te `microservice_execute`/`microservice_debug`/`query_preview`'a verilen
+ * `parameters` böyle kayboldu — dört farklı filtre aynı gövdeyi döndü ve ölçüm aracı çağıranı
+ * olmayan bir sorgu kusuruna yönlendirdi. Tek tek tool'lara alan eklemek sınıfı kapatmaz; sessizlik
+ * burada, SDK'ya şema verilmeden önce kaldırılır.
+ */
+export function rejectUnknownArguments(server) {
+    const registerTool = server.registerTool.bind(server);
+    server.registerTool = ((name, config, callback) => {
+        if (!isRawShape(config.inputSchema))
+            return registerTool(name, config, callback);
+        const shape = config.inputSchema;
+        const accepted = Object.keys(shape).join(', ');
+        const inputSchema = z.object(shape, {
+            errorMap: (issue, context) => issue.code === 'unrecognized_keys'
+                ? { message: `${name} şu üst düzey argümanları tanımıyor: ${issue.keys.map(key => `'${key}'`).join(', ')}. Tanınmayan alan sessizce yok sayılmaz — çağrı hiç gönderilmedi. Bu tool'un okuduğu alanlar: ${accepted}.` }
+                : { message: context.defaultError }
+        }).strict();
+        return registerTool(name, { ...config, inputSchema }, callback);
+    });
+    return server;
+}

package/dist/platform/writeDiff.js

@@ -1,3 +1,4 @@
+import { PROP_VALUE_TYPES } from '../knowledge/normalize.js';
 import { logStep } from '../observability/trace.js';
 const maxDrops = 20;
 const maxDepth = 12;
@@ -214,9 +215,11 @@ export function unwrapProps(value) {
     const record = value;
     const isProp = typeof record.type === 'string' && (Object.hasOwn(record, 'data') || Object.hasOwn(record, 'ref'));
     if (isProp) {
-        // `code` ve `translation` prop'larında taşıyıcı alan `ref`'tir; `data` yalnız tasarım zamanı
-        // yedeğidir (platform_guide('translation')).
-        const carrier = record.type === 'code' || record.type === 'translation'
+        // Platform `static` dışındaki her tipte değeri `ref`'e yazar (Prop ctor'u,
+        // DesignComponentManagementSchema.cs:666); `data` ya boştur ya türetilmiştir (file URL'i, page
+        // slug'ı, translation tasarım yedeği). `data`'yı taşıyıcı saymak bağlı akışı her yazmada
+        // "kaydedilen null" gösteriyordu (S-7).
+        const carrier = record.type !== 'static' && PROP_VALUE_TYPES.has(record.type)
             ? (Object.hasOwn(record, 'ref') ? record.ref : record.data)
             : (Object.hasOwn(record, 'data') ? record.data : record.ref);
         return unwrapProps(carrier);

package/dist/resources/examples/layout-app-shell.json

@@ -6,7 +6,7 @@
     "sourceRef": "platform_guide('layout') Kural 5a/5b; zeyrek-frontend apps/studio/src/features/layout/layout.functions.ts (getDefaultLayout), packages/ng-apps-screen-builder/src/flex-layout.ts (getFlexChildStyle), packages/ng-apps-ui/src/shared/render/render.functions.ts"
   },
   "_rules": {
-    "viewsNotSchema": "Layout'ta şema alanının adı 'views'tir; micro-op hattı yoktur, değişiklik layout_update ile tam gövde olarak yazılır (LAY-001).",
+    "viewsNotSchema": "Layout'ta şema alanının adı 'views'tir (LAY-001). Kurulu layout'ta hedefli değişiklik layout_schema_patch micro-op'larıyla yazılır; tam ağaç layout_update ile.",
     "singleSlot": "TEK slot. Sayfa şeması HER slot'a ayrı ayrı kopyalanır — iki slot sayfayı iki kez çizer ve elementId'leri tekrarlar (LAY-002 / LAY-006).",
     "propValueField": "Statik prop'un değeri 'data' alanındadır ({ type:'static', ref:null, data }); 'ref' referans tipleri (flow/file) içindir. Ham değer yazarsanız gateway sarmalar ve normalizasyon notu döner.",
     "slotRowIsOpenEnded": "Slot'un grid satırı açık uçludur (runtime 'y / auto' yazar): sayfa uzadıkça slot uzar. Slot'a sabit yükseklik vermeye çalışma.",

package/dist/resources/examples/page-sign-in.json

@@ -13,7 +13,7 @@
     "rawRedirect": "redirect isRaw:true iken path ÇOK SATIRLI JS bloğudur ve son ifadenin değeri hedef adrestir. 'Korunan sayfaya gitmek isterken login'e düşen kullanıcıyı geri gönderme' deseni budur; yoksa sabit bir sayfaya gidilir (pageId + path).",
     "objectProp": "Prop değeri nesne olabilir: icon → { type:'static', ref:{ name:'progress_activity' } }.",
     "pageIsPublic": "Giriş sayfasına middlewareIds BAĞLANMAZ (guard'lı olsaydı kullanıcı giriş yapamazdı). Buna karşılık diğer sayfalar ve korunan uçlar middlewareIds ile bağlanır.",
-    "notificationIsHidden": "notification'ın şemasında isHidden 2026-08-26'dan beri VARDIR: props.isHidden'ı doğrudan bildirime yazabilirsin. Bu örnekteki box_message sarmalayıcısı o dönemin kalıntısıdır (crm koşumu B-10) ve tek bir bildirim için ARTIK GEREKMEZ — burada duruyor çünkü şeridi bir kaba sarıp birden çok parçayı birlikte gösterip gizliyor. appearance.isHidden ise hiçbir zaman çözüm DEĞİLDİR — runtime onu hiç okumaz.",
+    "notificationIsHidden": "notification'ın şemasında isHidden 2026-08-26'dan beri VARDIR: props.isHidden'ı doğrudan bildirime yazabilirsin. Bu örnekteki box_message sarmalayıcısı o dönemin kalıntısıdır (crm koşumu B-10) ve tek bir bildirim için ARTIK GEREKMEZ — burada duruyor çünkü şeridi bir kaba sarıp birden çok parçayı birlikte gösterip gizliyor. appearance'ta ise isHidden alanı YOKTUR (2026-09-15'te kaldırıldı) — görünürlük yalnız props.isHidden'dır.",
     "validationShape": "Validation gövdesi DÖRT alan taşır: { type, message, value, isActive }. 'name' anahtarı JsonIgnore'dur — {name, value, message} yazarsan tip enum varsayılanına düşer ve alan sessizce REGEX doğrulamasına döner. Tip adları TİRELİDİR (max-length / min-length / max-value / min-value); 'maxLength' backend'e yazılır ama runtime doğrulayıcı onu tanımaz ve doğrulama hiç koşmaz. Gateway düzeltebildiğini düzeltir, kalanını PAGE-016 ile reddeder."
   },
   "pageCreateArgs": {

package/dist/resources/examples/theme-brand.json

@@ -0,0 +1,162 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Studio tema panelinin ürettiği kayıtla aynı şekil. Yalnız SAPAN değerler yazılır: typeScale/radiusScale/spacingScale/actions dokunulmayan kademeleri taşımaz, böylece platform varsayılanı değişince onları izlemeye devam ederler. Preset gövdeleri sabit hex değil var(--ng-*) kullanır — preset de temayı izlesin.",
+    "usage": "theme_update({ theme: <themeUpdateArgs.theme> }) — kısmi yazma; tamamını kurmak için replace: true. componentPresets tipleri doğrulansın istiyorsanız applicationId verin (THEME-011)."
+  },
+  "_rules": [
+    "shadow.color altı haneli hex OLMALI; başka yazım üç gölgeyi birden görünmez yapar (THEME-004).",
+    "Oranlar 0 < r <= 20; aralık dışı değer runtime'da sessizce yok sayılır (THEME-007).",
+    "mode:'dark' yazılacaksa paletteDark da yazılır — karanlıkta runtime palette'e BAKMAZ (THEME-009).",
+    "componentPresets bir kaskad değil BAŞLANGIÇ değeridir: mevcut düğümlere dokunmaz; bir tip en fazla 5 versiyon taşır ve defaultVersion versiyonlar arasında olmalıdır (THEME-002).",
+    "componentStyles EMEKLİ: panel ilk kayıtta onu componentPresets'e taşır ve canlı kaskad kopar (THEME-003). Bu örnek onu hiç taşımaz."
+  ],
+  "themeUpdateArgs": {
+    "theme": {
+      "mode": "light",
+      "palette": {
+        "accent": {
+          "primary": "#4F46E5",
+          "hover": "#4338CA",
+          "muted": "#EEF2FF",
+          "subtle": "#F5F7FF"
+        },
+        "background": {
+          "canvas": "#F8FAFC",
+          "surface": "#FFFFFF",
+          "surfaceAlt": "#F1F5F9"
+        },
+        "border": {
+          "primary": "#E2E8F0",
+          "secondary": "#94A3B8"
+        },
+        "text": {
+          "primary": "#0F172A",
+          "secondary": "#475569",
+          "disabled": "#94A3B8"
+        },
+        "status": {
+          "success": "#15803D",
+          "warning": "#B45309",
+          "error": "#B91C1C",
+          "info": "#F1F5F9"
+        }
+      },
+      "paletteDark": {
+        "accent": {
+          "primary": "#818CF8",
+          "hover": "#A5B4FC",
+          "muted": "#1E1B4B",
+          "subtle": "#151338"
+        },
+        "background": {
+          "canvas": "#0B1120",
+          "surface": "#111827",
+          "surfaceAlt": "#0F172A"
+        },
+        "border": {
+          "primary": "#1F2937",
+          "secondary": "#475569"
+        },
+        "text": {
+          "primary": "#E2E8F0",
+          "secondary": "#94A3B8",
+          "disabled": "#475569"
+        },
+        "status": {
+          "success": "#34D399",
+          "warning": "#FBBF24",
+          "error": "#F87171",
+          "info": "#1F2937"
+        }
+      },
+      "fontFamily": "Inter Tight",
+      "headingFontFamily": "Sora",
+      "fontSize": "15px",
+      "fontWeight": "400",
+      "typeScale": {
+        "h1": 2.5,
+        "small": 0.8
+      },
+      "spacing": "12px",
+      "spacingScale": {
+        "xl": 5
+      },
+      "borderRadius": "8px",
+      "radiusScale": {
+        "lg": 2
+      },
+      "shadow": {
+        "offsetX": 0,
+        "offsetY": 6,
+        "blur": 12,
+        "spread": -2,
+        "color": "#1E1B4B",
+        "opacity": 18
+      },
+      "defaultInputSize": "md",
+      "actions": {
+        "blue": "#4F46E5",
+        "red": "#E11D48"
+      },
+      "presets": {
+        "kart": {
+          "padding": "16px",
+          "borderRadius": "var(--ng-radius-lg)",
+          "background": "var(--ng-background-surface)",
+          "border": "1px solid var(--ng-border-primary)",
+          "boxShadow": "var(--ng-shadow-sm)",
+          "transition": "border-color 140ms ease, box-shadow 140ms ease",
+          "&:hover": {
+            "borderColor": "var(--ng-accent-primary)",
+            "boxShadow": "var(--ng-shadow-md)"
+          }
+        },
+        "sessizMetin": {
+          "color": "var(--ng-text-secondary)",
+          "fontSize": "var(--ng-font-size-small)"
+        }
+      },
+      "componentPresets": {
+        "button": {
+          "defaultVersion": "V1",
+          "versions": {
+            "V1": {
+              "props": {
+                "size": "lg"
+              },
+              "appearance": {
+                "marginType": "custom",
+                "marginValues": {
+                  "top": 0,
+                  "right": 0,
+                  "bottom": 12,
+                  "left": 0
+                }
+              }
+            },
+            "V2": {
+              "props": {
+                "size": "sm",
+                "type": "secondary"
+              }
+            }
+          }
+        },
+        "container": {
+          "defaultVersion": "V1",
+          "versions": {
+            "V1": {
+              "props": {
+                "layout": "flex",
+                "direction": "row",
+                "gap": "medium",
+                "wrap": true
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/resources/guides/component.md

@@ -60,7 +60,10 @@ Doğrulama mesajını çeviriye bağlamak ayrı bir sözleşmedir (`t:` öneki,
   (`eventcalendar` · `importwizard` · `kanban` · `signature` · `stepper`) dolar — `kanban` ve
   `eventcalendar` yükü `self`'e HİÇ yazmaz, yalnız `event.data` ile okunur (ayrım
   `component_get` sözleşme notlarında).
-- Akış bağlama: `flow_create` → `page_schema_patch set_event`. İstisna: `html` komponentinin
+- Akış bağlama: `flow_create` → `set_event` (sayfada `page_schema_patch`, layout'ta
+  `layout_schema_patch`, widget'ta `component_schema_patch`). Akış isteği barındırıcının şemasını
+  yazmaz; bağ yalnız bu yamayla kurulur, silmede de önce `remove_event` sonra `flow_delete`.
+  İstisna: `html` komponentinin
   aksiyonları kendi `flow` prop'uyla bağlanır (`platform_guide('html')`).
 
 ## Stil
@@ -87,6 +90,9 @@ Widget, kendi komponent ağacını taşıyan yeniden kullanılabilir pakettir (`
    `elementId`'leri kullanır; Studio düzenleyicisinin gösterdiği `__widget__` yer tutucusu
    yalnız editör katmanıdır (kayıt anında gerçek id'ye çevrilir) — API'den yazarken yer
    tutucu KULLANMA.
+4. **Ağacı değiştirmek:** `component_schema_patch` (widget kaydının `id`'si) sayfa ile aynı
+   micro-op'ları `PATCH /components/{app}/{id}/schema`'ya yazar; `component_update` ise slug alan
+   tam gövde PUT'tur. Widget'ın düzey olayı yoktur, `remove_event` yalnız komponent hedefler.
 
 ## `states` ve `appearance` sözlükleri
 
@@ -117,7 +123,7 @@ Her şema düğümünde iki sözlük vardır; ikisi de ortak render katmanında
 | `widthType` | `cover` · `contain` · `auto` · `fixed` · `fill` | İlk ikisi görsel/medya sığdırma. Kalanı **flex (ve eski cssgrid) kabın çocuğunun genişlik modu** (2026-09-01): `auto` içerik kadar, `fixed` `widthString`'den, `fill` kabın tüm genişliği (satırda `flex:1 1 100%`, sütunda `align-self:stretch`). **Yazılmazsa eski 12 kolon `blocks.size.w` payı geçerlidir** — öncelik: `fill` > `fixed` > `auto` > span |
 | `widthString` / `heightString` | CSS uzunluğu | Sabit ölçü; **yalnız ilgili `*Type: 'fixed'` iken okunur** (aksi PAGE-017 uyarısı). Kabul: çıplak sayı (px sayılır) · `px % vw vh vmin vmax rem em ch` birimli değer · `calc(...)`. Negatif/`pt`/`fr`/`auto` GEÇMEZ — platform kaydeder ama panel ve runtime sessizce düşürür (PAGE-018). Eski `widthPx` alanı 2026-09-01'de kaldırıldı |
 | `marginType` / `marginValue` | `normal` · `none` · `custom` + px | Dış boşluk: **yazılmazsa `normal` sayılır** = her kenara 4px (`spacing.ts` `CANVAS_NORMAL_MARGIN`); custom=`marginValue`. Bileşenleri dip dibe dizmek için `none` ŞART — `gap:'none'` olsa bile normal margin komşular arasında 8px bırakır (sıkı dizilim tarifi: `platform_guide('page')` Kural 1f-2) |
-| `paddingType` / `paddingValue` | `normal` · `none` · `custom` + px | Droppable kapların iç boşluğu: normal=10px |
+| `paddingType` / `paddingValue` | `normal` · `none` · `custom` + px | İç boşluk: normal=10px. **Yalnız droppable kaplarda ve tipli stil modelindeki yapraklarda (box · text · container · statcard · icon · form) çizilir**; `slot`, kabuk kökleri (`layout`/`layout-shell`) ve `modal`/`drawer`/`auth-layout` hiç almaz — platform 200 döner, ekran değişmez (PAGE-029). Değerler piksel SAYISIDIR: `24`, `"24px"` değil (PAGE-030) |
 | `alignType` | `left` · `center` · `right` | İçerik hizalama (destekleyen komponentlerde) |
 | `aspectRatio` | sayı | En-boy oranı kilidi (medya komponentleri) |
 

package/dist/resources/guides/expressions.md

@@ -103,6 +103,7 @@ dalından devam eder.
 | `event` | `{name, data, source: {id, props}}` |
 | `cookie` | `cookie.get(name)` / `cookie.set(name, value, {expiresInHours, path})` / `cookie.remove(name)` — tarayıcı cookie'si |
 | `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 |
 | `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) |
@@ -130,6 +131,11 @@ prop `type: 'code'` olur, **ifade `ref` alanına `{{ }}` içinde** yazılır, `d
 değerini taşır:
 `"text": { "type": "code", "data": "Button text", "ref": "{{ state.page.MyTest.isActive ? 'Test' : 'FalseTest' }}" }`
 
+> **Prop'ta parantezsiz ifade METİNDİR (PAGE-032).** Akış adımındaki `value.type: 'code'`
+> ifadeyi doğrudan koşturur; prop'taki `code` ise bir şablondur ve yalnız `{{ }}` içini
+> çalıştırır. `"ref": "new Date().getFullYear()"` prop'a harfi harfine o metni yazar, hata
+> üretmez — `page_schema_patch` bu yüzden parantezsiz prop ifadesini reddeder.
+
 ## 3. Adım argümanlarında `value.type` çözümlemesi
 
 `microservice`/`setter` adımlarının `parameters[]`/`iteratees[]` değerlerinde:

package/dist/resources/guides/getting-started.md

@@ -140,7 +140,13 @@ koda baktığını gizlemek yerine raporlamak.
 - create/update → ilgili `*_get` ile geri oku
 - microservice → `microservice_execute`, beklenmedik sonuçta `microservice_debug`
 - workflow → `workflow_preview`; automation → `automation_trigger` + `automation_histories`
+- zamanlanmış iş (`schedule-job`) → ÖNCE `workflow_preview` / `microservice_debug` (rollback'li adım
+  izi), SONRA `microservice_schedule_control` `trigger` + `microservice_job_history`. Geçmiş
+  `failed` satırında patlayan adımı ve sebebini yazar ama adım izini vermez
+  (`platform_guide('microservice')` §Zamanlanmış işin gerçek sonucunu görmek)
 - "API 200 döndü" tek başına bitti saymaz; politika bulgularını (`policyFindings`) oku ve gereğini yap
+- Tool'un şemasında olmayan üst düzey argüman **reddedilir** ve hata okunan alanları listeler
+  (GW-005). Bir argüman kabul edildiyse gateway onu okuyor demektir.
 
 
 ## Yazdıktan sonra `silentlyDropped` alanına bak

package/dist/resources/guides/layout.md

@@ -12,22 +12,29 @@ kutusu layout modülünde süzülmez — tüm katalog kullanılabilir.
 
 **2. Şema alanının adı `schema` değil `views`.** (LAY-001)
 
-**3. Micro-op ucu yok, ama `PATCH /layouts/{app}/{id}` var.** `page_schema_patch`'in birebir
-karşılığı yoktur (`PATCH /layouts/.../schema` ucu yok); onun yerine platform genel bir JSON Patch
-ucu verir ve `layout_patch` onu kullanır: layout'u okur, JSON Patch'i ve kendi normalizasyonlarını
-uygular, doğrulamadan geçirir ve **farkı** `{ baseVersion, ops }` olarak yazar — tam gövde PUT'u
-atılmaz. Böylece tek bir başlık düzeltmesi için 12 düğümlük ağacı yeniden göndermezsin (ölçüm:
-09-04 koşusu Y-25). Yol İNDEKS yerine SEÇİCİ alır:
-`/views/0/children[elementId=baslik]/props/content/data`.
-
-**Sürüm ve 409.** Okunan kaydın `version` alanı `baseVersion` olarak gider. Sen okuduktan sonra
-başka biri yazdıysa platform **409** döner ve HİÇBİR op uygulanmaz; doğru tepki "aynı op'ları
-tekrar göndermek" değil, `layout_schema_get` ile yeniden okuyup patch'i güncel hâle göre kurmaktır.
-`version` bir **string**tir (mikrosaniye cinsinden zaman damgası, JavaScript'in güvenli tam sayı
-sınırının üstünde) — sayıya çevirme, olduğu gibi geri gönder. `expectedUpdatedAt` verirsen gateway
-ayrıca istek gitmeden önce yerel bir kontrol daha yapar. Tam ağacı kendin yazacaksan `layout_update`;
-`views` göndermezsen mevcut ağaç korunur. Okumak için `layout_schema_get` (summary kipi hedef bulmak
-için yeterlidir).
+**3. Ağaç değişikliği `layout_schema_patch` ile (2026-09-14).** Platform
+`PATCH /layouts/{app}/{id}/schema` ucunu verir ve sayfa ile **aynı** micro-op sözlüğünü konuşur:
+`add_component`, `remove_component`, `move_component`, `replace_prop`, `set_event`, `remove_event`,
+`resize_component`, `set_prop_type`, `reorder` ve diğerleri `page_schema_patch`'teki gibi yazılır.
+Dokunulan düğümler tam doğrulanır, geri kalan ağaç yapısal; istek atomiktir. Sayfadan farkları:
+
+- Kök ekleme `parent: 'root'`'a gider — layout'ta `page_container` yoktur.
+- `remove_event` `target: 'page'` layout düzeyi olayları hedefler.
+- `baseVersion` yoktur: son yazan kazanır. Hedefleri yazmadan hemen önce `layout_schema_get` ile oku.
+- Slot'u silen ya da ikinci slot ekleyen yama yazılır ama LAY-002 / LAY-006 uyarısı döner (Kural 4).
+- Bağı kalmayan akışı platform kalıcı siler; gateway böyle bir yamayı `allowFlowDeletion: true`
+  olmadan göndermez (G-21, sayfadakiyle aynı).
+
+Okumak için `layout_schema_get` (summary kipi hedef bulmak için yeterlidir); tam ağacı kendin
+yazacaksan `layout_update` (`views` göndermezsen mevcut ağaç korunur).
+
+**3a. `layout_patch` düz JSON Patch içindir.** Ad, `parameters`, `events` gibi ağaç dışı alanlar ya
+da yol gerektiren bir değişiklik için: layout'u okur, JSON Patch'i ve kendi normalizasyonlarını
+uygular ve **farkı** `PATCH /layouts/{app}/{id}`'ye `{ baseVersion, ops }` olarak yazar (09-04 koşusu
+Y-25). Yol İNDEKS yerine SEÇİCİ alır: `/views/0/children[elementId=baslik]/props/content/data`.
+Okunan kaydın `version`'ı `baseVersion` olarak gider; araya başka bir yazma girdiyse **409** döner
+ve hiçbir op uygulanmaz — doğru tepki `layout_schema_get` ile yeniden okuyup patch'i güncel hâle
+göre kurmaktır. `version` bir **string**tir (mikrosaniye zaman damgası) — sayıya çevirme.
 
 **4. TEK slot.** Sayfa şeması **her** slot'a ayrı ayrı kopyalanır — iki slot, sayfayı iki
 kez çizer ve `elementId`'leri tekrarlar. (LAY-002 / LAY-006)
@@ -92,6 +99,12 @@ container  isWrapper:true  heightType:'fill'  layout:'flex' direction:'row' gap:
   uçludur (`y / auto`), yani sayfa uzadıkça slot uzar.
 - **Kaydırma:** `fill` + `states.isScrollable:true` verilen düğüm büyümek yerine İÇİNDE
   kaydırır — uzun içerikte kabuğu sabit tutmanın yolu budur.
+- **Slot'un kenar boşluğu margin'dir, padding değil.** Slot droppable değildir; ona yazılan
+  `paddingType`/`paddingValue` hiçbir kutuya çizilmez (LAY-010). Her sayfanın kenardan uzak
+  durmasını tek yerden istiyorsan slot'a `appearance.marginType: 'custom'` + `marginValue: 24`
+  yaz — margin slot'un sarmalayıcısına iç boşluk olarak iner ve slot'un zemini olmadığı için
+  sonuç padding'le aynıdır. Studio iskeleti slot'a zaten 8px custom margin verir. Değer SAYIDIR
+  (`24`, `"24px"` değil — LAY-011). Her sayfaya sarmalayıcı container eklemek gerekmez.
 - **MOBİL UYARISI:** bu ağaç `flex` olduğu için telefonda YIĞILMAZ (Kural 7) — 375px'te yan
   menü ince bir şerite iner. Telefonda alt alta düşmesi gereken bir kabuk için kökü
   `layout:'grid'` kur; o zaman `fill`'in flex anlamı (`flex:1 1 auto`) devreye girmez,
@@ -135,7 +148,8 @@ bağlantı nesnesi ya da tam yol).
 ## Çeviri: header/sidebar etiketini anahtara bağlamak
 
 Layout'un `views` ağacındaki bir etiketi çeviriye bağlamak için **bütün ağacı yeniden yazma**.
-`layout_patch` `set_prop_type` micro-op'unu tanır ve prop'un tipini yerinde değiştirir:
+`layout_schema_patch`'in `set_prop_type` op'u prop'un tipini yerinde değiştirir (`layout_patch` de
+aynı op'u tanır ve JSON Patch ile karışık kabul eder):
 
 ```jsonc
 { "op": "set_prop_type", "target": "app_header_title", "prop": "content",
@@ -145,15 +159,11 @@ Layout'un `views` ağacındaki bir etiketi çeviriye bağlamak için **bütün a
 - Anahtar **`ref`'te** yaşar, `data`'da değil — runtime `data`'yı her turda çözümlenmiş değerle
   ezer. `ref` boşsa gateway isteği göndermeden reddeder.
 - Mevcut statik metin `data`'da yedek olarak KALIR, böylece Studio canvas'ında boş kutu görünmez.
-- `set_prop_type` ile JSON Patch aynı `ops` listesinde karışık verilebilir; micro-op'lar önce
-  uygulanır, sonra patch yolları çözülür.
-- Aynı op sayfa tarafında `page_schema_patch` ile çalışır — sözleşme birebir aynıdır. Anahtarları
-  `translation_list` ile bulun; fallback zinciri ve `t:` doğrulama mesajı sözleşmesi
-  `platform_guide('translation')`'da.
-
-> Layout'un diğer micro-op'ları YOKTUR: `add_component`, `remove_component`, `replace_prop` ve
-> arkadaşları yalnız sayfa hattındadır. Layout'ta düğüm eklemek/silmek için JSON Patch ya da
-> `layout_update` kullanılır.
+- `layout_patch`'te `set_prop_type` ile JSON Patch aynı `ops` listesinde karışık verilebilir;
+  micro-op'lar önce uygulanır, sonra patch yolları çözülür.
+- Aynı op sayfa tarafında `page_schema_patch`, widget'ta `component_schema_patch` ile çalışır —
+  sözleşme birebir aynıdır. Anahtarları `translation_list` ile bulun; fallback zinciri ve `t:`
+  doğrulama mesajı sözleşmesi `platform_guide('translation')`'da.
 
 ## Sayfayı layout'a bağlama