@appaflytech/zeyrek-ai-mcp 0.0.8 → 0.0.9

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
 

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

@@ -140,6 +140,10 @@ 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.

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)
@@ -141,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",
@@ -151,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
 

package/dist/resources/guides/microservice.md

@@ -121,7 +121,10 @@ servis formunda görünür ve `microservice_get` outline görünümünde geri ok
 
 5. **Doğrulama akışı:** `microservice_preview` (kaydetmeden) → kaydet → `microservice_execute`
    (gerçek runtime yolu) → sonuç beklenmedikse **aynı parametrelerle `microservice_debug`** —
-   adım adım executionItems ağacı döner.
+   adım adım executionItems ağacı döner. Zamanlanmış (`schedule-job`) uçta sıra farklıdır:
+   `workflow_preview` → `microservice_debug` → `microservice_schedule_control` `trigger` →
+   `microservice_job_history`; geçmişteki `completed` başarı kanıtı DEĞİLDİR (§Zamanlanmış işin
+   gerçek sonucunu görmek).
    Çağrı parametrelerini (sorgu parametresi, filtre değeri) üst düzey `parameters: { ad: değer }`
    ile ver; gateway GET'te query-string'e, POST/PUT'ta gövdeye koyar. Değeri NULL bağlanan query
    parametresini debug yanıtı `unboundParameters` ile söyler — ağaçta o satırın `value` anahtarı
@@ -690,6 +693,57 @@ Yeni işte tanımı `typeParameters.schedule` ile yazın ve kaydetmeden önce
   `cronExpression`'ı değiştiren PUT/PATCH `422 ScheduleCronConflict` alır — sessizce eski cron
   kalmaz. `typeParameters: null` işi zamanlayıcıdan siler.
 
