@appaflytech/zeyrek-ai-mcp 0.0.8 → 0.0.10

package/README.md

@@ -4,10 +4,10 @@ Zeyrek (NgApps) platformunu **MCP tool'ları** olarak sunan bağımsız gateway.
 oturumu Studio arayüzüne hiç girmeden proje kurabilir, veri modeli çıkarabilir, mikroservis ve
 workflow yazıp çalıştırabilir, sayfa tasarlayabilir.
 
-- **191 tool · 32 modül** — veri/mantık tarafı (project, application, datasource, entity, row,
+- **208 tool · 34 modül** — veri/mantık tarafı (project, application, datasource, entity, row,
   import, microservice, query, workflow, automation, function, dto, view, dependency), Studio
-  tasarım tarafı (page, component, external component, flow, layout, variable, function, folder,
-  file, access, translation), yönetim (template, organization, deployment) ve proje dallanması
+  tasarım tarafı (page, **theme**, component, external component, flow, layout, variable, function,
+  folder, file, access, translation), yönetim (template, organization, deployment) ve proje dallanması
   (environment, merge).
 - Platform koduna referans vermez: Organization.API ile Tenant.API'yi **HTTP üzerinden** sarar —
   istekler MVC binding'den geçtiği için FluentValidation aynen çalışır.
@@ -29,7 +29,7 @@ ekleyin:
     "zeyrek-ai": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@appaflytech/zeyrek-ai-mcp@0.0.5", "--stdio"],
+      "args": ["-y", "@appaflytech/zeyrek-ai-mcp@latest", "--stdio"],
       "env": {
         "ORG_API_BASE_URL": "https://new-zeyrek.glomil.com/api/org",
         "TENANT_API_BASE_URL": "https://new-zeyrek.glomil.com/api",
@@ -56,7 +56,7 @@ claude mcp add zeyrek-ai \
   -e DEFAULT_ENVIRONMENT=development \
   -e USERNAME=admin@zeyrek.com \
   -e PASSWORD='parolanız' \
-  -- npx -y @appaflytech/zeyrek-ai-mcp@0.0.5 --stdio
+  -- npx -y @appaflytech/zeyrek-ai-mcp@latest --stdio
 ```
 
 **İlk doğrulama:** oturumda `platform_whoami` tool'unu çağırtın — kimlik, org çözümü ve ağ
@@ -64,9 +64,10 @@ erişimi tek seferde test edilir. Tool listesi boş geliyorsa Sorun giderme böl
 
 ### Sürüm seçimi
 
-`@0.0.5` gibi sabit sürüm önerilir: npx kopyayı önbelleğe alır, sabit sürümde herkes aynı
-gateway'i çalıştırır. `@latest` yazarsanız ekipteki makineler farklı sürümlerde kalabilir;
-güncellemek için `.mcp.json`'daki sürümü yükseltip MCP sunucusunu yeniden başlatın.
+`@latest` önerilir: `main`'e giren her gateway değişikliği CI'da otomatik yayınlanır (bkz.
+Yayınlama), yeni sürüm MCP sunucusu yeniden başlatılınca gelir. npx kopyayı önbelleğe aldığı
+için eski sürümde kalan makinede `~/.npm/_npx` silinip sunucu yeniden başlatılır. Herkesin aynı
+gateway'i çalıştırması gereken işlerde (koşu, kabul testi) `@0.0.8` gibi sabit sürüm yazın.
 
 ---
 
@@ -138,10 +139,10 @@ ya da ikisi karışık (`core,page`). `platform` modülü (3 tool) her kümede v
 
 | Küme | Tool | Modüller |
 |---|---|---|
-| `core` | 111 | platform, project, application, datasource, entity, row, microservice, query, workflow, automation, function, dto, view, dependency, environment, merge, activity, revision |
-| `studio` | 69 | platform, page, component, externalComponent, flow, layout, variable, function, folder, file, access, translation, revision |
-| `admin` | 26 | platform, template, organization, deployment, environment, merge, activity |
-| (boş) | **185** | 32 modülün tamamı |
+| `core` | 136 | platform, project, application, datasource, entity, row, import, microservice, microfunction, query, workflow, automation, function, dto, view, dependency, environment, merge, activity, revision |
+| `studio` | 78 | platform, page, theme, component, externalComponent, flow, layout, variable, function, folder, file, import, access, translation, revision |
+| `admin` | 27 | platform, template, organization, deployment, environment, merge, activity |
+| (boş) | **208** | 34 modülün tamamı |
 
 Bilinmeyen bir modül/küme adı verilirse sunucu açılmaz, geçerli adları listeleyen bir hata yazar.
 
@@ -165,7 +166,8 @@ Bilinmeyen bir modül/küme adı verilirse sunucu açılmaz, geçerli adları li
   `platform_guide('page')`.
 - **Yazma tool'ları replace gövdeleri merge eder:** `page_update`, `layout_update`,
   `component_update` kaydı önce okur, yalnız verdiğiniz alanları değiştirir; şema/olay kaybı
-  olmaz. `flow_*` uçlarının istediği barındırıcı gövdesini de gateway kurar.
+  olmaz. `flow_*` yazmaları yalnız akışı gönderir; olay bağı `page_schema_patch` /
+  `layout_schema_patch` / `component_schema_patch` ile ayrı yazılır.
 - **Gerçek ekran:** UI değişikliği `page_screenshot` ile doğrulanır (`STUDIO_BASE_URL` gerekir;
   ilk kullanımda `npx playwright-core install chromium`).
 
@@ -213,7 +215,7 @@ etiketleri, diğer `LOG_*` ayarları ve maskeleme:
 | `POST /connect/token` 404 / "kayıt bulunamadı" | Kimlik makine kullanıcı adıyla gidiyor — `USERNAME` üstteki üçüncü davranış maddesi. |
 | `Host` çözülemedi / 404 | `ORGANIZATION` + `HOST_SUFFIX` birlikte `{org}.{suffix}` üretir; ikisi de doğru olmalı. |
 | `page_screenshot` hata veriyor | `STUDIO_BASE_URL` boş ya da tarayıcı yok: `npx playwright-core install chromium` veya `SCREENSHOT_BROWSER_PATH`. |
-| Eski sürüm çalışıyor | npx önbelleği: `.mcp.json`'da sabit sürüm yazın ve sunucuyu yeniden başlatın. |
+| Eski sürüm çalışıyor | npx önbelleği: `~/.npm/_npx`'i silip sunucuyu yeniden başlatın ya da `.mcp.json`'da sabit sürüm yazın. |
 
 Her durumda ilk bakılacak yer günlük dosyasıdır (`LOG_DIR`).
 
@@ -225,7 +227,7 @@ Gateway'i ortak bir sunucu olarak çalıştırmak için (stateless streamable HT
 POST):
 
 ```bash
-npx -y @appaflytech/zeyrek-ai-mcp@0.0.5     # --stdio olmadan
+npx -y @appaflytech/zeyrek-ai-mcp@latest     # --stdio olmadan
 ```
 
 Sağlık ucu: `http://localhost:5100/healthz` (port `MCP_PORT`). İstemci kaydı:
@@ -276,19 +278,23 @@ kural envanteri [`docs/08-kural-envanteri.md`](docs/08-kural-envanteri.md).
 
 ### Yayınlama (paket bakımcısı)
 
+Yayın otomatiktir: `main`'e `zeyrek-mcp/` değişikliği girince CI işi `publish:mcp:npm`
+([`scripts/ci-publish-npm.sh`](scripts/ci-publish-npm.sh)) paketi üretip npm'deki son sürümle
+içerik olarak karşılaştırır; pakete giren dosyalar değiştiyse yeni patch sürümünü yayınlar.
+Sürümün kaynağı npm'dir, CI `package.json`'ı geri commit'lemez. Minor/major için
+`package.json`'daki sürümü elle yükseltip merge edin. Yayını o commit için atlamak: commit
+mesajına `DoNotDeploy` (iş elle tetiklenir hâle gelir).
+
+Yerelde deneme (yayın yapmaz; `npm ci` çalıştırdığı için bir kopyada ya da Linux container'da):
+
 ```bash
-cd zeyrek-mcp
-npm run typecheck && npm test
-npm version patch            # package.json sürümü
-npm publish                  # prepack: tsc -p tsconfig.build.json + varlık kopyalama
+DRY_RUN=1 sh scripts/ci-publish-npm.sh
 ```
 
 `dist/` içine `src/resources/{schemas,guides,examples}` altındaki JSON/MD varlıklarını
 `scripts/copy-assets.ts` kopyalar — `tsc` tek başına bunları taşımaz. Yayınlanan paket
 `dist/`, `README.md` ve iki `.env` şablonundan oluşur.
 
-Sürüm yükseldikten sonra ekipteki `.mcp.json` örneklerindeki sabit sürümü de güncelleyin.
-
 ---
 
 ## Bilinen sınırlar

package/dist/config.js

@@ -16,6 +16,7 @@ export const moduleNames = [
     "dto",
     "view",
     "page",
+    "theme",
     "component",
     "externalComponent",
     "flow",
@@ -61,6 +62,7 @@ export const modulePresets = {
     studio: [
         "platform",
         "page",
+        "theme",
         "component",
         "externalComponent",
         "flow",

package/dist/knowledge/componentCatalog.js

@@ -249,7 +249,7 @@ export const componentKnowledge = {
         behavior: [
             "Yerleşim prop'ları (layout/direction/gap/gridColumns...) box ile BİREBİR aynıdır ve bileşende okunmaz — çocuk sarmalayıcısını RenderComponent/Draggable giydirir. layout değerleri de box ile aynı: 'flex' | 'grid' (2026-09-02'de 'cssgrid' seçenek olmaktan çıktı; o değerle kayıtlı düğümler gerçek display:grid akışıyla çizilmeye devam eder).",
             "KATMAN SIRASI (K4): tema componentStyles → $preset TABANDIR (varsayılan verir); tipli grup alanları temayı alan alan EZER (tasarımcının/AI'ın açık seçimi kazanır); düğümün serbest style'ı her şeyin üstünde SON SÖZDÜR.",
-            "TEMA PRESET'İ: bir tema preset'ini düğüme bağlamak için style.$preset: '<ad>' yaz (adlar project_get → theme.presets; componentStyles[type] referanssız, tipin her örneğine uygulanır). Bir alanı 'temaya bırakmak' = o alanı HİÇ yazmamak (null/boş) — studio'daki 'Temaya dön' tam olarak bunu yapar; tema değerini gruba kopyalamak bağı koparır.",
+            "TEMA PRESET'İ: bir tema preset'ini düğüme bağlamak için style.$preset: '<ad>' yaz (adlar theme_get → presets, sayfa bağlamında page_runtime_get → theme.presets; preset'i yazmak/silmek theme_update; componentStyles[type] referanssız, tipin her örneğine uygulanır). Bir alanı 'temaya bırakmak' = o alanı HİÇ yazmamak (null/boş) — studio'daki 'Temaya dön' tam olarak bunu yapar; tema değerini gruba kopyalamak bağı koparır.",
             "STİL YAZMA SIRASI: önce tipli gruplar (alan varsa oraya), grubun karşılamadığı karar style kanalına (custom properties). Tipli alan dururken aynı özelliği style'a yazmak paneli yanıltır — style kazanır ama panel alanı 'etkisiz' görünür.",
             "Yüzey neden prop: düğümün appearance kanalı sarmalayıcıyı (.ng-app__node-item) boyar, kutunun İÇİNİ değil — box'ta .ng-box'ın kendi background/border-radius'una hiçbir panelden ulaşılamıyor. surfaceStyle bu boşluğu kapatır.",
             "Bölge (header/footer) düğümleri box ile ORTAKTIR: hasHeader/hasFooter aynı box-section düğümlerini açar. sectionStyle kuralları bu yüzden '&__header' gibi bir parçaya değil, gerçek '& .ng-box-section--header' seçicisine yazılır.",
@@ -307,7 +307,7 @@ export const componentKnowledge = {
         summary: 'Ortalanmış katman; şemanın KÖKÜNDE page_container’ın kardeşi olarak durur, içeriği (kendi formu ve submit akışı dahil) children’ına eklenir.',
         behavior: [
             "open/close olayları akışa bağlanabilir; açma/kapama isHidden ile değil kendi open state'iyle yürür (setter ile isOpen yaz).",
-            "Kaplama çerçevesidir (isFrame): kanvasta blok tutmaz, runtime kutu stili yazmadan ayrı dalda çizer. Katalog boyutu bilerek BOŞ aralıktır (minSize 1, maxSize 0) ve 2026-09-15'ten beri doğrulayıcı boş aralıklı eksende blocks[].size'ı DENETLEMEZ — add_component ile kökte (parent null) herhangi bir { w, h } ile eklenir. Daha eski backend build'i her boyutu 'Height of modal must be between 1 and 0' (invalid-size) ile reddeder; o durumda imaj yenilenmemiştir. drawer ve toast aynı kuraldadır."
+            "Kaplama çerçevesidir (isFrame): kanvasta blok tutmaz, runtime kutu stili yazmadan ayrı dalda çizer. Katalog boyutu bilerek BOŞ aralıktır (minSize 1, maxSize 0) ve 2026-09-15'ten beri doğrulayıcı blocks[].size'ı hiçbir eksende DENETLEMEZ (boyut sınırı kanvasın kuralıdır) — add_component ile kökte (parent null) herhangi bir { w, h } ile eklenir. Daha eski backend build'i her boyutu 'Height of modal must be between 1 and 0' (invalid-size) ile reddeder; o durumda imaj yenilenmemiştir. drawer ve toast aynı kuraldadır."
         ],
         propNotes: { surfaceStyle: NODE_SURFACE_NOTE }
     },
@@ -525,42 +525,104 @@ export const componentKnowledge = {
         }
     },
     datepicker: {
-        summary: 'Tarih seçici; change yükü { value, HH, mm }.',
+        summary: 'Tek GÜN seçici (saat yok): takvimden ya da kutuya yazarak; change yükü tek anahtar { value }.',
+        behavior: [
+            "Değer YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metnidir (dilim eki yok, saat kısmı seçimde 00:00) ya da null. change düğümün prop'una yazar: akış değeri self.value ile okur, event.data BOŞTUR (CQ-149). 2026-09-15 öncesinde bu kayıt yükte HH ve mm anahtarları da olduğunu söylüyordu — runtime hiç göndermiyordu, self.HH okuyan ifade boş dönerdi.",
+            "minDate/maxDate GÜN sınırıdır ('yyyy-MM-dd'): ikisi de KENDİ günü dahil seçilebilir kalır. 2026-09-15'te düzeltildi — çıplak gün metni UTC gece yarısı olarak okunuyordu, Greenwich'in doğusunda (TR: +03) minDate'in kendi günü takvimde PASİF görünüyordu, yazarak seçilirse değer 03:00'a kaydırılıyordu; batısında (örn. New York −04) aynı kusur maxDate'te çıkıyordu — maxDate'in KENDİ günü pasifti. Sınır dışı günler takvimde pasiftir; kutuya YAZILAN sınır dışı bir tarih hata vermez, o sınır gününün gece yarısına çekilir. Akıştan yazılan değer bu kapıdan GEÇMEZ, olduğu gibi gösterilir.",
+            'Takvim tek gün seçtirir; komşu ayların günleri de seçilebilir, yıl açılır listesi 1900-2100 arasında gezer, popup her ay altı hafta çizer. Seçim anında popup kapanır ve change yayılır — onay adımı yoktur.',
+            "Kutuya elle yazmak için çift tıklanır (tek tık takvimi açar). Okunan desenler tr'de 'd MMM yyyy' · 'd MMMM yyyy' · 'd.MM.yyyy' · 'dd.MM.yyyy' · 'dd.MM.yy', diğer dillerde 'MMM d, yyyy' · 'MMMM d, yyyy' · 'MM/dd/yyyy' · 'M/d/yyyy' · 'MM/dd/yy'; 1900 öncesi ve 2100 sonrası yıl reddedilir. Okunamayan yazı tutulan değere döner, değer yoksa kutu BOŞALIR (2026-09-15; öncesinde reddedilen metin değermiş gibi ekranda kalıyordu). Kutu salt okunur olsa da programdan gelen change'i DİNLER: page_screenshot 'set' ile ISO tarih ('2026-08-01', '2026-08-01T09:30') ya da gösterim biçimi yazılabilir ve değer takvimden seçilmiş gibi yayılır; okunamayan metinde actionsReport propWritten:false döner. 2026-09-15 öncesi olay dinlenmiyordu: kutu dolu görünüyor, prop boş kalıyordu (G-14).",
+            'Doğrulama kuralları: required · min · max (2026-09-15; pattern bildirimi kaldırıldı — panel tarih alanına regex kuralı hiç çizmiyordu, yazılan satırı düğüm seçilince siliyordu, CQ-226). min/max değeri gün metnidir ve alanın minDate/maxDate prop\'larından AYRIDIR: minDate/maxDate takvimi kısar, min/max gönderimde hata gösterir. DİKKAT (CQ-252): Form kuralın gün metnini UTC, alanın değerini YEREL okuyor (form/helper.ts dateMs), yani UTC olmayan her dilimde SINIR GÜNÜNÜN KENDİSİ yanlış tarafta kalıyor — Türkiye saatinde tam min gününe eşit bir değer yine de en-az hatası veriyor. Bugünkü güvenli yol: sınırı bir gün geniş tutmak ya da kural yerine minDate/maxDate kullanmak.',
+            'focus/blur ALAN düzeyindedir (2026-09-15): girdi ile takvim arasında dolaşmak olay yaymaz; yalnız alana girmek ve alandan çıkmak yayar. Kilitli alan (isDisabled/isReadonly/isViewmode) hiçbir olay yaymaz.',
+            'isLoading KİLİT DEĞİLDİR (2026-09-15): alan kullanılabilir kalır, sağ uçta dönen spinner çizilir (o sırada X gizlenir) ve kök aria-busy taşır. Kilit için isDisabled kullan.',
+            "Değer doluyken sağ uçta X çıkar ve change'i null ile yayar; kilitli kipte X yoktur. Gösterim dili locale'den (boşsa uygulama dili): tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'. Biçim ve haftanın ilk günü prop'u YOK (ARC-071).",
+            'Saat gerekiyorsa datetimepicker, aralık gerekiyorsa daterangepicker kullanılır; bu bileşen saat taşımaz.'
+        ],
+        propNotes: {
+            value: "Seçili gün: 'yyyy-MM-ddTHH:mm:ss' ya da 'yyyy-MM-dd' metni, ya da null. Çıplak gün YEREL okunur (UTC kaydırması yok). Okunamayan metin alanı BOŞ gösterir, hata vermez. " + DATE_VALUE_FORMAT_NOTE,
+            minDate: "En erken gün ('yyyy-MM-dd'); o günün kendisi seçilebilir, öncesi takvimde pasif kalır.",
+            maxDate: 'En geç gün; o günün kendisi seçilebilir, sonrası pasif kalır.',
+            placeholder: "Boş alanda görünen metin; varsayılanı '01.01.2000' ama kutu değeri her zaman dilin desenine göre yazar (tr '10 Eyl 2026', diğer diller 'Sep 10, 2026') — yer tutucu bir biçim SÖZÜ DEĞİLDİR.",
+            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); saklanan değer değişmez. Gün sınırına yakın bir değeri komşu güne kaydırabilir.',
+            valueOffset: 'YAZILAN değeri kaydıran saat sayısı; gösterim değişmez. Bir dilim farkını sabit tutmak için displayOffset ile ters işaretli kullanılır (+3 / -3).',
+            locale: LOCALE_FOLLOWS_APP_NOTE,
+            isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kök aria-busy taşır.'
+        }
+    },
+    datetimepicker: {
+        summary: 'Tek alanda tarih + saat seçici: takvim + dakika adımlı saat listesi; değer tek value, change yükü { value }.',
         behavior: [
-            "Kutu salt okunurdur (elle yazma çift tıkla açılır) ama programdan gelen change'i DİNLER: page_screenshot 'set' ile ISO tarih ('2026-08-01') ya da gösterim biçimi yazılabilir, değer takvimden seçilmiş gibi yayılır. 2026-09-15 öncesi olay dinlenmiyordu: kutu dolu görünüyor, prop boş kalıyordu (G-14)."
+            "Değer YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metnidir (dilim eki yok) ya da null. change düğümün prop'una yazar: akış değeri self.value ile okur, event.data BOŞTUR (CQ-149). 2026-09-16 öncesinde olay kaydında yük anahtarı yoktu; runtime her zaman { value } gönderiyordu.",
+            "Değer ancak TARİH + SAAT ikisi de seçilince yazılır: boş alanda takvimden yalnız gün seçmek change YAYMAZ — gün ekranda taslak kalır (kutu günü ve 00:00'ı gösterir ama self.value null'dır, required düşer — CQ-237), saat listesi kendiliğinden açılır ve saat seçilince yayılır. Günü yeniden seçmek de taslağı YAZMAZ (2026-09-16'da düzeltildi: ikinci gün seçimi …T00:00:00 yayıyordu). Alan zaten bir değer tutuyorsa (kullanıcı seçmiş ya da akış yazmış) tarihi değiştirmek TUTULAN saati koruyup hemen yayar. Gün seçmeden saat seçmek bugünün gününü kullanır ve hemen yayar. Akıştan gelen değer taslağı düşürür.",
+            "Saat listesi minutesStep adımıyla gösterilen günün (yoksa bugünün) üstünde üretilir; minDate öncesi ve maxDate sonrası saatler listede KALIR ama pasiftir. Liste minutesStep ve dil değişince yeniden üretilir (2026-09-16 öncesinde yalnız değer ya da sınır değişince yenileniyordu).",
+            "minDate/maxDate tarih-saat ANIDIR ('yyyy-MM-ddTHH:mm'): takvimde sınırın KENDİ günü seçilebilir kalır, o günün sınır dışı saatleri listede pasiftir. 2026-09-16'da düzeltildi — takvim sınırı an olarak karşılaştırıyordu, saati olan bir minDate (örn. …T14:00) kendi gününü takvimde PASİF gösteriyordu, o gün hiç seçilemiyordu. Yayma öncesi sarmalayıcı seçimi [minDate, maxDate] içine çeker (sınır dışı seçim hata VERMEZ, sınıra yapışır); akıştan yazılan değer bu kapıdan GEÇMEZ, olduğu gibi gösterilir.",
+            "Kutulara elle yazmak için çift tıklanır (tek tık takvimi / saat listesini açar). Tarih kutusu datepicker desenlerini okur (tr 'd MMM yyyy' · 'd.MM.yyyy' …, diğer dillerde 'MMM d, yyyy' · 'MM/dd/yyyy' …, her dilde ISO 'yyyy-MM-dd') ve takvimden gün seçmekle AYNI kurala girer. Saat kutusu '14:30', '14', en'de '02:30 PM' okur; okunamayan saat kutuyu tutulan saate geri çevirir, değeri bozmaz. 2026-09-16 öncesinde saat kutusu çift tıklamadan da yazılabiliyordu ve yazılan metin yok sayılıp ekranda kalıyordu.",
+            "page_screenshot 'set' kökte TARİH kutusuna yazar ve takvimden gün seçmekle aynı kuraldır: alan değer tutuyorsa tutulan saat korunup yazılır; boşsa yalnız taslak olur ve actionsReport propWritten:false döner. ISO metnindeki saat kısmı ('2026-08-01T09:30') KULLANILMAZ ve saat kutusunun iç kimliği yoktur, 'set' ile hedeflenemez (TOOL-020). Tam değeri doğrulamak için önce akıştan self.value yazın.",
+            "Doğrulama kuralları: required · min · max (2026-09-16; pattern bildirimi kaldırıldı — panel tarih-saat alanına regex kuralı hiç çizmiyordu, yazılan satırı düğüm seçilince siliyordu, CQ-226). min/max değeri 'yyyy-MM-ddTHH:mm' metnidir ve alanın minDate/maxDate prop'larından AYRIDIR: minDate/maxDate takvimi ve listeyi kısar, min/max gönderimde hata gösterir. Kurala çıplak gün ('2026-09-10') yazma — Form onu UTC okur ve UTC olmayan dilimde sınır birkaç saat kayar (CQ-252); saatiyle yaz.",
+            'focus/blur ALAN düzeyindedir (2026-09-16): tarih kutusu, saat kutusu, takvim ve saat listesi arasında dolaşmak olay yaymaz; yalnız alana girmek ve alandan çıkmak yayar. Kilitli alan (isDisabled/isReadonly/isViewmode) hiçbir olay yaymaz.',
+            'isLoading KİLİT DEĞİLDİR (2026-09-16): alan kullanılabilir kalır, sağ uçta dönen spinner çizilir (o sırada X gizlenir) ve kök aria-busy taşır. Kilit için isDisabled kullan.',
+            "Değer (ya da taslak gün) doluyken sağ uçta X çıkar; değeri boşaltıp change'i null ile yayar, yalnız taslak gün varsa taslağı düşürür ve change YAYMAZ (değer zaten boştu); kilitli kipte X yoktur. Gösterim dili locale'den (boşsa uygulama dili): tarih tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'; saat en'de 12 saat (01:00 PM), diğer dillerde 24 saat. Değer her dilde aynı 24 saatlik metindir. Biçim ve haftanın ilk günü prop'u YOK (ARC-071, CQ-098). Yalnız gün için datepicker, aralık için datetimerangepicker kullanılır."
         ],
-        propNotes: { value: DATE_VALUE_FORMAT_NOTE, locale: LOCALE_FOLLOWS_APP_NOTE }
+        propNotes: {
+            value: "Seçili an: 'yyyy-MM-ddTHH:mm:ss' ya da null. Çıplak 'yyyy-MM-dd' YEREL gece yarısı okunur (UTC kaydırması yok). Okunamayan metin alanı BOŞ gösterir, hata vermez. " + DATE_VALUE_FORMAT_NOTE,
+            minutesStep: "Saat listesinin adımı, METİN enum: '1' | '2' | '3' | '4' | '5' | '6' | '10' | '12' | '15' | '30' | '60' (varsayılan '15'). 0, negatif ya da okunamayan değer 15'e düşer; 1 dakika 1440 satır demektir.",
+            minDate: "En erken an ('yyyy-MM-ddTHH:mm'); o günün kendisi takvimde seçilebilir, günün sınırdan önceki saatleri listede pasif kalır. Sınır dışına düşen seçim sınıra çekilir.",
+            maxDate: "En geç an; o gün seçilebilir, sınırdan sonraki saatler pasif, sınır dışı seçim sınıra çekilir. Saatiyle yaz ('…T23:59'): çıplak gün ('2026-09-20') o günün 00:00'ıdır, günün geri kalanı pasif kalır.",
+            placeholder: "Boş tarih kutusunda görünen metin (varsayılan 'Select date'); kutu değeri her zaman dilin desenine göre yazar — yer tutucu bir biçim SÖZÜ DEĞİLDİR.",
+            timePlaceholder: "Boş saat kutusunda görünen metin (varsayılan 'Select time'). Taslak gün seçilince kutu 00:00 gösterir, yer tutucu görünmez (CQ-237).",
+            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); saklanan değer değişmez.',
+            valueOffset: 'YAZILAN değeri kaydıran saat sayısı; gösterim değişmez. displayOffset ile HER ZAMAN ters işaretli ver (+3 / -3): kullanıcı gösterilen saati seçer ve korur, yalnız biri verilirse her tarih değişikliğinde tutulan saat o kadar kayar.',
+            locale: LOCALE_FOLLOWS_APP_NOTE,
+            isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kök aria-busy taşır.'
+        }
     },
-    datetimepicker: { summary: 'Tarih+saat seçici; değer event.data’da değil self.value’dadır.', propNotes: { value: DATE_VALUE_FORMAT_NOTE, locale: LOCALE_FOLLOWS_APP_NOTE } },
     daterangepicker: {
-        summary: 'Tarih aralığı; change yükü { valueFrom, valueTo, HH, mm }.',
-        behavior: [
-            "İki kutu ayrı adreslenir: '<elementId>__start' (valueFrom) ve '<elementId>__end' (valueTo). page_screenshot 'set' kökü REDDEDER (tek değer yok); kutuya ISO tarih ('2026-08-01') ya da gösterim biçimi ('1 Ağu 2026') yazılır, kutu değeri kendi change yoluna sokar ve prop'a yazar. Okunamayan metin kutuyu tutulan değere geri çevirir; actionsReport propWritten:false döner (G-14, 2026-09-15)."
+        summary: 'GÜN aralığı (saat yok): değer valueFrom/valueTo İKİLİSİDİR (tek value yok); her yarı bir takvim + yazılabilir kutu; change yükü { valueFrom, valueTo }.',
+        behavior: [
+            "İki uç da YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metnidir (dilim eki yok; seçimde saat 00:00, gece yarısı yaşanmayan yaz saati günlerinde 01:00) ya da null. change her iki anahtarı birden taşır ve düğümün prop'una yazar: akış self.valueFrom / self.valueTo ile okur, event.data BOŞTUR (CQ-149). Form aralığı { valueFrom, valueTo } nesnesi olarak görür; required ancak İKİSİ de doluyken geçer. 2026-09-16 öncesinde bu kayıt yükte HH ve mm anahtarları da olduğunu söylüyordu — runtime hiç göndermiyordu.",
+            "minDate/maxDate GÜN sınırıdır ('yyyy-MM-dd'): ikisi de KENDİ günü dahil seçilebilir kalır. Takvimler de gün olarak karşılıklı sınırlanır: bitiş takvimi başlangıç GÜNÜNDEN, başlangıç takvimi bitiş GÜNÜNE kadar açıktır — aynı gün başlayıp biten tek günlük aralık seçilebilir. 2026-09-16'da düzeltildi: çıplak gün metni UTC gece yarısı okunuyordu, Greenwich'in doğusunda (TR: +03) minDate'in kendi günü takvimde PASİF görünüyor ve sınıra çekilen değer 03:00 yazılıyordu, batısında maxDate'in kendi günü pasifti; saatli bir başlangıç (displayOffset, akıştan saatli değer) bitiş takviminde kendi gününü kapatıyordu.",
+            "Yayma öncesi sarmalayıcı çifti üç adımda kurar: (1) her uç [minDate, maxDate] günlerinin içine çekilir (sınır dışı yazılan tarih o sınır gününün gece yarısına yapışır, hata VERMEZ); (2) DEĞİŞEN uç seçilen günden valueOffset kaydırılarak yazılır, DOKUNULMAYAN uç tuttuğu değerle yazılır (kırpma onu taşımadıysa) — aynı günü yeniden seçmek de değişikliktir; (3) sıra YAZILAN değerler üzerinde uygulanır: bitiş başlangıçtan önceyse başlangıca eşitlenir, yani kullanıcı değişikliğinden sonra valueFrom <= valueTo her zaman tutar. Bu yüzden başlangıç saat taşıyorsa (akış '…T10:00:00' yazmışsa) aynı günde biten aralığın bitişi de o saati alır. 2026-09-16 öncesinde iki uç da GÖSTERİLEN hâlinden yeniden türetiliyordu: yalnız displayOffset ya da yalnız valueOffset verilmiş alanda dokunulmayan uç her seçimde o kadar saat kayıyordu. Akıştan yazılan değerler bu kapıdan GEÇMEZ, olduğu gibi gösterilir (ta ki kullanıcı bir yarıyı değiştirene dek); çıplak 'yyyy-MM-dd' YEREL gece yarısı okunur, okunamayan metin yarıyı BOŞ gösterir.",
+            "Başlangıç seçilince ve bitiş boşsa bitiş takvimi kendiliğinden açılır. Her seçim popup'ı kapatır ve change'i hemen yayar — onay adımı yoktur. Her yarının kendi X'i vardır ve yalnız o yarıyı boşaltır (change o yarı null, diğeri olduğu gibi); kilitli kipte X yoktur.",
+            "Kutuya elle yazmak için çift tıklanır (tek tık takvimi açar); okunan desenler datepicker ile aynıdır (tr 'd MMM yyyy' · 'd.MM.yyyy' · 'dd.MM.yyyy' …, diğer dillerde 'MMM d, yyyy' · 'MM/dd/yyyy' …, her dilde ISO 'yyyy-MM-dd'). İki kutu ayrı adreslenir: '<elementId>__start' (valueFrom) ve '<elementId>__end' (valueTo). page_screenshot 'set' kökü REDDEDER (tek değer yok); kutuya ISO tarih ('2026-08-01') ya da gösterim biçimi ('1 Ağu 2026') yazılır, kutu değeri kendi change yoluna sokar ve prop'a yazar. Okunamayan metin kutuyu tutulan değere geri çevirir; actionsReport propWritten:false döner (G-14, 2026-09-15).",
+            "Doğrulama kuralları: required · min · max (2026-09-16; pattern bildirimi kaldırıldı — panel tarih alanına regex kuralı hiç çizmiyordu, yazılan satırı düğüm seçilince siliyordu, CQ-226). min/max değeri gün metnidir, Form aralığın İKİ ucunu da sınırla karşılaştırır ve alanın minDate/maxDate prop'larından AYRIDIR: minDate/maxDate takvimi kısar, min/max gönderimde hata gösterir. DİKKAT (CQ-252): Form kuralın gün metnini UTC, alanın değerini YEREL okuyor, yani UTC olmayan her dilimde SINIR GÜNÜNÜN KENDİSİ yanlış tarafta kalıyor. Bugünkü güvenli yol: kural yerine minDate/maxDate kullanmak ya da sınırı bir gün geniş tutmak.",
+            "focus/blur ALAN düzeyindedir (2026-09-16): iki kutu ve iki takvim arasında dolaşmak olay yaymaz; yalnız alana girmek ve alandan çıkmak yayar. Kilitli alan (isDisabled/isReadonly/isViewmode) hiçbir olay yaymaz.",
+            "isLoading KİLİT DEĞİLDİR (2026-09-16): alan kullanılabilir kalır, iki yarının X'i yerinde durur, satırın sağ ucunda dönen spinner çizilir ve kutu aria-busy taşır (450px altındaki dikey yığılmada spinner çizilmez, aria-busy kalır). Kilit için isDisabled kullan.",
+            "Gösterim dili locale'den (boşsa uygulama dili): tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'. Değer her dilde aynı metindir. Biçim ve haftanın ilk günü prop'u YOK (ARC-071). Saat gerekiyorsa datetimerangepicker, tek gün gerekiyorsa datepicker kullanılır."
         ],
-        propNotes: { valueFrom: DATE_VALUE_FORMAT_NOTE, valueTo: DATE_VALUE_FORMAT_NOTE, locale: LOCALE_FOLLOWS_APP_NOTE }
+        propNotes: {
+            valueFrom: "Başlangıç günü: 'yyyy-MM-ddTHH:mm:ss' ya da 'yyyy-MM-dd' metni, ya da null. Çıplak gün YEREL okunur (UTC kaydırması yok). " + DATE_VALUE_FORMAT_NOTE,
+            valueTo: "Bitiş günü; valueFrom ile aynı biçim. Akıştan başlangıçtan önce bir bitiş yazılırsa olduğu gibi gösterilir — sıra kuralı yalnız kullanıcı seçiminde uygulanır.",
+            minDate: "En erken gün ('yyyy-MM-dd'); o günün kendisi iki takvimde de seçilebilir, öncesi pasif kalır.",
+            maxDate: 'En geç gün; o günün kendisi seçilebilir, sonrası pasif kalır.',
+            startPlaceholder: "Başlangıç kutusu boşken görünen metin; varsayılanı '01.01.2000' ama kutu değeri her zaman dilin desenine göre yazar (tr '10 Eyl 2026', diğer diller 'Sep 10, 2026') — yer tutucu bir biçim SÖZÜ DEĞİLDİR.",
+            endPlaceholder: "Bitiş kutusunun yer tutucusu; startPlaceholder ile aynı kural (varsayılan '05.01.2000').",
+            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); saklanan değer değişmez. Gün sınırına yakın bir değeri komşu güne kaydırabilir.',
+            valueOffset: 'DEĞİŞEN ucu yazarken kaydıran saat sayısı; dokunulmayan uç tuttuğu değerle kalır. Gösterim yazılan değerden okunduğu için tek başına verilirse ekranda da görünür (-3: 15 seçilir, \'…14T21:00:00\' yazılır, kutu 14 gösterir) ve min/max kurallarının karşılaştırdığı değeri de kaydırır. Bir dilim farkını sabit tutmak için displayOffset ile ters işaretli kullanılır (+3 / -3).',
+            locale: LOCALE_FOLLOWS_APP_NOTE,
+            isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kutu aria-busy taşır.'
+        }
     },
     datetimerangepicker: {
         summary: 'Tarih+saat aralığı: değer valueFrom/valueTo İKİLİSİDİR (tek value yok); her yarı bir takvim + dakika adımlı saat listesi; change yükü { valueFrom, valueTo }.',
         behavior: [
             "İki uç da YEREL duvar saati 'yyyy-MM-ddTHH:mm:ss' metnidir (dilim eki yok) ya da null. change her iki anahtarı birden taşır ve düğümün prop'una yazar: akış self.valueFrom / self.valueTo ile okur. Form aralığı { valueFrom, valueTo } nesnesi olarak görür; required ancak İKİSİ de doluyken geçer.",
             "Bir yarının değeri ancak TARİH + SAAT ikisi de seçilince yazılır: takvimden yalnız gün seçmek change YAYMAZ — gün ekranda taslak olarak kalır (kutu günü ve 00:00'ı gösterir, CQ-237), günü yeniden seçmek de, diğer yarıyı tamamlamak da o taslağı YAZMAZ; saat listesi kendiliğinden açılır ve saat seçilince yayılır (tek datetimepicker ile aynı kural). Yarı zaten bir değer tutuyorsa (kullanıcı seçmiş ya da akış yazmış) tarihi değiştirmek TUTULAN saati koruyup hemen yayar — 2026-09-12'de düzeltildi, öncesinde listeden saat seçildikten sonra tarih değişikliği ekranda görünüp değere hiç yazılmıyordu. Akıştan gelen değer taslağı düşürür.",
-            "Saat listeleri minutesStep adımıyla o yarının GÜNÜ üstünde üretilir; minDate/maxDate DIŞI ve karşı ucun ÖTESİNDEKİ saatler (başlangıç için bitişten sonrası, bitiş için başlangıçtan öncesi) listede KALIR ama pasiftir. Takvimler de karşılıklı sınırlanır: bitiş takvimi başlangıç gününden önceye, başlangıç takvimi bitiş gününden sonraya izin vermez.",
-            "Yayma öncesi sarmalayıcı sınırlar: her uç [minDate, maxDate] içine çekilir, bitiş başlangıçtan önce kalırsa bitiş başlangıca eşitlenir. Sınır dışı bir seçim hata VERMEZ, sınıra yapışır. Akıştan yazılan değerler bu kapıdan GEÇMEZ, olduğu gibi gösterilir.",
+            "Saat listeleri minutesStep adımıyla o yarının GÜNÜ üstünde üretilir; minDate/maxDate DIŞI ve karşı ucun ÖTESİNDEKİ saatler (başlangıç için bitişten sonrası, bitiş için başlangıçtan öncesi) listede KALIR ama pasiftir. Takvimler GÜN olarak sınırlanır: bitiş takvimi başlangıç GÜNÜNDEN önceye, başlangıç takvimi bitiş GÜNÜNDEN sonraya, ikisi de minDate/maxDate GÜNLERİNİN dışına izin vermez — sınırın KENDİ günü her zaman seçilebilir, saat düzeyindeki sınır yalnız listede ve kırpmada uygulanır (2026-09-16; öncesinde saat taşıyan sınırın kendi günü takvimde pasifti: başlangıç 10:30 iken aynı gün biten aralık, minDate 09:00 iken o gün seçilemiyordu).",
+            "Yayma öncesi sarmalayıcı sınırlar: her uç [minDate, maxDate] ANINA çekilir; bir yarı değişince DOKUNULMAYAN uç kırpma onu taşımadıkça tuttuğu değerle yazılır; sıra YAZILAN çift üzerinde uygulanır, bitiş başlangıçtan önce kalırsa başlangıca eşitlenir. Sınır dışı bir seçim hata VERMEZ, sınıra yapışır. Akıştan yazılan değerler yazıldıkları anda bu kapıdan GEÇMEZ, olduğu gibi gösterilir; ama HANGİ yarıda olursa olsun bir sonraki kullanıcı seçimi onları da kırpar/sıraya sokar (sınır dışı uç sınıra, başlangıçtan önceki bitiş başlangıca) ve dokunulmayan ucu yayılan biçimde ('yyyy-MM-ddTHH:mm:ss', çıplak gün '…T00:00:00') yeniden yazar. Etkinleşen sınır günlerinin yan etkisi: tutulan saat o günde sınırın dışına düşerse (başlangıç 10:30, bitiş ertesi gün 09:00 → bitişte başlangıç günü seçilir) uç sessizce sınıra çekilir; sınırı günün son adımından geç olan gün (minDate 23:50, adım 15) seçilebilir ama listede seçilebilir saat yoktur, saat elle yazılır. 2026-09-16'ya kadar iki uç da gösterilen hâlinden yeniden türetiliyordu: yalnız displayOffset ya da yalnız valueOffset verilmiş alanda dokunulmayan uç her seçimde o kadar saat kayıyordu.",
             "Doğrulama kuralları: required · min · max (2026-09-12; pattern bildirimi kaldırıldı — panel tarih-saat alanına regex kuralı hiç çizmiyordu, yazılan satırı düğüm seçilince siliyordu). min/max değeri 'yyyy-MM-ddTHH:mm' tarih-saat metnidir ve Form aralığın İKİ ucunu da sınırla karşılaştırır.",
             "focus/blur ALAN düzeyindedir (2026-09-12): iki tarih girdisi, iki saat girdisi, takvim ve saat listesi arasında dolaşmak olay yaymaz; yalnız alana girmek ve alandan çıkmak yayar. Kilitli alan (isDisabled/isReadonly/isViewmode) hiçbir olay yaymaz.",
             "isLoading KİLİT DEĞİLDİR (2026-09-12): alan odaklanabilir kalır, sağ uçta dönen spinner çizilir, kök aria-busy taşır (478px altındaki dikey yığılmada spinner çizilmez, aria-busy kalır). Kilit için isDisabled kullan.",
-            "Her yarının kendi X'i vardır ve yalnız o yarıyı boşaltır (change o yarı null, diğeri olduğu gibi). İkisini birden boşaltmanın yolu iki X ya da akıştan iki prop'u null yazmaktır.",
+            "Her yarının kendi X'i vardır ve yalnız o yarıyı boşaltır (change o yarı null, diğeri tuttuğu değerle yazılır). Yalnız taslak gün tutan yarının X'i taslağı siler ama change YAYMAZ — değer zaten boştu (2026-09-16; öncesinde değişmeyen değerle change yayıyordu). İkisini birden boşaltmanın yolu iki X ya da akıştan iki prop'u null yazmaktır.",
             "Gösterim dili locale'den (boşsa uygulama dili): tarih tr'de 'd MMM yyyy', diğer dillerde 'MMM d, yyyy'; saat en'de 12 saat (01:00 PM), diğer dillerde 24 saat. Değer her dilde aynı 24 saatlik metindir. Biçim prop'u YOK (ARC-071).",
             "Tarih kutuları '<elementId>__start' / '<elementId>__end' ile adreslenir (G-14, 2026-09-15). page_screenshot 'set' kökü reddeder; kutuya ISO tarih yazmak takvimden gün seçmekle AYNI kuraldır: yarı değer tutmuyorsa yalnız taslak olur ve propWritten:false döner — saat kutusu ayrıca hedeflenemez, önce akıştan değer yazın ya da saati tıklamayla seçin."
         ],
         propNotes: {
-            valueFrom: "Başlangıç: 'yyyy-MM-ddTHH:mm:ss' ya da null. Akıştan yazarken bu biçimi (ya da Date'in okuduğu bir ISO metnini) kullan; okunamayan metin yarıyı BOŞ gösterir, hata vermez.",
-            valueTo: "Bitiş; valueFrom ile aynı biçim. Akıştan başlangıçtan önce bir bitiş yazılırsa olduğu gibi gösterilir — sıra kuralı yalnız kullanıcı seçiminde uygulanır.",
+            valueFrom: "Başlangıç: 'yyyy-MM-ddTHH:mm:ss' ya da null. Akıştan yazarken bu biçimi (ya da Date'in okuduğu bir ISO metnini) kullan; çıplak 'yyyy-MM-dd' o günün YEREL gece yarısıdır (2026-09-16'ya kadar UTC okunuyordu, TR'de 03:00 görünüyordu); okunamayan metin yarıyı BOŞ gösterir, hata vermez.",
+            valueTo: "Bitiş; valueFrom ile aynı biçim. Akıştan başlangıçtan önce bir bitiş yazılırsa olduğu gibi gösterilir — sıra kuralı kullanıcı seçiminde uygulanır: hangi yarıda olursa olsun bir sonraki seçim bitişi başlangıca çeker.",
             minutesStep: "Saat listelerinin adımı, METİN enum: '1' | '2' | '3' | '4' | '5' | '6' | '10' | '12' | '15' | '30' | '60' (varsayılan '15'). 0, negatif ya da okunamayan değer 15'e düşer; 1 dakika 1440 satır demektir.",
-            minDate: "En erken tarih-saat ('yyyy-MM-ddTHH:mm:ss'); öncesi takvimde ve saat listesinde pasif kalır, yine de sınır dışına düşen seçim sınıra çekilir.",
-            maxDate: 'En geç tarih-saat; sonrası pasif, sınır dışı seçim sınıra çekilir.',
-            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); saklanan değer değişmez.',
-            valueOffset: 'YAZILAN değeri kaydıran saat sayısı; gösterim değişmez. Bir dilim farkını sabit tutmak için displayOffset ile ters işaretli kullanılır (+3 / -3): kullanıcının gördüğü saat seçtiği saattir, saklanan değer sabit kalır.',
+            minDate: "En erken tarih-saat ('yyyy-MM-ddTHH:mm:ss'); takvimde o GÜNÜN öncesi, saat listesinde o ANIN öncesi pasif kalır (kendi günü seçilebilir); sınır dışına düşen seçim sınır anına çekilir.",
+            maxDate: 'En geç tarih-saat; takvimde o GÜNÜN sonrası, saat listesinde o ANIN sonrası pasif (kendi günü seçilebilir); sınır dışı seçim sınır anına çekilir.',
+            displayOffset: 'GÖSTERİMİ kaydıran saat sayısı (+3: saklanan değeri üç saat ileri göster); yalnız gösterilir, yazmada geri alınmaz — seçilen/korunan saat GÖSTERİLEN saattir. valueOffset ile ters işaretli verilmezse bir yarının tarihini değiştirmek o yarının saklanan saatini her seferinde +3 kaydırır (…06T18:00 → …07T21:00 → …08T00:00).',
+            valueOffset: "DEĞİŞEN ucu yazarken kaydıran saat sayısı; dokunulmayan uç tuttuğu değerle kalır (2026-09-16'ya kadar o uç da her seçimde kayıyordu). Gösterim yazılan değerden okunduğu için tek başına verilirse ekranda da görünür (-3: 15:00 seçilir, '…T12:00:00' yazılır, kutu 12:00 gösterir) ve değişen yarının tarihini her değiştirmede saati o kadar kaydırır. displayOffset ile HER ZAMAN ters işaretli ver (+3 / -3): kullanıcı gösterilen saati seçer ve korur, saklanan değer sabit kalır.",
             locale: LOCALE_FOLLOWS_APP_NOTE,
             isLoading: 'Akıştan açılır; alan kilitlenmez, yalnız spinner çizilir ve kök aria-busy taşır.'
         }
@@ -570,10 +632,20 @@ export const componentKnowledge = {
     filebutton: { summary: 'Buton görünümlü dosya seçici; fileInput ile aynı yük.' },
     'file-viewer': { summary: 'Dosya önizleyici (pdf/görsel); file prop’una drive dosyası bağlanır.', propNotes: { surfaceStyle: NODE_SURFACE_NOTE } },
     button: {
-        summary: 'Tıklama kaynağı; click olayı veri taşımaz, bağlam gerekiyorsa ifadede komponent adlarıyla okunur.',
+        summary: "Tıklama kaynağı; type üç işten birini seçer — 'button' click akışını çalıştırır, 'submit' bir Form'u gönderir, 'link' bir adrese gider. click olayı veri taşımaz, bağlam gerekiyorsa ifadede komponent adlarıyla okunur.",
+        behavior: [
+            "click YALNIZ type:'button' iken yayılır. type:'submit' click YAYMAZ, formu gönderir: akışı butona değil formun submit olayına bağla (form doğrulaması geçerse yayılır). type:'link' de click yaymaz, tarayıcı href'e gider.",
+            "type:'submit' buton bir Form'un İÇİNDEYSE formId gerekmez, tarayıcı en yakın forma bağlar; formun DIŞINDAYSA formId = formun elementId'si ya da adı. isDisabled/isLoading açıkken gönderim de kilitlidir.",
+            "href ve isNewTabLink YALNIZ type:'link' iken okunur — href doldurmak butonu link yapmaz. İç sayfaya link için href'e URL değil { type:'page', ref:<pageId> } Prop'u yaz. Link kilitliyken (isDisabled/isLoading) ya da href boşken hiçbir yere gitmez ve odak almaz; kilit kalkınca ya da href akışla değişince adres anında güncellenir (2026-09-11 öncesi ilk çizimdeki adreste donuyordu: kilitli açılan link hep ölü kalıyordu).",
+            "Kayıtlı sayfalardaki eski kind:'custom' + customColor ikilisi VERİ GÖÇÜ OLMADAN aynen çizilir (render-anı takma adı, text emsali): surfaceStyle.background boşsa eski renk `--ng-btn-custom-color` değişkeniyle solid/outline/text varyantına eskisi gibi iner; Background doldurulunca takma ad susar. page_runtime_get(resolveStyles:true) bu değişkeni resolvedStyle'da gösterir. DİKKAT: platformun doğrulama duvarı sayfanın TAMAMINI okur — böyle bir düğüm taşıyan sayfaya yapılan her page_schema_patch, dokunulmayan düğüm yüzünden invalid-enum-value/unknown-prop ile reddedilir (ARC-036). Sayfayı yeniden yazmadan önce o butonu kind: semantik değer + surfaceStyle.background'a çevir (aynı çağrıda replace_prop ile).",
+            "İpucu (tooltip) prop'u YOKTUR: düğümün ortak appearance.tooltip alanı (+ tooltipPosition: top · bottom · left · right) her komponentte ipucu çizer. Tıklamadan önce onay istemek de butonun değil akışın işidir: click akışının başına confirm adımı koy (yalnız web — mobil barındırıcıda confirm adımı yok)."
+        ],
         propNotes: {
-            kind: "primary | info | success | warning | error | custom — 'custom' seçilirse renk customColor'dan gelir. `datatable.actions[].kind` FARKLI bir sözlük kullanır (error · information · solid · transparent · dark · danger · warning) — buradan bir değer (örn. 'transparent') butona yazılırsa invalid-enum-value verir.",
-            customColor: "Yalnız kind:'custom' iken okunur; hex ya da tema token'ı ('var(--ng-accent-primary)').",
+            kind: "primary | info | success | warning | error — beş semantik renk, temayı izler; temizlenirse (null) primary çizilir. ÖZEL ZEMİN için kind değil surfaceStyle.background yazılır (Dalga 4, 2026-09-14): eski custom seçeneği ve customColor şemadan kalktı, yazılırsa invalid-enum-value / unknown-prop. `datatable.actions[].kind` FARKLI bir sözlük kullanır (error · information · solid · transparent · dark · danger · warning) — buradan bir değer (örn. 'transparent') butona yazılırsa invalid-enum-value verir.",
+            icon: "{ name: 'save', color? } nesnesi; düz 'save' metni de okunur (AI sözlüğü icon'u string gösteriyor — CQ-164). Adı boş ya da temizlenmiş ikon hiç çizilmez. Yükleniyorken ikonun yerinde spinner döner (link tipinde spinner yok).",
+            iconPosition: "'left' (varsayılan) | 'right' — ikonun (ve yükleniyorken spinner'ın) metnin hangi yanında durduğu; ikon yokken etkisiz.",
+            align: "'none' (varsayılan) butonu hücrenin TÜM genişliğine yayar; 'left' · 'center' · 'right' butonu içerik kadar daraltıp yaslar. Temizlenirse (null) 'none' sayılır.",
+            surfaceStyle: STYLE_GROUP_NOTES.surfaceStyle + ' ' + STYLE_GROUP_NOTES.colorTokens + " Buton yüzeyi (contentOverflow YOK — kaydırılan içerik yok). Her alan kind/variant CSS'inin ÜSTÜNE biner (tasarımcı kazanır): background Outline/Text varyantında da zemini doldurur ve o varyantların kind renkli hover dolgusu görünmez olur; shadow hover/active'de sabit kalır; opacity devre dışı görünümünü (0.5) de ezer. Metin rengi kind'dan gelir, burada alan yok — açık bir zeminde okunur kalması için style: { color: '…' }.",
             badgeValue: "Butonun köşe rozetinin metni ('3', '99+'); boşsa rozet çizilmez. Rengi badgeColor'dan gelir (primary|info|success|warning|error, varsayılan 'error')."
         }
     },
@@ -584,11 +656,11 @@ export const componentKnowledge = {
         summary: 'Görsel + başlık + açıklama + buton metni taşıyan hazır KART; click yayar.',
         behavior: [
             "KAPSAYICI DEĞİLDİR: çocuk kabul etmez (not-droppable). Kutu içinde serbest içerik göstermek için container kullanın (istenirse states.isWrapper:true).",
-            'Yükseklik 10-50 aralığındadır (min 10, max 20 varsayılan, max 50); aralık dışı blocks[].size.h invalid-size ile reddedilir.'
+            'Yükseklik 10-50 aralığındadır (min 10, max 20 varsayılan, max 50). Bu sınır grid kanvasının kuralıdır, API aralık dışı blocks[].size.h değerini reddetmez; yine de aralıkta tutun.'
         ]
     },
     'qm-card': { summary: 'QM gösterge kartı; click yayar.' },
-    tabs: { summary: 'Sekmeler; tab olayı seçilen sekme anahtarını taşır, her view children sırasıyla eşleşir.', propNotes: { surfaceStyle: NODE_SURFACE_NOTE } },
+    tabs: { summary: "Sekmeler; tab olayı seçilen sekme anahtarını taşır, her view children sırasıyla eşleşir. Etkin OLMAYAN sekmenin içeriği DOM'da YOKTUR (keepAlways dışında): o sekmedeki bir düğümü hedefleyen doğrulama önce page_screenshot actions { action: 'tab', value: '<sekme anahtarı>' } ister — sekme grubunun köküne click ilk sekmeye gider ve reddedilir.", propNotes: { surfaceStyle: NODE_SURFACE_NOTE } },
     'collapsible-container': { summary: 'Aç/kapa kapsayıcı; collapsed/expanded olayları yayar.', propNotes: { surfaceStyle: NODE_SURFACE_NOTE } },
     'tree-view': {
         summary: 'Hiyerarşik liste: data ağacını çizer, satır tıklamasını click olayıyla akışa verir, satır başına aksiyon menüsü ve isteğe bağlı istemci-tarafı arama taşır.',
@@ -615,7 +687,7 @@ export const componentKnowledge = {
     text: {
         summary: 'Tek satırlık metin gösterimi; değer type:code prop’uyla ifadeye bağlanabilir. Görünümü TİPLİ stil gruplarındadır (typographyStyle · surfaceStyle), ham CSS değil.',
         behavior: [
-            "Yükseklik SABİTTİR: maxSize.h = 1 (katalog varsayılanı 8'dir ve olduğu gibi kopyalanırsa reddedilir; gateway 1'e çeker ve gatewayNormalized ile bildirir). Çok satırlı metin için textarea ya da html kullanın.",
+            "Yükseklik SABİTTİR: maxSize.h = 1 (katalog varsayılanı 8'dir ve olduğu gibi kopyalanırsa kanvasta boyutlandırılamaz; gateway 1'e çeker ve gatewayNormalized ile bildirir). Çok satırlı metin için textarea ya da html kullanın.",
             "type HTML etiketi + ölçek seviyesidir (h1|h2|h3|label|p|small; a11y için doğru seviyeyi seç). Punto/kalınlık/renk/hiza kararı typographyStyle'dadır: fontSize seviyenin puntosunu ezer, boş bırakılırsa seviye ölçeği (tema --ng-font-size-*) geçerlidir.",
             "EMEKLİ prop'lar: isBold, align, color, customColor şemada YOK — yazılırsa unknown-prop ile reddedilir. Karşılıkları: typographyStyle.fontWeight ('600'), textAlign, textColor (semantik renk için tema token'ı: var(--ng-status-success) gibi). Kayıtlı eski sayfalarda bu prop'lar render anında takma adla çözülür (resolvedStyle bunu gösterir), yeni yazımda kullanılmaz.",
             "Hover grubu yok (metnin hover semantiği yok); surfaceStyle etiket/vurgulu paragraf içindir (zemin, köşe, çerçeve, gölge) ve contentOverflow alanı yoktur (taşma hedefi yok).",
@@ -644,7 +716,25 @@ export const componentKnowledge = {
             isHidden: 'Şemada tanımlıdır; statik true ile gizli başlatılır, akıştaki setter ile açılıp kapanır. Komponent kendi kapanışında da bu prop\'a yazar.'
         }
     },
-    'form-validation-errors': { summary: 'Formun doğrulama hatalarını listeler; form.errorElementId buraya işaret eder.' },
+    'form-validation-errors': {
+        summary: 'Formun doğrulama hatalarını tek kutuda listeler; form.errorElementId buraya işaret eder. Liste boşken hiçbir şey çizmez.',
+        behavior: [
+            "BAĞLAMA: form'un errorElementId prop'una bu düğümün elementId'sini HER ZAMAN yaz. Yazılmazsa Form yalnız KENDİ İÇİNDEKİ ve elementId'si 'formvalidation-errors' ile başlayan düğümü bulur — o önek yalnız studio kenar çubuğundan sürüklenen düğümde oluşur; MCP ile kurulan, kopyalanan ya da formun dışına konan liste bulunmaz ve hiç dolmaz (docs/issues.md CQ-259).",
+            'Listeyi Form doldurur: ilk submit’ten sonra hatalı alanları yazar, sonra her alan değişikliğinde listeyi yeniden yazar (düzelen alan düşer); başarısız submit’te kutuya kaydırır. resetForm listeyi de siler. Liste boşken bileşen DOM’a hiçbir şey basmaz.',
+            "errors öğesi { id, label, message }: id hatalı alanın elementId'si, label alan adı, message metin. Aynı id'li hatalar alan adının altında tek grupta toplanır. id'si olan satır düğmedir — tıklanınca alan kapalı bir sekmedeyse o sekme açılır, alana odaklanılır, kaydırılır ve 2 sn vurgulanır; id'siz satır düz metindir ve gruplanmaz. Dizi yerine düz metin öğesi ('Kayıt reddedildi') { message } sayılır; message'ı boş öğe ve dizi olmayan değer (null) çizilmez.",
+            'Sunucu hatalarını (ör. 422 yanıtı) göstermek için akıştan setter ile errors yaz — Form’un yazdığıyla aynı biçim. Form bir sonraki submit/alan değişikliğinde listeyi kendi sonucuyla EZER.',
+            "message DÜZ METİN olarak basılır (2026-09-16'ya kadar HTML yorumlanıyordu; akıştan gelen metinde betik çalışabilirdi) — alanın kendi hata metniyle aynı. label'daki HTML etiketleri sökülür.",
+            "Paneldeki errors listesi yalnız KANVAS ÖNİZLEMESİDİR: sayfa açılınca düğümde statik değer silinir (2026-09-16'ya kadar yalnız bileşenin yerel kopyası siliniyordu ve düğümün başka bir prop'u — title, isHidden — akıştan değişince 'Username / Zip / Expiration date' örnekleri canlı sayfada beliriyordu). {{ }} ile bağlı errors silinmez. Silme düğüm başına bir kez yapılır: sekme değişimi ya da isHidden ile yeniden takılan liste Form'un yazdığı hataları korur.",
+            "Kutu role='alert' taşır: belirdiğinde ekran okuyucu içeriği duyurur; ikonlar okunmaz. Satır düğmelerinin klavye odak halkası vardır.",
+            'Olay: yalnız mount (render katmanı atar); tıklama olayı yoktur, satır tıkı alana gider.'
+        ],
+        propNotes: {
+            title: "Kutunun başlığı (kırmızı, listenin üstünde); boşsa başlık satırı çizilmez. Varsayılan 'Please review the form and correct the following errors.' — 2026-09-16'ya kadar 'formula' yazım hatasıyla bırakılıyordu, eski düğümler kendi değerini taşır.",
+            errors: "Çalışma anında Form'a (ya da setter yazan akışa) aittir: [{ id, label, message }]. Statik değer yalnız kanvas önizlemesidir ve sayfa açılınca silinir — kalıcı bir mesaj için notification kullan.",
+            hideFormValidationMessage: "true → Form alanların altındaki hata metnini yazmaz, yalnız kırmızı çerçeve kalır; mesajlar yalnız bu listede görünür. Form bunu BU düğümden okur, yani errorElementId bağlı değilse etkisizdir. Kanvasta görünür etkisi yoktur.",
+            style: STYLE_GROUP_NOTES.styleEscape + " Parçalar: KÖK (anahtarlar doğrudan style'da) kırmızı kutudur — zemin (--ng-red-50), çerçeve (--ng-red-200), köşe; '&__title' başlık metni. Satır sınıfları belgelenmemiştir."
+        }
+    },
     breadcrumb: { summary: 'Sayfa yolu; currentTitle setter ile kip etiketine (Yeni/Düzenle) çevrilir.' },
     'page-header': {
         summary: 'Sayfa başlığı bandı; yalnız mount yayar.',
@@ -756,7 +846,7 @@ export const componentKnowledge = {
         behavior: [
             "Layout'ta TEK slot olmalı. Enjeksiyon HER slot'a ayrı ayrı kopyalar (layout.functions.ts injectPageSchemaIntoSlots ağacı dolaşır ve type==='slot' gören her düğümün children'ına sayfa şemasının klonunu yazar; önizleme tarafında page.mappers.mapPageLayoutToPreview aynısını yapar): iki slot = sayfa iki kez çizilir, elementId'ler çakışır. Doğrulama: page_state.layoutSlots.",
             "Slot'un yerleşimi ızgara bloğundan gelir ve satır yüksekliği AÇIK UÇLUDUR — runtime slot için grid-row'u `y / auto` yazar (render.functions.ts), yani sayfa içeriği ne kadar uzarsa slot o kadar uzar. Slot'a sabit yükseklik vermeye çalışmak anlamsızdır.",
-            "Blok boyu yine de katalog sınırının içinde kalmalı: maxSize.h 200 (2026-09-12'den önce 80'di ve katalog varsayılanı 110 bile sınırın dışındaydı). Sınırı aşan TEK blok bütün yerleşimi/sayfayı PageSchemaValidationException + `invalid-size` ile düşürür."
+            "Blok boyu yine de katalog sınırının içinde kalmalı: maxSize.h 200 (2026-09-12'den önce 80'di ve katalog varsayılanı 110 bile sınırın dışındaydı). Bu sınır grid kanvasının kuralıdır; API blok boyunu denetlemez, ama sınırı aşan blok kanvasta boyutlandırılamaz."
         ]
     },
     view: { summary: 'Tabs/switcher altındaki görünüm kapsayıcısı; children gruplamaya yarar.' },
@@ -1363,6 +1453,11 @@ export const INTERNAL_ROLES_BY_TYPE = {
         'allday-<yyyy-MM-dd> (tüm gün hücresi, bırakma hedefi)',
         'slot-<yyyy-MM-dd>T<HH> (saat dilimi, bırakma hedefi)'
     ],
+    // Sekme butonu kimliğini sekmenin KEY'inden alır (başlık çeviriye bağlıdır, dil değişince
+    // kayardı). Kök düğüme click DOM sırasındaki ilk sekmeye gider; seçim `tab` eyleminin işidir.
+    tabs: [
+        "tab-<sekme anahtarı>"
+    ],
     daterangepicker: [
         'start (başlangıç tarihi kutusu, valueFrom)',
         'end (bitiş tarihi kutusu, valueTo)'

package/dist/knowledge/componentEvents.js

@@ -21,7 +21,7 @@ export const componentEventContracts = {
     datatable: {
         mount: { payload: {}, reads: 'self.filters · self.sortField · self.sortType · self.offset · self.limit' }
     },
-    button: { click: NO_DATA },
+    button: { mount: NO_DATA, click: NO_DATA },
     card: { click: NO_DATA },
     compound: { click: NO_DATA },
     image: { click: NO_DATA },
@@ -144,9 +144,40 @@ export const componentEventContracts = {
     dropdown: { mount: NO_DATA, change: { payload: { value: 'seçilen option değeri', selectedLabel: "seçilen option'ın label metni (temizlemede '')" } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
     'multi-select': { mount: NO_DATA, change: { payload: { value: "seçilen değerlerin dizisi: [{ value, label, id, text }] — id/text, value/label'ın eski adlı ikizleridir" } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
     'tag-input': { mount: NO_DATA, change: { payload: { value: 'etiket dizisi: [{ value, color? }] — renk verilmemiş etikette color anahtarı HİÇ bulunmaz' } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
-    datepicker: { mount: NO_DATA, change: { payload: { value: 'string (tarih)', HH: 'string', mm: 'string' } } },
-    datetimepicker: { mount: NO_DATA, change: { payload: {}, reads: 'self.value' } },
-    daterangepicker: { mount: NO_DATA, change: { payload: { valueFrom: 'string', valueTo: 'string', HH: 'string', mm: 'string' } } },
+    datepicker: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                value: "string 'yyyy-MM-ddTHH:mm:ss' | null (yerel duvar saati, dilim eki yok; seçimde saat 00:00, X ile boşaltılınca null)"
+            },
+            reads: "düğümün prop'una yazılır: self.value. HH/mm anahtarları YOKTUR (2026-09-15'te kayıttan çıkarıldı — runtime hiç göndermiyordu); event.data boştur (CQ-149)."
+        },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    datetimepicker: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                value: "string 'yyyy-MM-ddTHH:mm:ss' | null (yerel duvar saati, dilim eki yok; X ile boşaltılınca null)"
+            },
+            reads: "düğümün prop'una yazılır: self.value. Yalnız tarih + saat ikisi de seçilince yayılır — boş alanda yalnız gün seçmek yaymaz (CQ-237). 2026-09-16 öncesinde bu kayıtta yük anahtarı yoktu; runtime hep { value } gönderiyordu. event.data boştur (CQ-149)."
+        },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    daterangepicker: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                valueFrom: "string 'yyyy-MM-ddTHH:mm:ss' | null (yerel duvar saati, dilim eki yok; seçimde saat 00:00 — gece yarısı yaşanmayan yaz saati gününde 01:00; yarı X ile boşaltılınca null)",
+                valueTo: "string 'yyyy-MM-ddTHH:mm:ss' | null (kullanıcı değişikliğinden sonra hiçbir zaman valueFrom'dan önce değil)"
+            },
+            reads: "ikisi de düğümün prop'una yazılır: self.valueFrom / self.valueTo. Her change iki anahtarı birden taşır (değişmeyen uç tuttuğu değerle). HH/mm anahtarları YOKTUR (2026-09-16'da kayıttan çıkarıldı — runtime hiç göndermiyordu); event.data boştur (CQ-149)."
+        },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     datetimerangepicker: {
         mount: NO_DATA,
         change: {

package/dist/knowledge/errorPath.js

@@ -60,5 +60,5 @@ export function ensureWorkflowErrorPath(definition, kind) {
         branches.push({ id: randomUUID(), name: 'global-error', type: 'global-error', nextStepId: errorStepId });
     }
     startStep.branches = branches;
-    return [`hata yolu eklendi: start adımına 'global-error' dalı + '${name}' response adımı (500, { code, message }). Hata yolu olmayan akış patladığında platform ham exception mesajını 500 gövdesine basar; bu adım çıktıyı denetim altına alır. Kendi hata gövdenizi istiyorsanız bu adımın bodyExpression'ını değiştirin.`];
+    return [`hata yolu eklendi: start adımına 'global-error' dalı + '${name}' response adımı (500, { code, message }). Hata yolu olmayan akış patladığında platform WorkflowStepFailedException fırlatır (HTTP 500 { code, message, detail, type }; zamanlanmış işte failed + "Step 'x' failed: …"); bu adım çıktıyı { code, message } ile denetim altına alır, zamanlanmış işte sonuç yine failed düşer. Kendi hata gövdenizi istiyorsanız bu adımın bodyExpression'ını değiştirin.`];
 }

package/dist/knowledge/normalize.js

@@ -1951,6 +1951,21 @@ export function orphanedFlowPlan(schema, pageEvents, ops) {
         if (op.op !== 'set_event' && op.op !== 'remove_event')
             continue;
         const eventName = String(op.event ?? '');
+        // `remove_event target:'page'` düğümü değil barındırıcının düzey olaylarını hedefler
+        // (`PageSchemaMicroOpApplier.PageTarget`); düğüm aramasına düşseydi plan boş kalır ve yalnız
+        // oraya bağlı akış kapıdan geçip kalıcı silinirdi. Düzey olayı olmayan widget'ta applier da
+        // düğüm aramasına düşer.
+        if (op.op === 'remove_event' && target === 'page' && Array.isArray(pageEvents)) {
+            const hostEvents = asObjects(pageEvents);
+            const removed = hostEvents.find(event => String(event.name ?? '') === eventName);
+            if (typeof removed?.value !== 'string' || removed.value === '')
+                continue;
+            const surviving = new Set(hostEvents.filter(event => event !== removed && typeof event.value === 'string').map(event => String(event.value)));
+            collectFlowRefsExcept(nodes, '', surviving);
+            if (!surviving.has(removed.value))
+                plan.push({ target, op: 'remove_event', flowIds: [removed.value] });
+            continue;
+        }
         const node = findNodeByElementId(nodes, target);
         const current = asObjects(node?.events).find(event => String(event.name ?? '') === eventName);
         const currentValue = typeof current?.value === 'string' ? current.value : '';

package/dist/knowledge/outlines.js

@@ -1,3 +1,4 @@
+import fastJsonPatch from 'fast-json-patch';
 import { functionSignature } from './functionGuards.js';
 function asArray(value) {
     return Array.isArray(value) ? value.filter((entry) => Boolean(entry) && typeof entry === 'object') : [];
@@ -280,22 +281,38 @@ export function describePatchTarget(document, path) {
     const kind = entry.type ?? entry.dbType;
     return `${path} → '${label}'${kind ? ` (${String(kind)}` + `, id ${String(entry.id ?? '?')})` : `, id ${String(entry.id ?? '?')}`}`;
 }
+/**
+ * Her op, KENDİSİNDEN ÖNCEKİ op'ların uygulanmış hâlindeki belgeye karşı çözülür ve hemen
+ * ardından o tek op çalışan kopyaya uygulanır (S-3): aynı diziye giden birden çok `remove`
+ * seçicisi tek seferde ORİJİNAL belgeye göre indekse çevrilseydi, ilk silme diziyi kısaltıp
+ * sonraki op'ların indeksini kaydırırdı — yanıt yine de "applied: true" derdi çünkü hedef adı da
+ * aynı bayat belgeden okunuyordu. Dönen `operations` dizisi, orijinal belgeye karşı SIRAYLA
+ * uygulandığında (tek `fastJsonPatch.applyPatch` çağrısıyla dahi) bu adım adım simülasyonla aynı
+ * sonucu üretir; çağıranların uygulama biçimini değiştirmesi gerekmez.
+ */
 export function resolvePatchOperations(document, operations, readTool = 'workflow_get') {
     const notes = [];
     const targets = [];
-    const resolved = operations.map(operation => {
+    const resolvedOperations = [];
+    let working = structuredClone(document);
+    for (const operation of operations) {
         const path = typeof operation.path === 'string' ? operation.path : '';
         const op = typeof operation.op === 'string' ? operation.op : '';
-        const outcome = resolvePatchPointer(document, path, readTool, op);
-        const from = typeof operation.from === 'string' ? resolvePatchPointer(document, operation.from, readTool, op) : undefined;
+        const outcome = resolvePatchPointer(working, path, readTool, op);
+        const from = typeof operation.from === 'string' ? resolvePatchPointer(working, operation.from, readTool, op) : undefined;
         if (outcome.note)
             notes.push(outcome.note);
         if (from?.note)
             notes.push(from.note);
-        targets.push(describePatchTarget(document, outcome.path));
-        return from ? { ...operation, path: outcome.path, from: from.path } : { ...operation, path: outcome.path };
-    });
-    return { operations: resolved, notes, targets };
+        targets.push(describePatchTarget(working, outcome.path));
+        const resolvedOperation = from ? { ...operation, path: outcome.path, from: from.path } : { ...operation, path: outcome.path };
+        resolvedOperations.push(resolvedOperation);
+        // validate:false — bu yalnız SONRAKİ op'ların indeksini doğru izlemek için ara bir simülasyon;
+        // gerçek RFC6902 doğrulaması (ör. 'replace' hedefinin önceden var olması) çağıranın az sonra
+        // yapacağı asıl uygulamada (validate:true) hâlâ çalışır, burada erken ve gereksiz patlamaz.
+        working = fastJsonPatch.applyPatch(working, [resolvedOperation], false, true).newDocument;
+    }
+    return { operations: resolvedOperations, notes, targets };
 }
 /**
  * Fonksiyon özeti (G-07): kaynak, ad, kapsam, imza, parametre listesi, gövde satır sayısı —

package/dist/knowledge/rules.js

@@ -4,6 +4,7 @@ import { reservedTenantTables } from './reservedTables.js';
 import { headersAccessNames, isHeadersAccessGuarded } from './flowGuards.js';
 import { callsItself, functionCallRefs, isValidParameterName, mentionsAwait, nameProblem, sourceOf, callPrefix } from './functionGuards.js';
 import { backendPolicyRules } from './backendConstraints.js';
+import { themePolicyRules } from './themeRules.js';
 const terminalStepTypes = new Set(['response', 'convert', 'revert']);
 const DESCRIPTION_EXEMPT_STEPS = new Set(['start']);
 const stepKindMatrix = {
@@ -2716,7 +2717,7 @@ export const policyRules = [
         id: 'WF-021',
         module: 'workflow',
         appliesTo: ['create', 'update'],
-        sourceRef: "IStep.cs:74-86 bağlanmamış/eksik fail dalını global-error dalına yönlendirir; ikisi de yoksa ActivityContext.cs:176-183 ham exception mesajını 500 gövdesine basar. automation'da 'response' adımı yasak (stepKindMatrix) olduğu için gateway bu tipte enjeksiyon yapmaz — errorPath.ts",
+        sourceRef: "IStep.cs:88-104 bağlanmamış/eksik fail dalını global-error dalına yönlendirir; ikisi de yoksa canlıda WorkflowStepFailedException fırlatılır (2026-09-16), önizlemede ActivityContext.SetUnhandledError 500 gövdesi kurar. automation'da 'response' adımı yasak (stepKindMatrix) olduğu için gateway bu tipte enjeksiyon yapmaz — errorPath.ts",
         check: (definition, context) => {
             if (context.workflowKind !== 'automation')
                 return [];
@@ -2788,6 +2789,7 @@ export const policyRules = [
     },
     // Backend doğrulayıcılarının aynası (ENT-015…018, MS-017, WF-026, QRY/VIEW/DTO/ROW/DS/PRJ/TR/FLD/FILE/EXT):
     // tek liste `backendConstraints.ts`'te durur, buradan yalnız politika motoruna katılır.
+    ...themePolicyRules,
     ...backendPolicyRules()
 ];
 /**