@appaflytech/zeyrek-ai-mcp 0.0.8 → 0.0.9

package/dist/resources/guides/theme.md

@@ -0,0 +1,210 @@
+# Tema Rehberi (proje düzeyi tasarım)
+
+Bir projenin rengi, yazı tipi, köşe/boşluk ölçekleri, gölgesi ve yeniden kullanılan stilleri
+**tek bir kayıtta** yaşar: `projects.theme`. Runtime onu her sayfada `--ng-*` CSS
+değişkenlerine çevirir, yani temayı değiştirmek bütün ekranları birden değiştirir.
+
+Okuma `theme_get`, yazma `theme_update`. Studio'nun tema paneli de aynı kaydı yazar — MCP'den
+yazdığınızı panel açar, panelin yazdığını MCP okur.
+
+**Tema PROJE kaydıdır, ortam kaydı değil.** `environment` parametresi yoktur: yazma o an
+projenin bütün ortamlarının runtime'ına iner (development de production da). Sayfa/entity
+yazmalarının aksine burada "önce development'ta dene" diye bir ayrım YOKTUR.
+
+## Veri modeli
+
+`theme_get(view:'raw')` kaydın kendisini, `view:'resolved'` ekrana inen hâlini verir.
+
+| Alan | Ne yapar | Ürettiği değişken(ler) |
+|---|---|---|
+| `mode` | `'light'` (varsayılan) \| `'dark'` — yayınlanan uygulamanın modu | palet tabanını seçer |
+| `palette` | AYDINLIK moddaki renk override'ları | `--ng-accent-*` · `--ng-background-*` · `--ng-text-*` · `--ng-border-*` · `--ng-status-*` |
+| `paletteDark` | KARANLIK moddaki renk override'ları | aynı küme |
+| `fontFamily` · `headingFontFamily` | Gövde ve başlık yazı tipi (Google Fonts adı) | `--ng-font` · `--ng-font-heading` |
+| `fontSize` · `fontWeight` | Taban punto ve ağırlık | `--ng-font-size` · `--ng-font-weight` |
+| `typeScale` | Metin seviyelerinin tabana ORANI (h1…small) | `--ng-font-size-h1` … `-small` (+ `-mobile`) |
+| `spacing` · `spacingScale` | Taban boşluk ve kademe oranları | `--ng-spacing` · `--ng-spacing-xs..xl` |
+| `borderRadius` · `radiusScale` | Taban köşe ve kademeler (`pill` sabit uzunluk) | `--ng-rounded` · `--ng-radius-sm/md/lg/pill` |
+| `shadow` | Tek gölge tarifi (offset/blur/spread/color/opacity) | `--ng-shadow-sm/md/lg` |
+| `defaultInputSize` | Form girdilerinin varsayılan boyu (`sm`/`md`/`lg`) | `--ng-form-default-size` |
+| `colors` | Renk RAMPALARI (aile → ton) | `--ng-blue-500`, `--ng-grey-200` … |
+| `actions` | Grafik/veri görselleştirme serisi renkleri | `--ng-action-blue` … |
+| `presets` | **Adlı stiller** — düğümden `style.$preset` ile çağrılır | CSS değişkeni üretmez |
+| `componentPresets` | Bir TİPİN yeni düğümlerde başlayacağı prop varsayılanları | CSS değişkeni üretmez |
+| `componentStyles` | **EMEKLİ** — tipin her örneğine canlı uygulanan stil | CSS değişkeni üretmez |
+
+**Yalnız SAPAN değer yazılır.** `typeScale`, `radiusScale`, `spacingScale` ve `actions`
+kayıtta yalnız varsayılandan farklı olan kademeleri/renkleri taşır; dokunulmayan kademe
+platformun varsayılanını İZLEMEYE devam eder. Hepsini birden yazmak onları o günkü değerlere
+dondurur — yazmayın.
+
+Değişkenlerin tam listesi ve o projedeki değerleri: `theme_get(view:'resolved')` → `cssVars`
+(~190 giriş). Bir sayfada tek seferlik sapma için `platform_guide('page')` Kural 1h.
+
+## Karar kuralları
+
+**1. Önce tema, sonra preset, en son düğüm stili.** Aynı görünüm üç yerden verilebilir ve
+sırası bellidir: projenin tamamı için tema token'ı (`theme_update`), tekrar eden bir kalıp için
+adlı preset (`presets` + `style.$preset`), yalnız o düğüme özgü karar için düğümün kendi
+`style`'ı. Sabit hex yazmak yerine `var(--ng-accent-primary)` yazmak, düğümü temaya BAĞLI
+tutar.
+
+**2. Marka rengi tek çağrıdır.** `theme_update({ palette: { accent: { primary, hover } } })`
+sayfadaki her butonu, odak halkasını, seçili satırı ve grafik serisini birden çevirir. Komponent
+komponent stil yazmak hem uzun sürer hem yeni komponent eklendiğinde tutarsızlık üretir.
+
+**3. "Her X böyle görünsün" ile "yeni X şöyle başlasın" AYRI şeylerdir.**
+
+| İstek | Yol | Mevcut düğümlere etkisi |
+|---|---|---|
+| Her kart aynı yüzeyi paylaşsın | `presets.kart` + düğümde `style.$preset: 'kart'` | Bağlı olanların hepsi anında değişir |
+| Yeni bırakılan her button `lg` olsun | `componentPresets.button` | **YOK** — yalnız bundan sonra kurulanlar |
+| (emekli) Her button kalın olsun | `componentStyles.button` | Studio paneli ilk kayıtta bunu `componentPresets`'e taşır ve canlı bağ kopar |
+
+`componentPresets` bir KASKAD DEĞİL, başlangıç değeridir: değerler düğüm kurulurken prop'lara
+yazılır ve `style.$componentPreset` yalnız "hangi versiyondan geldi"yi anar. Temada versiyonu
+sonradan değiştirmek o düğümleri güncellemez.
+
+**4. Koyu mod ayrı bir palettir ve proje `light` olsa da devreye girebilir.** Karanlıkta
+runtime `paletteDark`'a bakar, `palette`'e değil. İki ayrı durum aynı sonucu verir:
+
+- Kaydın kendisi `mode: 'dark'` ve yalnız `palette` yazılmış → renkler hiç görünmez.
+- Kayıt `mode: 'light'` ama **ZİYARETÇİ** koyu moda geçmiş (`theme-toggle` komponenti,
+  tarayıcıda kalıcı; `page_screenshot(colorScheme: 'dark')` aynı yolu kullanır) → yine
+  `paletteDark` okunur ve markanız yerine platformun kendi koyu paleti çizilir.
+
+Ölçüldü (2026-09-15): yalnız `palette` yazılmış bir projede aydınlık kare markanın indigo'sunu,
+koyu kare platformun `#4C8DFF` mavisini gösterdi. **Uygulama koyu modda açılabiliyorsa
+`paletteDark` da yazılır** — THEME-009 bunu her iki durumda da uyarır.
+
+**5. Yazmadan önce `dryRun`.** `theme_update(dryRun: true, …)` hiçbir şey yazmadan hangi
+yolların değişeceğini (`changed`) ve hangi CSS değişkeninin hangi değerden hangi değere
+gideceğini (`cssVarsChanged`) söyler. Bir rengin türetilmiş etkisini (odak halkası, grafik
+serisi, kontrast metin) görmenin en ucuz yolu budur.
+
+**6. Kısmi yaz, `unset` ile sil.** `theme_update` verdiğiniz alanları mevcut kayda DERİN
+birleştirir: bir rengi değiştirmek preset'leri düşürmez. Silmek `null` yazmakla değil
+`unset: ['presets.kart']` ile olur; kaydın tamamını değiştirmek `replace: true` ister.
+
+## Tarifler
+
+**Marka paleti (aydınlık + karanlık):**
+
+```jsonc
+theme_update({ theme: {
+  palette:     { accent: { primary: "#4F46E5", hover: "#4338CA" } },
+  paletteDark: { accent: { primary: "#818CF8", hover: "#A5B4FC" } }
+} })
+```
+
+**Yazı tipi ve ölçek:** `fontFamily` panelin Google Fonts listesinden bir ad olmalı — runtime
+fontu ADIYLA Google'dan çeker, tanınmayan ad sessizce sans-serif'e düşer (THEME-008).
+
+```jsonc
+theme_update({ theme: {
+  fontFamily: "Inter Tight", headingFontFamily: "Sora",
+  fontSize: "15px", typeScale: { h1: 2.5 }
+} })
+```
+
+**Ölçekler:** oran `0 < r ≤ 20` aralığında olmalı; aralık dışı değer runtime'da SESSİZCE yok
+sayılır (THEME-007 bunu yazmadan önce durdurur).
+
+```jsonc
+theme_update({ theme: { borderRadius: "8px", radiusScale: { lg: 2 }, spacing: "12px" } })
+```
+
+**Gölge:** `color` altı haneli hex OLMALI; başka bir yazım üç gölgeyi birden görünmez yapar
+(THEME-004).
+
+```jsonc
+theme_update({ theme: { shadow: { offsetY: 6, blur: 12, spread: -2, color: "#1E1B4B", opacity: 18 } } })
+```
+
+**Adlı preset kurup bir düğüme bağlamak** — iki adım, ikincisi sayfa tarafında:
+
+```jsonc
+// 1) temaya yaz
+theme_update({ theme: { presets: { kart: {
+  padding: "16px", borderRadius: "12px",
+  background: "var(--ng-background-surface)", boxShadow: "var(--ng-shadow-md)"
+} } } })
+
+// 2) düğüme bağla (page_schema_patch)
+{ "op": "replace_prop", "target": "kart_1", "prop": "style", "value": { "$preset": "kart" } }
+```
+
+Preset gövdesinde sabit hex yerine `var(--ng-*)` kullanın: preset de temayı izlesin.
+
+**Bileşen preseti (yeni düğümlerin başlangıç değeri):** `props` ham prop varsayılanlarıdır
+(`component_get` → `defaults` ile aynı şekil); `appearance` yalnız BOŞLUK alanlarını taşır
+(margin/padding) — ölçü ve hizalama o örneğin ızgaradaki geometrisidir, tipin kararı değil.
+
+```jsonc
+theme_update({ applicationId: "<app>", theme: { componentPresets: { button: {
+  defaultVersion: "V1",
+  versions: { V1: { props: { size: "lg" }, appearance: { marginType: "custom", marginValues: { bottom: 12 } } } }
+} } } })
+```
+
+Bir tip en fazla 5 versiyon taşır ve `defaultVersion` versiyonlar arasında olmalıdır
+(THEME-002). `applicationId` verirseniz gateway tipin o uygulamanın kataloğunda gerçekten
+var olduğunu da denetler (THEME-011).
+
+**Grafik paleti ve rampalar:** `actions` grafik serisi renkleri (`--ng-action-*`), `colors`
+ise ton rampaları (`--ng-blue-500` gibi). İkisi de yalnız veri yoluyla ayarlanır; panelde
+rampa arayüzü yoktur.
+
+**Temayı sıfırlamak:** `theme_update({ replace: true, theme: {} })`.
+
+## Doğrulama
+
+Sıra sabittir; her adım bir öncekinin kanıtını üretir:
+
+1. `theme_update(dryRun: true, …)` → `cssVarsChanged` beklediğiniz değişkenleri taşıyor mu?
+2. `theme_update(…)` → `changed.set` / `changed.unset` yazılanı doğruluyor mu?
+3. `theme_get(view:'resolved')` → `cssVars['--ng-accent-primary']` yeni değeri mi?
+4. `page_screenshot(…)` → **ekranda** gerçekten öyle mi? Koyu mod için aynı çağrıya
+   `colorScheme: 'dark'`; sayfada `theme-toggle` komponenti bulunması GEREKMEZ.
+5. Preset bağladıysanız `page_runtime_get(resolveStyles: true)` → düğümün
+   `styleLayers.preset` alanı preset adını söylüyor mu, `resolvedStyle` preset'in
+   değerlerini taşıyor mu?
+
+## Tuzaklar
+
+**`project_update` tema alanı verilmezse temayı SİLERDİ.** Platformun `PUT /projects/{id}`
+ucu REPLACE'tir: gövdede `Theme` yoksa tema `null` yazılır ve bütün ortamlara yayılır. Gateway
+artık mevcut temayı okuyup gövdeye geri koyuyor ve bunu `gatewayNormalized` ile bildiriyor —
+ama temayı DEĞİŞTİRMEK için `project_update` değil `theme_update` kullanın.
+
+**Studio tema paneli açık ve kaydedilmemişse yazmanız ezilir.** Panel durumunu açılışta
+okur; siz MCP'den yazarken panel açıksa panelin sonraki "Save"i kendi kopyasını üstüne yazar.
+Panel kapalıyken yazın. Gateway bunu tespit edemez — proje kaydında sürüm alanı yoktur.
+
+**Silinen preset sessizce kaybolur.** Çözümleyici eşleşmeyen bir `$preset` adını hata vermeden
+atlar (bir preset silindi diye sayfalar boşalmasın diye). Düğüm kendi stiline düşer ve kimse
+bir şey söylemez — silmeden önce `page_schema_get` ile o adı arayın (THEME-010 uyarır ama
+tarama yapmaz).
+
+**`componentStyles` yazmak canlı kaskadı kalıcı kılmaz.** Runtime onu hâlâ uyguluyor ama
+Studio tema paneli açıldığı ilk kayıtta içeriği `componentPresets`'e taşıyıp anahtarı siliyor:
+o an "her örneğe uygulanan stil", "yalnız yeni düğümlere varsayılan"a döner ve sayfadaki
+mevcut düğümler görünüşlerini kaybeder (THEME-003).
+
+**Çıplak sayı CSS uzunluğu değildir.** `fontSize: 16` → `--ng-font-size: 16` geçersizdir ve
+tarayıcı bildirimi sessizce atar. Gateway sayıyı `'16px'`e çevirip `gatewayNormalized` ile
+bildirir; birimli yazmak daha açıktır.
+
+**Tanınmayan anahtar kayıtta yaşar.** `projects.theme` doğrulanmayan bir jsonb blob'udur:
+`pallete` yazan istek 200 döner ve panel o anahtarı körce geri yazar. `theme_update` şeması
+bunu istek gitmeden reddeder; eski kayıtlardaki kalıntıları `theme_get` `unknownKeys` ile
+gösterir ve `unset` temizler.
+
+**Markanın koyu karşılığı ayrı yazılır.** Aydınlık paleti yazıp bitirdiğinizi sanmak en kolay
+hata: ziyaretçi koyu moda geçtiği anda uygulamanız platformun varsayılan mavisine döner. İki
+kareyi de alın: `page_screenshot(…)` ve `page_screenshot(…, colorScheme: 'dark')`; ikisinin de
+`theme_get(view:'resolved', mode: …)` ile aynı şeyi söylediğini doğrulayın.
+
+**Renkler hex olmalı.** CSS `rebeccapurple`'ı çizer ama studio'nun renk alanları hex bekler
+ve vurgu üstündeki metin rengi (`--ng-text-on-accent`) accent'i karakter karakter okuyup
+kontrast hesapladığı için tanımadığı değerde beyaza düşer (THEME-005).