+### Zamanlanmış işin gerçek sonucunu görmek: geçmiş `failed` yazar, adım izini önizleme verir
+
+Zamanlanmış koşu Quartz işi `MicroserviceJob` içinde koşar: `ExecuteAsync(microservice, BOŞ
+parametre)`. 2026-09-16'dan beri iki hata yolu da geçmişe `failed` olarak düşer ve transaction geri
+alınır:
+
+| Geçmişte görünen | Gerçekte olan |
+|---|---|
+| `failed`, `errorMessage: "Step 'boom' failed: <sebep>"` | fail dalı bağlanmamış adım patladı; motor `WorkflowStepFailedException` fırlattı |
+| `failed`, `errorMessage: "The job's workflow returned 500 (JavaScriptException): <mesaj>"` | akış bağlı global-error dalından (gateway'in eklediği `gatewayOnError` dâhil) 2xx dışı sonuç döndü; `MicroserviceJob` `ScheduleJobWorkflowFailedException` fırlattı |
+| `failed`, başka mesaj | motor dışı exception: tanım/cache hatası, sonsuz döngü, canlı `revert`, DTO davranış uyumsuzluğu |
+| `completed`, beklenen süre | akış 2xx ile bitti, yazmalar commit edildi — kalıcı etkiyi yine `row_list` ile say |
+| satır yok | koşu veto edildi (deployment/şablon kurulumu sürüyor) ya da zamanlayıcıda kayıt yok — `microservice_schedule_get` |
+
+Eski davranış (2026-09-16 öncesi imaj): adım hatası exception değildi; geçmişe `completed` + kısa
+süre + boş `errorMessage` yazılır, yazmalar commit edilirdi — "90 ms'de tamamlandı ama hiçbir şey
+yapmadı". Karşındaki platform hâlâ bunu yapıyorsa imaj eskidir.
+
+Dört gerçek daha:
+
+- **Geçmiş satırı `{ status, triggeredAt, completedAt, durationMs, errorMessage }`'dan ibarettir.**
+  Mesaj patlayan adımı ve sebebini söyler ama adım adım girdi/çıktı vermez; son koşunun adım izini
+  döndüren bir MCP aracı **yoktur** (açık backend işi P-19c). Adım izi için aynı tanımı önizlemede
+  koştur.
+- **Zamanlanmış koşunun bağlamı boştur:** girdi yok (`MicroserviceExecuteParameter.Create()`),
+  middleware koşmaz (`user` yok), `request` yok, `context`/`triggerSource` kurulmaz. Akış
+  `input.x`, `user.id`, `request.*`, `context.language` okuyorsa zamanlanmış koşuda hepsi
+  `undefined`'dır — önizlemede geçen akış bu yüzden zamanlayıcıda patlayabilir.
+- `microservice_schedule_get` içindeki `lastExecution` aynı geçmiş satırıdır.
+- Geçmiş mesajları resx varsayılanıyla (İngilizce) yazılır; iş iş parçacığında istek dili yoktur.
+
+**Sıra — tetiklemeden önce gör** (Studio'daki akış "Önizleme"si + servis önizlemesinin MCP karşılığı):
+
+1. **Akışı `workflow_preview` ile koştur** (`platform_guide('workflow')` §Önizleme çıktısını
+   okumak): `workflow_get` gövdesini olduğu gibi ver, **`previewPayload` VERME** — iş girdisiz
+   koşar, önizleme de girdisiz koşsun. Akış `parameterDtoId` taşıyorsa zamanlanmış koşuda DTO boş
+   bağlanır; zorunlu alanı olan DTO'yu zamanlanmış akışa bağlama. Hata varsa `runtimeErrors` +
+   `steps[].hasError` / `errorMessage` / `input[]` patlayan adımı ve sebebini verir.
+2. **Kayıtlı ucu `microservice_debug` ile koştur:**
+   `{ application: '<app slug>', microservice: '<uç slug>', method: 'POST' }` — schedule-job için
+   de slug yolu çalışır (tip denetimi yok), rollback'lidir, `httpStatus` akışın kendi sonucudur
+   (4xx/5xx'te gateway `runtimeErrors` ekler) ve `executionItems` ağacı adım adım girdi/çıktıyı
+   verir. Düğümlerde hata bayrağı yoktur: patlayan adımın `output`'u boştur, hata gövdesi hata
+   dalındaki response adımının çıktısındadır. Fark: debug ucun middleware'lerini de koşturur,
+   zamanlayıcı koşturmaz.
+3. **`microservice_preview({ id })`** en kısa "geçer mi" sondasıdır: yanıt `httpStatus` + gövdeden
+   ibarettir, adım ağacı DÖNMEZ (`executionItems` yalnız `/debug/` yolunda).
+4. Ancak sonra `microservice_schedule_control` `trigger` → `microservice_job_history`. `failed`
+   ise mesaj patlayan adımı ve sebebini söyler; adım adım girdi/çıktı gerekiyorsa 1-2'ye dön.
+   `completed` ise kalıcı etkiyi `row_list` ile say.
+
 ## Sık hatalar
 
 - `description` boş (MS-014, block — uç listesinde ne işe yaradığı okunamaz)

package/dist/resources/guides/page.md

@@ -83,7 +83,8 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
   (applier `code` ve `translation` sarmalını tipiyle korur; gateway 2026-09-15'e kadar translation
   sarmalını reddediyordu) ya da
   `{ op: 'set_prop_type', target: '<elementId>', prop: 'content', propType: 'translation', ref: 'dashboard.kpi.total' }`
-  (gateway emülasyonu; mevcut `data`'yı tasarım yedeği olarak taşır). Taşıyıcı alan tipe göre
+  (platformun kendi op'u — 2026-09-14'e kadar gateway emülasyonuydu — ve yamanın geri kalanıyla
+  aynı PATCH'te gider; mevcut `data`'yı tasarım yedeği olarak taşır). Taşıyıcı alan tipe göre
   değişir — `static` değeri `data`'da, `code` ve `translation` `ref`'te taşır; eksik taşıyıcı istek
   gönderilmeden reddedilir ve `page_schema_validate` aynı kararı verir. Eski yol
   `remove_component` + `add_component` idi: 2026-09-06 koşusunda on bir etiket bu yolla kuruldu ve
@@ -91,16 +92,19 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
   `daterangepicker` yer tutucusunu çeviriye bağlarken tekrarlandı — setter hedefi elementId değil
   komponentin iç kimliğidir (aşağıda Kural 2, `FLOW-018`).
 
-- **`blocks[].size`, komponentin `component_get`'teki `maxSize`'ını aşamaz.** Dikkat: katalog
-  varsayılanı aşabiliyor (`page-header` default `h:8`, `maxSize` `h:4`) — varsayılanı körü körüne
-  kopyalama, doğrulayıcı `"Height of 'page-header' must be between 1 and 4."` ile reddeder.
+- **`blocks[].size`'ı komponentin `component_get`'teki `minSize`..`maxSize` aralığında tut.** Dikkat:
+  katalog varsayılanı aşabiliyor (`page-header` default `h:8`, `maxSize` `h:4`) — varsayılanı körü
+  körüne kopyalama. Sınır grid kanvasının kuralıdır; API 2026-09-15'ten beri reddetmez, ama aşan
+  blok kanvasta boyutlandırılamaz (aşağıda Kural 7 "Boyut tuzağı").
 - **Kurulmuş bir düğümün boyutunu `resize_component` micro-op'u değiştirir.**
   `{ op: 'resize_component', target: '<elementId>', size: { w, h } }` ızgara boyutunu,
   `{ …, appearance: { heightType: 'fixed', heightString: '340px' } }` flex ölçüsünü yazar; ikisi
-  aynı op'ta verilebilir, `breakpoint` varsayılanı 1024'tür. Bu bir **gateway emülasyonudur**:
-  platformun micro-op sözlüğünde boyut yoktur ve `move_component` gövdesine konan `size` 200 dönüp
-  SESSİZCE düşer (bu yüzden gateway artık onu reddeder ve buraya yönlendirir). Op şemayı okuyup
-  sayfayı tam gövdeyle geri yazar. Ebeveynin düzeni yazdığın alanı etkisiz kılıyorsa (flex kabın
+  aynı op'ta verilebilir, `breakpoint` varsayılanı 1024'tür. Gateway op'u platformun
+  `set_block {target, breakpoint, size}` + `set_appearance {target, appearance}` +
+  `set_states {target, states}` op'larına çevirir ve yamanın geri kalanıyla **aynı PATCH'te** yollar
+  (o üç op'u doğrudan da gönderebilirsin). `move_component` gövdesine konan `size` gateway'de
+  reddedilir ve buraya yönlendirir; konumu belirli bir breakpoint'e yazmak için
+  `move_component`'e `breakpoint` ver. Ebeveynin düzeni yazdığın alanı etkisiz kılıyorsa (flex kabın
   içine `size`, ızgaranın içine `appearance`) yanıt `PAGE-019` uyarısı taşır — istek yine geçer.
   **Düğümü silip yeniden kurmayın:** o yol ona yazan akış setter'larını sessizce öldürür
   (`FLOW-018`, aşağıda Kural 2).
@@ -166,8 +170,10 @@ uymayan adı **PAGE-008** ile istek gitmeden reddeder.
 **Olay KALDIRMAK için `remove_event` kullan.** Platformun `set_event` micro-op'u olay silemez:
 `eventValue: null` verildiğinde kayıt `{ name: 'click' }` olarak (değersiz) kalır, diziden
 çıkmaz — şemada ölü bağ artığı bırakır. `{ "op": "remove_event", "target": "<elementId>",
-"event": "click" }` gateway emülasyonudur: şemayı okur, olayı diziden çıkarır ve sayfayı tam
-gövdeyle geri yazar (yanıtta `removedEvents`). Sayfa düzeyi olaylar için `target: "page"`.
+"event": "click" }` platformun op'udur: olayı diziden çıkarır (yanıtta `removedEvents`); olmayan
+bir olayı kaldırmaya çalışmak `missing-event` ile 422 döner. Sayfa düzeyi olaylar için
+`target: "page"`. Referanssız kalan akış silineceği için `allowFlowDeletion` kuralı (G-21) bu op'ta
+da geçerlidir.
 
 **Olay YÜKÜ komponente özeldir ve `component_get` onu da veriyor** (`events[].payload`, gerekirse
 `events[].reads`) — **ama yük akışa `event.data` ile GELMEZ.** Motor emit'in `data`'sını önce
@@ -610,8 +616,8 @@ Türkçe başlık `props.title` / `props.text` / `props.label` / `props.pageTitl
 > `elementId` ile eşit tutmazsan `element:` alanı çalışır ama ifadedeki değişken `undefined` kalır.
 >
 > Gateway bunu **PAGE-009** ile HER sayfa ve layout yazma yolunda istek gitmeden reddeder:
-> `page_create`, `page_update(schema)`, `add_component`, `layout_create`, `layout_update(views)`
-> ve `layout_patch`.
+> `page_create`, `page_update(schema)`, `add_component` (sayfa, `layout_schema_patch` ve
+> `component_schema_patch` yamalarında), `layout_create`, `layout_update(views)` ve `layout_patch`.
 
 ## Kural 1d — Sayfa iskeleti: `page_container` ve boyutlandırma
 
@@ -1051,8 +1057,9 @@ UYGULAMAZ** — koordinatları aynen kaydeder (aşağı itme yalnız `page_creat
 >   (iç repeater bir kez `item` olmadan da değerlendiriliyor).
 >
 > **Gateway bunu `PAGE-013` ile istek gitmeden reddediyor** — `page_create` / `page_update(schema)` /
-> `layout_create` / `layout_update(views)` / `layout_patch` gönderilen ağaca, `page_schema_patch` hem
-> eklenen alt ağaca hem op'lar UYGULANDIKTAN SONRAKİ ağaca bakarak. Layout'ta da geçerlidir: kırılma
+> `layout_create` / `layout_update(views)` / `layout_patch` gönderilen ağaca; `page_schema_patch`,
+> `layout_schema_patch` ve `component_schema_patch` hem eklenen alt ağaca hem op'lar UYGULANDIKTAN
+> SONRAKİ ağaca bakarak. Layout'ta da geçerlidir: kırılma
 > `_repeaterValues` geri yazmasındadır, barındıranın sayfa mı layout mu olduğuna bakmaz.
 >
 > **Yapılacak:** satır içi listeyi tek bir `textarea`'da **satır başına bir öğe** olarak topla
@@ -1081,6 +1088,12 @@ yapmanın yolu budur — ölçülmüş kurallar (anket-doldur, 2026-08-19):
 > Bu kural TEMA/GÖRSELLİK içindir. Çocukların dizilimi (ortalama, yaslama, aralık, "kalanı
 > doldur") `style` ile değil kapsayıcının kendi `layout` prop grubuyla kurulur — Kural 1f-2.
 
+> **ÖNCE PROJE TEMASI.** Bir markayı uygulamanın birinci yolu `theme_update`'tir
+> (`platform_guide('theme')`): tema kaydı BÜTÜN sayfalara iner, `theme_get(view:'resolved')`
+> hangi değişkenin hangi değeri aldığını söyler. Aşağıdaki `page_container.style` yöntemi
+> yalnız O SAYFAYA özgü sapma içindir — her sayfada tekrarlanan bir ezme, temaya taşınmamış
+> bir karardır.
+
 > **Stil anahtarları camelCase'dir: `minHeight`, `fontSize`, `letterSpacing`.** Kebab-case anahtar
 > (`min-height`) platform tarafından KABUL EDİLİR, `page_schema_get` ile aynen geri okunur ve
 > runtime onu HİÇ UYGULAMAZ; tek işaret tarayıcı konsolundaki tek satırdır ve `page_screenshot`
@@ -1141,6 +1154,8 @@ işareti taşıyan input'un **sonraki kardeşini** boya (`&__item-input:checked
 ### 1h-2 — Tema değişkeni envanteri (`Theme.svelte`, tamamı)
 
 Bunlar **runtime'da her sayfada tanımlıdır**; `style` içinde yeniden tanımlayarak eziyorsun.
+Bir projedeki GÜNCEL değerleri (ve buradaki listenin tamamını) `theme_get(view:'resolved')`
+`cssVars` alanından okursun — aşağıdaki tablo kümeleri anlatır, değerleri değil.
 Varsayılan palet `white.ts` (accent `#0052CC`, border `#dfe1e6`, text `#262626`) — yani hiçbir şey
 yapmazsan ekran "platform mavisi" görünür; marka rengine çevirmek tek satırdır.
 
@@ -1266,8 +1281,9 @@ kaldırır); sayı `0` "seçilmedi" sayılır.
 tipli grup alanları temayı alan alan EZER; düğümün serbest `style`'ı en üstte SON SÖZDÜR.
 Boyut alanları CSS uzunluğu metnidir (`'18px'`, `'1.2em'`); `radius` tek alanda preset
 anahtarı YA DA CSS uzunluğu kabul eder.
-**Tema preset'i bağlamak:** `style: { $preset: 'card' }` (adlar `project_get` → `theme.presets`;
-`componentStyles[type]` referanssız uygulanır). Bir alanı temaya bırakmak = o alanı hiç yazmamak;
+**Tema preset'i bağlamak:** `style: { $preset: 'card' }` (adlar `theme_get` → `presets`, sayfa
+bağlamında `page_runtime_get` → `theme.presets`; `componentStyles[type]` referanssız uygulanır).
+Preset'in kendisini yazmak/silmek `theme_update` işidir — `platform_guide('theme')`. Bir alanı temaya bırakmak = o alanı hiç yazmamak;
 studio'da bunun adı "Temaya dön"dür. Tema değerini gruba kopyalama — bağ kopar, tema değişince izlemez.
 
 **Efektif stili okumak:** `page_runtime_get(resolveStyles: true)` her düğüme `resolvedStyle`
@@ -1320,12 +1336,14 @@ dokunuldu" sorusunun kanıtı) ve **`newVersion`** (`UpdatedAt.Ticks`).
 > yamadan sonra şemayı okuyup gönderdiğinle karşılaştırarak söyler. Kırpma bu yüzden kanıt kaybı
 > değildir; `view: 'full'`e yalnız gerçekten platformun ham gövdesini incelerken düş.
 
-**Sürüm kontrolü platformda var ama gateway bugün KULLANMIYOR.** Platform gövdede `baseVersion`
-(long tick) kabul eder ve tutmazsa 409 verir; `page_state.baseVersion` bu değeri döner.
-`page_schema_patch` bu alanı geçirmez — bayat plan koruması gateway tarafında
-`expectedUpdatedAt` ile yapılır: sayfa okunur, `audit.updatedAt` karşılaştırılır, tutmazsa istek
-hiç gönderilmez. Bu kontrol **iki çağrı arasına başka bir yazar girerse yakalamaz**; gerçek
-korumayı isteyen ham HTTP ile `baseVersion` göndermelidir.
+**Sürüm kontrolü `baseVersion` ile yapılır.** `page_schema_get` yanıtı `version` taşır (mikrosaniye,
+STRING — sayıya çevirme); `page_schema_patch`'e `baseVersion` olarak ver. Sayfa o sürümden beri
+değiştiyse platform **409** döner ve hiçbir op uygulanmaz; yanıttaki `newVersion` bir sonraki
+yamanın `baseVersion`'ıdır. Kontrol platformda atomiktir (satır kilidi + sürüm koşulu tek
+`UPDATE`'te), yani iki çağrı arasına giren yazarı da yakalar. `baseVersion` vermezsen gateway yalnız
+bu çağrıda zaten okuduğu sayfanın sürümünü gönderir; hiç okumadıysa yama sürümsüz gider ve son
+yazan kazanır. Eski `expectedUpdatedAt` hâlâ çalışır ama `baseVersion`'ın yerini tutmaz.
+Yanıttaki `touched`, kaydı değişen elementId'leri listeler (eklenen alt ağaç dâhil).
 
 > **Büyük şemada çalışma sırası:** `mode:'summary'` ile ağacı çıkar (props yok, 500 KB'lık sayfada
 > bile küçük) → hedefin `elementId`'sini al → gerekiyorsa `mode:'subtree'` ile yalnız o dalı oku →
@@ -1340,14 +1358,15 @@ korumayı isteyen ham HTTP ile `baseVersion` göndermelidir.
 > `set_event` ile bağla ya da `flow_get` ile gövdesini yedekle. Ayrıntılı analiz:
 > `PatchPageSchemaCommandHandler` (backend) — kilit, sürüm ve hep-ya-hiç davranışının kaynağı.
 
-## Kural 3 — Flow yazımı barındırıcıyı da günceller
+## Kural 3 — Flow yazımı yalnız akışı yazar, bağ ayrı yamadır
 
-Platform `flow` uçlarında gövdede hem akışı hem barındırıcının tam güncelleme komutunu ister
-(`{ flow, page | layout | component }`) — şemadaki `events[].value` = flow id bağı tek işlemde
-tutarlı kalsın diye. **Silme bile gövdelidir.** Gateway barındırıcıyı okuyup gövdeye kendisi
-koyar; sen yalnız akışı verirsin.
+2026-09-14'ten beri `flow_create` / `flow_update` / `flow_delete` barındırıcının şemasına
+**dokunmaz**: gövde yalnız akıştır (silmede yalnız `id`). Eskiden gateway barındırıcının tam
+güncelleme komutunu da gönderiyordu; bu, her akış yazmasında sayfayı, layout'u ya da widget'ı
+baştan yazıyor ve açık bir Studio designer'ının kayıtlı tabanını eskitiyordu.
 
-Akışı bir komponente bağlamak ayrı adımdır:
+Akışı bir komponente bağlamak ayrı adımdır ve akış kaydedildikten **sonra** yapılır (layout'ta
+`layout_schema_patch`, widget'ta `component_schema_patch`, op'lar aynı):
 
 ```
 flow_create(host:'page', hostId:<pageId>, name:'Save order', slug:'save-order', steps:[…])
@@ -1389,18 +1408,13 @@ Sonradan akış eklemen gerekirse sayfayı baştan kurmana gerek yok — **bağ
 `eventValue: null` olay kaydını bırakıp değerini boşaltır ve kilidi açar.
 
 > **Aynı kilit LAYOUT'ta da vardır** (ölçüm 2026-08-18: menüye yeni bağlantı eklerken
-> `POST /layouts/<id>/flows` aynı hatayı verdi). Layout'un olayları komponentin kendi `events`
-> dizisinde satır içidir (`{ "name": "click", "value": "<flow id>" }`) ve `page_schema_patch`
-> layout'a uygulanmaz; çözüm de bu yüzden farklı yazılır:
->
-> ```
-> 1) layout_update  → tüm komponentlerde "events": []   (bağları çöz)
-> 2) flow_create × N
-> 3) layout_update  → tam ağaç + bütün events'ler
-> ```
+> `POST /layouts/<id>/flows` aynı hatayı verdi). Layout'ta sıra sayfadakiyle aynıdır ve bağlar
+> `layout_schema_patch` ile yazılır: `flow_create × N` → TEK `layout_schema_patch` (bütün
+> `set_event`'ler). Sıfırdan kurarken kilide takılmazsın (akışları bağlamadan önce yaratırsın).
 >
-> Sıfırdan kurarken kilide takılmazsın (akışları bağlamadan önce yaratırsın); kilit yalnız
-> **mevcut ve bağlı** bir layout'a yeni akış eklerken çıkar.
+> **Yeniden ölçülmeli (2026-09-14):** iki ölçüm de flow isteğinin barındırıcıyı baştan yazdığı
+> dönemdendi. Zarfsız istekte barındırıcı yazılmadığı için kilit kalkmış olabilir; ölçülene kadar
+> kuruluş sırasını koru.
 
 ## Kural 4 — Komponent güncellemesi slug ile, silme id ile
 
@@ -1587,9 +1601,11 @@ de silip yeniden ekleme gerekmez:
 { "op": "set_appearance", "target": "box_summary", "appearance": { "heightType": "auto", "tooltip": null } }
 ```
 