package/dist/resources/guides/translation.md

@@ -87,7 +87,7 @@ backend'de zaten tanımlı, Studio'nun "Translate" aksiyonunun ürettiği şekil
 > yeniden eklemeyi öneriyordu; o öneri uygulanınca düğüme yazan setter iteratee'lerinin `element`'i
 > silindi (bir panoda alt başlık ve tarih aralığı boş kaldı). Ref'siz translation sarmalı istek
 > gönderilmeden reddedilir; nesne `data` silinir. Eş yol `set_prop_type`'tır — mevcut `data`'yı
-> tasarım yedeği olarak taşır ve layout ağacında (micro-op hattı yok) tek yoldur:
+> tasarım yedeği olarak taşır:
 >
 > ```jsonc
 > { "op": "set_prop_type", "target": "welcome_text", "prop": "text",
@@ -95,9 +95,11 @@ backend'de zaten tanımlı, Studio'nun "Translate" aksiyonunun ürettiği şekil
 > ```
 >
 > İkisi de düğümün olay/setter bağlarını korur. **Prop tipini değiştirmek için
-> `remove_component` + `add_component` yapmayın.** Taşıyıcı alan tipe göre değişir: `static` →
-> `data`, `code` ve `translation` → `ref`. Eksik taşıyıcı istek platforma gitmeden reddedilir ve
-> `page_schema_validate` aynı kararı verir.
+> `remove_component` + `add_component` yapmayın.** İki op da platformun kendi sözlüğündedir ve
+> yamanın geri kalanıyla aynı PATCH'te gider — sayfada `page_schema_patch`, layout'ta
+> `layout_schema_patch`, widget'ta `component_schema_patch`. Taşıyıcı alan tipe göre değişir:
+> `static` → `data`, `code` ve `translation` → `ref`. Eksik taşıyıcı istek platforma gitmeden
+> reddedilir ve `page_schema_validate` aynı kararı verir.
 >
 > Ölçüldü 2026-09-08 (yerel `dil-dogrulama/dil-app`): kurulu bir `statcard`'ın `title` prop'u tek
 > `set_prop_type` op'uyla `f11.tam` anahtarına bağlandı; gerçek ekranda `tr` → "iki dilde dolu",

package/dist/resources/guides/workflow.md

@@ -139,6 +139,85 @@ yoktur** (ölçüm: 2026-09-07). Yazmayı doğrulamak istiyorsan sorguyu kaydet,
 
 Tool açıklamaları bu bölüme işaret eder; iki kaynak çelişirse **bu rehber** doğrudur.
 
+## Önizleme çıktısını okumak: adım izi, hata alanları ve canlı koşudan farkı
+
+`workflow_preview` / `automation_preview` yanıtı `WorkflowPreviewDto`'dur — Studio'daki "Önizleme"
+düğmesinin okuduğu gövdenin aynısı (`WorkflowDetail.svelte` `handlePreview` →
+`POST workflows/{appId}/preview`). Studio'nun yaptığı tek şey listeyi düzleştirip **`hasError: true`
+olan ilk adıma** odaklanmaktır; hata yoksa son adıma. Aynı okumayı sen de yap:
+
+```jsonc
+{ "input": { "id": 12 },            // previewPayload'ın değerlendirilmiş hâli — BOŞSA girdi hiç bağlanmamıştır (WF-016)
+  "output": { … },                  // akışın döndürdüğü gövde (response adımı)
+  "executionSuccess": true,         // YALNIZ son adıma bakar — hata dalından dönen akışta da true olabilir
+  "steps": [
+    { "step": { "id": "…", "name": "readRow", "type": "table" },
+      "input": [ { "expression": "input.id", "value": 12, "source": "filter", "member": "id" } ],
+      "output": { … },              // adımın ürettiği veri; patlayan adımda boş
+      "hasError": true,
+      "errorType": "RowNotFoundException", "errorCode": "RowNotFound",
+      "errorMessage": "…lokalize mesaj…", "errorDetail": "…iç ayrıntı (SQL/JS hatası)…",
+      "elapsedMilliseconds": 7.3,
+      "nextStep": { "id": "…", "name": "gatewayOnError", "type": "response" },   // akış buradan nereye gitti
+      "children": [ … ],            // loop iterasyonları / alt workflow: her biri { kind, name, steps, input, output, executionSuccess }
+      "automations": [ … ]          // table adımının tetiklediği automation'lar: { id, name, entityId, operation, row, previousRow, status, errorMessage, executionSuccess, steps }
+    } ],
+  "runtimeErrors": [ "readRow (table): RowNotFound — …" ]   // GATEWAY ekler; platform gövdesinde yoktur
+}
+```
+
+**Okuma sırası:**
+
+1. **`runtimeErrors`** — gateway tüm ağacı tarar (`steps[].children[].steps[]` ve
+   `steps[].automations[].steps[]` dâhil). Boşsa akış hiçbir adımda patlamamıştır.
+   `executionSuccess`'e güvenme: platform onu son adımın `hasError`'ından hesaplar
+   (`WorkflowPreviewDto.cs:25`); ortada patlayıp `gatewayOnError`'dan 500 dönen akış `true` gösterir.
+2. **Patlayan adımın satırı** — `errorType` exception tipi, `errorMessage` lokalize mesaj,
+   `errorDetail` iç ayrıntı. `input[]` adımın hangi ifadeyi hangi değere bağladığını gösterir:
+   satırda `value` yoksa ifade `undefined`/null üretmiştir — hatanın gerçek sebebi çoğu zaman bir
+   üst adımın çıktısı ya da bağlanmamış girdidir (`"input": {}`).
+3. **`nextStep`** — adımdan sonra akışın nereye gittiği. Hata dalına düşen adımın `nextStep`'i
+   global-error dalının ilk adımıdır; `fail` dalı bağlıysa o adımdır.
+4. **`elapsedMilliseconds`** — koşunun toplamı beklenenden çok kısaysa (yazma akışı 90 ms gibi)
+   akış ilk adımlarda patlayıp hata dalından dönmüştür; adım sürelerinden nerede durduğunu oku.
+5. **HTTP 200 ≠ geçti, HTTP 400/500 ≠ adım hatası.** Yanıt 200 iken akış patlamış olabilir
+   (yukarıdaki alanlar). Yanıt 400/500 ise koşum **hiç başlamamıştır**: validator reddi (WF-026),
+   `previewPayload`'ın nesne gönderilmesi (`Unexpected end of input`), `previewVariables`
+   ifadesinin patlaması. İkisini ayır: ilkinde adımı, ikincisinde gövdeyi düzelt.
+
+**Kayıtlı bir akışı çalıştırmadan koşturmak** (Studio'nun "Önizleme" düğmesinin MCP karşılığı):
+
+1. `workflow_get(applicationId, id)` — varsayılan `view:'full'` gövde `steps`, `parameterDtoId`,
+   **`previewPayload`** ve **`previewVariables`** alanlarını taşır: Studio'da yazılan test girdisi
+   tanımla birlikte saklanır (`Workflow.PreviewPayload` / `PreviewVariables`) ve Studio'nun
+   önizlemesi de onu kullanır.
+2. Yanıttaki `data` gövdesini `workflow_preview(definition)` ile olduğu gibi gönder: `id`,
+   `createdAt` gibi fazladan alanlar platformda yok sayılır; `parameterDtoId` yoksa gateway
+   `previewPayload`'ı düşürür. Girdiyi değiştirmek için yalnız `previewPayload`'ı yeniden yaz
+   (`"({ … })"` biçimi, Kural 4).
+3. `runtimeErrors` boş + `input` dolu ⇒ akış bu girdiyle geçiyor. Ancak ondan sonra kaydet, uca
+   bağla ya da zamanla. Zamanlanmış iş için sıra ve tuzaklar: `platform_guide('microservice')`
+   §"Zamanlanmış işin gerçek sonucunu görmek".
+
+**Önizleme neyi kanıtlar, neyi kanıtlamaz** (kaynak: `PreviewWorkflowCommand`, `WorkflowContext`,
+`ExecuteMicroserviceBehavior`, `MicroserviceJob`):
+
+| Konu | `workflow_preview` | Canlı uç (`/m/`, sayfa akışı) | Zamanlanmış iş (`schedule-job`) |
+|---|---|---|---|
+| Yazmalar | tek transaction, sonunda **rollback** | 2xx'te commit, 4xx/5xx'te rollback | 2xx'te commit; bağlanmamış fail ya da 2xx dışı sonuçta **rollback** (2026-09-16'dan beri; öncesinde her durumda commit ediyordu) |
+| Girdi | `previewPayload` (JS kaynak metni) | isteğin gövdesi/query/route, DTO'ya bağlanır | **boş** (`MicroserviceExecuteParameter.Create()`); `input.x` hep `undefined` |
+| `request.*` | **yok** (Preview'da yüklenmez) | var | **yok** (HttpContext yok) |
+| `context` / `triggerSource` | kurulmaz (GEN-005) | var | kurulmaz |
+| Middleware ve `user` | koşmaz | koşar | **koşmaz** — `user` yok |
+| `email`, `http`, `code` içi HTTP | **gerçekten koşar** (SMTP gönderilir, dış uç çağrılır) | gerçek | gerçek |
+| `microfunction` | `preview: true` bayrağıyla çağrılır | gerçek | gerçek |
+| `table` / `file` yazmaları | geri alınır | yukarıdaki commit/rollback | yukarıdaki commit/rollback |
+| Adım izi | **tam** (bu bölüm) | yok — yalnız yanıt gövdesi; ağaç için `microservice_debug` | yok — geçmiş satırı `status + süre + errorMessage` (`Step 'x' failed: <sebep>` ya da `The job's workflow returned 500 (<code>): <mesaj>`) |
+
+Yani önizleme akışın **şeklini** kanıtlar: ifadeler, dallar, DTO uyumu, tablo/sorgu hataları.
+Kanıtlamadıkları: dile bağlı dal (`context.language`), `user`'a bağlı kapsam, `request`'ten okunan
+parametre — bunları `microservice_execute` ile ölç (§İstek dili, `platform_guide('middleware')`).
+
 ## Hata yolu
 
 **Gateway workflow ve middleware tanımlarına hata yolunu otomatik ekler** (yanıtta
@@ -176,8 +255,11 @@ yapıyı dışarı sızdırır.
 - **`automation` tipinde `response` adımı yasaktır**, bu yüzden gateway bu tipe enjeksiyon
   yapmaz. Hata yolunu kendin yaz: global-error dalını `revert` (kapsamı `isQueue`'ya
   bağlı — §izin matrisi) ya da `email`/`table` adımına bağla. Bağlı hata yolu yoksa `WF-021` uyarır.
-- **Hata yolu hiç yoksa** akış patladığında platform 500 + ham exception mesajı döner. Çalışır,
-  ama çıktı denetimsizdir ve lokalize değildir.
+- **Hata yolu hiç yoksa** (fail dalı ve global-error dalı bağlı değil) adım patladığında motor
+  canlıda `WorkflowStepFailedException` fırlatır (2026-09-16): HTTP yanıt 500 +
+  `{ code, message, detail, type }` (patlayan adımın hatası), zamanlanmış iş ve automation geçmişi
+  `failed` + `Step 'x' failed: <sebep>`, senkron automation tetikleyen satır yazımını düşürür.
+  Önizlemede fırlatmaz, ağaç döner. Çalışır, ama çıktı lokalize değildir.
 
 > **Preview HTTP 200 dönerken bile akış patlamış olabilir.** `executionSuccess` yalnız SON adıma
 > bakar; ortada patlayıp hata dalından dönen akış `true` gösterir. Gateway tüm adımları (iç içe
@@ -186,10 +268,13 @@ yapıyı dışarı sızdırır.
 >
 > **`runtimeErrors` her tool'da aynı şeyi ölçmez.** Alan yalnız `steps[]` taşıyan yanıtlarda adım
 > adım tarama yapar. `microservice_execute` / `microservice_debug` / `microservice_preview`
-> yanıtlarında gateway sadece `httpStatus >= 400` durumunu bulgu sayar: bu tool'lar adım ağacını
-> `executionItems` olarak döner ve o düğümlerde hata işareti yoktur, yani HTTP 200 gövdesine gömülü
-> bir microservice hatası `runtimeErrors` üretmez. Orada `body`'yi kendin oku ve şüpheliyse
-> `microservice_debug` ile adım adım bak. `query_preview` yanıtları hiç kapsanmaz.
+> yanıtlarında gateway sadece `httpStatus >= 400` durumunu bulgu sayar — bu üç uçta HTTP durumu
+> akışın kendi `httpStatusCode`'udur (`MicroservicesController.HandleResult`), yani hata dalından
+> 500 dönen akış yakalanır, ama 200 ile `{ success: false }` dönen akış yakalanmaz. Adım ağacını
+> (`executionItems`) yalnız `microservice_debug` döner ve o düğümlerde hata işareti yoktur:
+> patlayan adımın `output`'u boştur, hata gövdesi hata dalındaki response adımının çıktısındadır.
+> Orada `body`'yi kendin oku. Adım başına hata alanı isteyen teşhis için akışı `workflow_preview`
+> ile koştur (§Önizleme çıktısını okumak). `query_preview` yanıtları hiç kapsanmaz.
 
 ## Condition step kuralları
 

package/dist/resources/schema-fingerprint.json

@@ -1,6 +1,6 @@
 {
-  "hash": "cafe3a6b082c7828cece4eaa1c0115ba28581f157eac3288abcf068c7f6f8533",
-  "generatedAt": "2026-09-15T10:24:42.398Z",
+  "hash": "54430a8d4050fd201aaee88608a5d06b947edf6d561ad31354914422df4e94ce",
+  "generatedAt": "2026-09-16T11:17:11.569Z",
   "types": 185,
   "files": 107,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",

package/dist/server.js

@@ -1,42 +1,44 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { registerMicroserviceTools } from './tools/microservices.js';
-import { registerMicrofunctionTools } from './tools/microfunctions.js';
-import { registerApplicationTools } from './tools/applications.js';
-import { registerDeploymentTools } from './tools/deployments.js';
-import { registerDatasourceTools } from './tools/datasources.js';
-import { registerAutomationTools } from './tools/automations.js';
-import { registerOrganizationTools } from './tools/organizations.js';
-import { registerExternalComponentTools } from './tools/externalComponents.js';
-import { registerComponentTools } from './tools/components.js';
-import { registerPlatformTools } from './tools/platformInfo.js';
-import { registerTemplateTools } from './tools/templates.js';
-import { registerWorkflowTools } from './tools/workflows.js';
-import { registerLayoutTools } from './tools/layouts.js';
-import { registerAccessTools } from './tools/access.js';
-import { registerTranslationTools } from './tools/translations.js';
-import { registerFlowTools } from './tools/flows.js';
-import { registerKnowledgeResources } from './resources/knowledge.js';
-import { registerSchemaResources } from './resources/schemas.js';
-import { registerRuleResources } from './resources/rules.js';
-import { instrumentServer } from './observability/trace.js';
-import { rejectUnknownArguments } from './platform/strictArguments.js';
-import { registerProjectTools } from './tools/projects.js';
-import { registerEntityTools } from './tools/entities.js';
-import { registerDependencyTools } from './tools/dependencies.js';
-import { registerVariableTools } from './tools/variables.js';
-import { registerFunctionTools } from './tools/functions.js';
-import { registerFolderTools } from './tools/folders.js';
-import { registerQueryTools } from './tools/queries.js';
-import { registerViewTools } from './tools/views.js';
-import { registerPageTools } from './tools/pages.js';
-import { registerFileTools } from './tools/files.js';
-import { registerRowTools } from './tools/rows.js';
-import { registerImportTools } from './tools/imports.js';
-import { registerEnvironmentTools } from './tools/environments.js';
-import { registerMergeTools } from './tools/merges.js';
-import { registerRevisionTools } from './tools/revisions.js';
-import { registerActivityTools } from './tools/activities.js';
-import { registerDtoTools } from './tools/dtos.js';
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerMicroserviceTools } from "./tools/microservices.js";
+import { registerMicrofunctionTools } from "./tools/microfunctions.js";
+import { registerApplicationTools } from "./tools/applications.js";
+import { registerDeploymentTools } from "./tools/deployments.js";
+import { registerDatasourceTools } from "./tools/datasources.js";
+import { registerAutomationTools } from "./tools/automations.js";
+import { registerOrganizationTools } from "./tools/organizations.js";
+import { registerExternalComponentTools } from "./tools/externalComponents.js";
+import { registerComponentTools } from "./tools/components.js";
+import { registerPlatformTools } from "./tools/platformInfo.js";
+import { registerTemplateTools } from "./tools/templates.js";
+import { registerWorkflowTools } from "./tools/workflows.js";
+import { registerLayoutTools } from "./tools/layouts.js";
+import { registerDesignSchemaPatchTool } from "./tools/designSchemaPatch.js";
+import { registerAccessTools } from "./tools/access.js";
+import { registerTranslationTools } from "./tools/translations.js";
+import { registerFlowTools } from "./tools/flows.js";
+import { registerKnowledgeResources } from "./resources/knowledge.js";
+import { registerSchemaResources } from "./resources/schemas.js";
+import { registerRuleResources } from "./resources/rules.js";
+import { instrumentServer } from "./observability/trace.js";
+import { rejectUnknownArguments } from "./platform/strictArguments.js";
+import { registerProjectTools } from "./tools/projects.js";
+import { registerEntityTools } from "./tools/entities.js";
+import { registerDependencyTools } from "./tools/dependencies.js";
+import { registerVariableTools } from "./tools/variables.js";
+import { registerFunctionTools } from "./tools/functions.js";
+import { registerFolderTools } from "./tools/folders.js";
+import { registerQueryTools } from "./tools/queries.js";
+import { registerViewTools } from "./tools/views.js";
+import { registerPageTools } from "./tools/pages.js";
+import { registerThemeTools } from "./tools/themes.js";
+import { registerFileTools } from "./tools/files.js";
+import { registerRowTools } from "./tools/rows.js";
+import { registerImportTools } from "./tools/imports.js";
+import { registerEnvironmentTools } from "./tools/environments.js";
+import { registerMergeTools } from "./tools/merges.js";
+import { registerRevisionTools } from "./tools/revisions.js";
+import { registerActivityTools } from "./tools/activities.js";
+import { registerDtoTools } from "./tools/dtos.js";
 const moduleRegistrations = {
     platform: registerPlatformTools,
     project: registerProjectTools,
@@ -53,10 +55,17 @@ const moduleRegistrations = {
     dto: registerDtoTools,
     view: registerViewTools,
     page: registerPageTools,
-    component: registerComponentTools,
+    theme: registerThemeTools,
+    component: (server, platform) => {
+        registerComponentTools(server, platform);
+        registerDesignSchemaPatchTool(server, platform, "component");
+    },
     externalComponent: registerExternalComponentTools,
     flow: registerFlowTools,
-    layout: registerLayoutTools,
+    layout: (server, platform) => {
+        registerLayoutTools(server, platform);
+        registerDesignSchemaPatchTool(server, platform, "layout");
+    },
     variable: registerVariableTools,
     function: registerFunctionTools,
     folder: registerFolderTools,
@@ -70,10 +79,10 @@ const moduleRegistrations = {
     environment: registerEnvironmentTools,
     merge: registerMergeTools,
     activity: registerActivityTools,
-    revision: registerRevisionTools
+    revision: registerRevisionTools,
 };
 export function createGatewayServer(platform) {
-    const server = rejectUnknownArguments(instrumentServer(new McpServer({ name: 'ngapps', version: '0.1.0' }), platform.config));
+    const server = rejectUnknownArguments(instrumentServer(new McpServer({ name: "ngapps", version: "0.1.0" }), platform.config));
     for (const moduleName of platform.config.modules) {
         moduleRegistrations[moduleName](server, platform);
     }

package/dist/tools/components.js

@@ -1,6 +1,7 @@
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
 import { normalizeComponentDefaults, componentDefaultsNote, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, 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 { componentUpdateBody, fetchHost, schemaParam, unwrap } from './screens.js';
 import { PlatformApiError } from '../platform/errors.js';
@@ -160,6 +161,12 @@ export function registerComponentTools(server, platform) {
             : [];
         const componentSlug = typeof component.slug === 'string' ? component.slug : undefined;
         const knowledge = knowledgeFor(componentSlug);
+        // S-3 — `defaults` HAM katalogdur; Studio'da bırakılan düğüm ise temanın bileşen preseti
+        // kaplanmış katalogdan kurulur (`withThemeComponentDefaults`). Tema okunamazsa (uç düşer,
+        // yetki yoksa) alan yanıta HİÇ girmez: uydurulmuş bir varsayılan yanlış bilgidir.
+        const themeDefaults = componentSlug === undefined
+            ? undefined
+            : componentPresetDefaults(readProjectTheme(await platform.org('GET', `/p/${platform.resolveProject(project)}`).catch(() => undefined)), componentSlug);
         return {
             id: component.id,
             slug: component.slug,
@@ -188,6 +195,7 @@ export function registerComponentTools(server, platform) {
                     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."
                 }
                 : {}),
+            ...(themeDefaults ? { themeDefaults } : {}),
             appearanceValues: APPEARANCE_TOKEN_SETS,
             stateFlags: STATE_FLAG_NOTES,
             validations: definition.validations,