-Op **birleştirir**: yalnız verilen alanları yazar, gerisini korur; `null` alanı temizler. Alan
-adları `page_schema_get`'in döndürdüğü appearance anahtarlarıdır; bilinmeyen alan
-`unknown-appearance-field`, tanınmayan enum değeri (`heightType: "tall"`) 400 ile reddedilir.
+Op **birleştirir**: yalnız verilen alanları yazar, gerisini korur; `null` alanı temizler (null
+kabul etmeyen `heightType` gibi alanlar hariç). Alan adları `page_schema_get`'in döndürdüğü
+appearance anahtarlarıdır; bilinmeyen alan `unknown-appearance-field`, tanınmayan ya da null
+kabul etmeyen değer (`heightType: "tall"`) `invalid-appearance` ile 422 döner ve yama atomik
+olduğu için hiçbir op yazılmaz. Kurulu düğümün `states` bayrakları için eşi `set_states`'tir.
 **`isHidden` bir appearance alanı DEĞİLDİR** — gizlemek için `replace_prop { prop: 'isHidden' }`
 ya da `set_binding { prop: 'isHidden' }` (Kural 7a'daki `isHidden` notu).
 
@@ -1833,8 +1849,9 @@ Komponentlerin **`style` prop'u** vardır ve iç parçalara iner (`textinput.sty
 `&__body`). Tasarım kararlarını buradan uygula — varsayılan görünümle bırakmak zorunda değilsin.
 
 > **Boyut tuzağı:** katalog varsayılan `size`'ı `maxSize`'ı aşan komponentler var
-> (`textinput` default `h:8`, `maxSize.h:5`). Varsayılanı körü körüne kopyalarsan doğrulayıcı
-> reddeder; gateway aşan değeri `maxSize`'a kırpar ve `gatewayNormalized` ile bildirir.
+> (`textinput` default `h:8`, `maxSize.h:5`). Boyut sınırı grid kanvasının kuralıdır, API
+> reddetmez; ama aşan blok kanvasta boyutlandırılamaz. Gateway aşan değeri `maxSize`'a kırpar ve
+> `gatewayNormalized` ile bildirir.
 
 ## Kural 8 — Korunan sayfa: `middlewareIds` vermeden `Page.user` YOKTUR
 
@@ -1895,6 +1912,32 @@ hiçbiri** bağlı değildi; üç portalın da rol menüsü boş çıkıyor, pan
 > `Host: <org>.<suffix>` + `X-Environment` başlıklarıyla. Ham `curl` yerine tool'u kullanmak
 > yeterlidir.
 >
+> **Kareyi GÖRMEDEN doğrulamak — önce bunu dene.** `page_screenshot` her yanıtta `summaryText`
+> döner: her kök düğüm için tek satır — kimlik (tip) · görünür/GİZLİ/ekran dışı · metnin ilk 80
+> karakteri · `rows=<satır>` · `tab=<açık sekme>` · `value=<kutudaki değer>` · `BOŞ` ·
+> `errors=<sayı>`, sonda toast ve hata mesajları. "Kart göründü mü, tablo doldu mu, hata var mı"
+> sorularının cevabı budur ve **kareye gerek yoktur**: `image: 'none'` ile kare hiç çekilmez.
+> Ölçüldü (2026-09-16, 40 satırlık tablo taşıyan sayfa): özet **416** karakter, aynı sayfanın
+> `fullPage` karesi **151 276** karakter. Görsel soru (renk, hizalama, referansa sadakat) için
+> kareyi al ama küçült: `clip: { element: '<elementId>' }` yalnız o bölgeyi keser, `scale: 0.5`
+> rasteri yarıya indirir (sayfa yine 1280 CSS pikselinde çizilir — kırılım noktaları kaymaz),
+> `format: 'jpeg'` + `quality: 60` ölçekle BİRLİKTE kazandırır (tek başına neredeyse hiç).
+> Aynı sayfayı yeniden koştururken `diff: true` neyin değiştiğini listeler ve
+> `image: 'ifChanged'` değişmemiş kareyi hiç göndermez. `summary: 'full'` yapısal `domSummary`
+> dizisini de verir; runtime `data-component-type` basmıyorsa tipler yazılmaz ve `summaryNote`
+> bunu söyler.
+>
+> **Sekme, açılır kutu, form.** `actions` sözlüğünde üç fiil daha var.
+> `{ action: 'tab', target: 'tabs_settings', value: 'iot' }` sekmeyi ANAHTARIYLA seçer — sekme
+> grubunun köküne `click` göndermek DOM sırasındaki İLK sekmeye gider ve bu yüzden artık
+> reddedilir. **Etkin olmayan sekmenin içeriği DOM'da yoktur**: o sekmedeki bir düğüme yazmadan
+> ya da onu kırpmadan önce `tab` adımı koy. `{ action: 'select', target: 'dd_city', value: '34' }`
+> açılır kutudan seçer (kutu native alan değildir; `set` de aynı yola devreder) ve seçenekler
+> sorgudan geliyorsa listeyi 3 sn'ye kadar bekler — `optionsSeen: 0` görürsen kusur kutuda değil
+> sorgudadır, `query_preview` ile bak. `{ action: 'submit', target: 'frm_note' }` formu gönder
+> butonu olmadan gönderir. Her adımın raporu `matchedBy` · `activeTab` · `optionsSeen` ·
+> `waitedMs` · `submitVia` ile ne olduğunu söyler.
+>
 > **Yerleşimi görüntüsüz ölçmek.** Taşma/çakışma şüphesinde `page_screenshot(layoutReport: true)`:
 > `layoutSummary.overflowing` boş değilse içeriğine sığmayan kutu, `outsideViewport` boş değilse
 > hiç görünmeyen düğüm var; `zeroSized` çizilmemiş komponenti gösterir. Runtime düğümleri