@appaflytech/zeyrek-ai-mcp 0.0.36 → 0.0.40

package/dist/resources/examples/connect-data-table-entity.json

@@ -0,0 +1,147 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "datatable'ı flow yazmadan bir entity'ye bağlar. Canlı doğrulandı (2026-09-17, development rolkompleks, smoke-connect-data): dryRun findings [], yazma touched [tbl1], runtime.propType connectData, ekran 1 to 10 of 110.",
+    "harvestedFrom": "plans/connect-data g-12 canlı koşusu"
+  },
+  "_rules": {
+    "oneCall": "connect_data_bind bileşen kaydını (component_get.connectData), kaynağın kabiliyetini (connect_data_describe) okur, set_connect_data + columns'u tek atomik yamayla yazar. Önce dryRun: true.",
+    "fields": "Liste bileşeninde fields görünen kolonların sırasıdır; verilmezse bütün görünür alanlar seçilir.",
+    "expand": "İlişki alanı satırda hedef nesnesi olarak gelir (sube: { id, ad }); columns: 'auto' ilişkiye relation kolonu üretir.",
+    "filterable": "filterable/searchable seçili alanlardan olur (CD-004). Korumalı alanda (tckn) yalnız eq/neq/in/notin çalışır; kolonun işleç listesini runtime sunucudan alır.",
+    "policy": "Tanımdaki alanı politika gizliyorsa kullanıcı onu yanıtta ve kolonda görmez; ayrıca gizlemeye gerek yok.",
+    "verify": "connect_data_get → page_screenshot (runtimeErrors boş, satırlar çizili) → connect_data_preview { asUserId } başka kullanıcının gözüyle.",
+    "forbidden": "Bağlı rows'a flow setter ya da set_binding yazılmaz (CD-005)."
+  },
+  "connectDataBindArgs": {
+    "applicationId": "<application id>",
+    "pageId": "<page id>",
+    "element": "tbl1",
+    "prop": "rows",
+    "source": {
+      "kind": "entity",
+      "id": "<cd_musteriler entity id>"
+    },
+    "fields": [
+      "ad",
+      "soyad",
+      "tckn",
+      "puan",
+      "sube"
+    ],
+    "expand": {
+      "sube": [
+        "ad"
+      ]
+    },
+    "filterable": [
+      "ad",
+      "tckn",
+      "puan"
+    ],
+    "searchable": [
+      "ad",
+      "soyad"
+    ],
+    "pageSize": 25
+  },
+  "resultingDefinition": {
+    "version": 1,
+    "source": {
+      "kind": "entity",
+      "id": "<cd_musteriler entity id>",
+      "slug": "cd_musteriler"
+    },
+    "fields": [
+      {
+        "id": "<ad field id>",
+        "slug": "ad"
+      },
+      {
+        "id": "<soyad field id>",
+        "slug": "soyad"
+      },
+      {
+        "id": "<tckn field id>",
+        "slug": "tckn"
+      },
+      {
+        "id": "<puan field id>",
+        "slug": "puan"
+      },
+      {
+        "id": "<sube field id>",
+        "slug": "sube",
+        "expand": [
+          {
+            "slug": "ad"
+          }
+        ]
+      }
+    ],
+    "filter": null,
+    "sort": [
+      {
+        "field": "ad",
+        "ascending": true
+      }
+    ],
+    "page": {
+      "mode": "offset",
+      "limit": 25
+    },
+    "language": "request",
+    "mapping": {
+      "roles": {},
+      "columns": [
+        {
+          "field": "ad"
+        },
+        {
+          "field": "soyad"
+        },
+        {
+          "field": "tckn"
+        },
+        {
+          "field": "puan"
+        },
+        {
+          "field": "sube"
+        }
+      ]
+    },
+    "behavior": {
+      "filterable": [
+        "ad",
+        "tckn",
+        "puan"
+      ],
+      "searchable": [
+        "ad",
+        "soyad"
+      ],
+      "edit": {
+        "create": false,
+        "update": false,
+        "delete": false,
+        "bulk": false,
+        "saveMode": "row",
+        "editable": [],
+        "defaults": {},
+        "writeMode": "atomic"
+      },
+      "refresh": {
+        "afterWrite": "reload",
+        "poll": null
+      }
+    }
+  },
+  "generatedColumns": [
+    "ad:text",
+    "soyad:text",
+    "tckn:text",
+    "puan:number",
+    "sube:relation"
+  ]
+}

package/dist/resources/examples/connect-data-workflow-microservice.json

@@ -0,0 +1,65 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "Workflow ve microservice kaynağını datatable'a bağlar. Canlı ölçüldü (2026-09-21, cdt-mcp, koşu 38/04): workflow params 5000 → 4 satır (mode client); table ucu tanım filtresi fiyat gte 1000 ∧ istek filtresi kategori eq Elektronik → 4 satır, fiyat azalan.",
+    "harvestedFrom": "zeyrek-mcp/docs/38-connect-data-kabul-kosusu/04-mcp-uctan-uca.md Başlık 1"
+  },
+  "_rules": {
+    "workflowShape": "Workflow bağlanabilmesi için returnBehavior: 'array' ve dönüş DTO'su (returnDtoId) şarttır; parametreler parameterBehavior: 'object' + girdi DTO'suyla tanımlanır ve bağlantının params'ından gelir. Kaynak listesi (connect_data_sources) yalnız çıktı DTO'lu workflow'ları verir; alanlar dönüş DTO'sundan okunur.",
+    "workflowPaging": "Workflow sunucuda sayfalamaz ve süzmez: pageMode client (CD-007), filter/sort/filterable yok (CD-013).",
+    "microserviceShape": "Microservice yalnız OKUYAN, middleware'siz, dönüş şeması olan uçta bağlanır (yazan tablo ucu 422). Tablo ucunda enableDynamicFilters: true alanları canFilter/sortable yapar; sort/limit query-string parametresiyle offset sayfalama açılır. Query kaynaklı uç client kipte kalır.",
+    "microserviceFilter": "Tanım filtresi uçta her istekte uygulanır; kullanıcı filtresi (filterable) onunla AND'lenir.",
+    "verify": "connect_data_preview (Studio ucu) → kompleks projede connect_data_execute { op: 'list', asUserId }."
+  },
+  "workflowBindArgs": {
+    "applicationId": "<application id>",
+    "pageId": "<page id>",
+    "element": "dt_wf",
+    "prop": "rows",
+    "source": {
+      "kind": "workflow",
+      "id": "<pahali-urunler workflow id>"
+    },
+    "fields": [
+      "ad",
+      "kategori",
+      "fiyat"
+    ],
+    "params": {
+      "minFiyat": 5000
+    }
+  },
+  "connectDataBindArgs": {
+    "applicationId": "<application id>",
+    "pageId": "<page id>",
+    "element": "dt_ms",
+    "prop": "rows",
+    "source": {
+      "kind": "microservice",
+      "id": "<urun-listesi microservice id>"
+    },
+    "fields": [
+      "ad",
+      "kategori",
+      "fiyat",
+      "stok"
+    ],
+    "filter": {
+      "filterType": "single",
+      "field": "fiyat",
+      "operator": "gte",
+      "value": 1000
+    },
+    "sort": [
+      {
+        "field": "fiyat",
+        "ascending": false
+      }
+    ],
+    "filterable": [
+      "kategori",
+      "fiyat"
+    ],
+    "pageSize": 5
+  }
+}

package/dist/resources/examples/middleware-authenticate.json

@@ -182,7 +182,7 @@
     ]
   },
   "settingsSetterVariant": {
-    "note": "Genel amaçlı setter (qm '[SY] Settings Setter', 3 step): start -> settings [table get, ayarlar tablosu] -> setVar [type:'variable', rule.name:'settings', rule.expression:'{ ...settings.data }', rule.dataTransferObjectId:<ayarlar DTO>]. Response YOK — sadece değişken kurar; bağlandığı her uçta settings.<alan> okunur. Ad öneki ([A]/[SY]) alfabetik koşum sırasını kurmak içindir."
+    "note": "Genel amaçlı setter (qm '[SY] Settings Setter'): start -> settings [table get, ayarlar tablosu] -> setPrivate [type:'variable', rule.name:'settingsPrivate', rule.expression:'{ ...settings.data }', rule.dataTransferObjectId:<ayarlar DTO>, rule.isPrivate:true] -> setPublic [type:'variable', rule.name:'settings', rule.expression:'({ app_name: settings.data.app_name })']. Response YOK — sadece değişken kurar; bağlandığı her uçta settings.<alan> okunur. Sayfaya bağlanırsa işaretsiz değişkenler Page.variables ile istemciye gider: gizli değer taşıyan ya da kaydı yayan değişken isPrivate:true olmalı, istemciye gidecek alanlar izin listesiyle kurulur (MW-007). Ad öneki ([A]/[SY]) alfabetik koşum sırasını kurmak içindir."
   },
   "roleGateVariant": {
     "note": "Rol kapısını AYRI bir middleware'e ayırma: kimlik middleware'i set-user'a ULAŞMADAN biterse (çerez yok, koşul else dalı) 'user' hiç tanımlanmaz ve rolü okuyan middleware ham 'user is not defined' ile 500 verir — kullanıcı 401 yerine 500 görür (crm koşumu B-3). Kapıyı bu akışın İÇİNE, setUser'dan SONRA koy. Authorized hedefin rolleri BOŞSA true döndüğü için tek middleware her uca bağlanabilir; kapı yalnız roleIds dolu uçlarda kapanır.",

package/dist/resources/examples/mobile-app-shell-drawer.json

@@ -0,0 +1,244 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mobil uygulama kabuğu — ÇEKMECE: app-bar (leading 'menu' + menuTarget) + slot + drawer widget'ı. Çekmece ayar değil bileşendir; içindeki düğmeler sıradan redirect akışlarıyla sayfa açar. mobile_app_create drawer:true ile bu kabuğu kurar.",
+    "pairsWith": "mobile-app-shell-stack, mobile-app-shell-tab",
+    "sourceRef": "platform_guide('mobile') §Gezinme; plans/mobil-uygulama-expo/05-mobil-ayarlar-ve-gezinme.md §2.5, §8"
+  },
+  "_rules": {
+    "flexOnly": "Mobil çizer yalnız flex'tir: blocks boş, sıra dizi indeksi, ölçü appearance ile (MOB-001). Kökte layout prop'u YOK — mobil container şeması onu düşürür.",
+    "singleSlot": "TEK slot; sayfa şeması slot'a yerleşir (LAY-002 / LAY-006 web'dekiyle aynı).",
+    "appBarTitle": "app-bar.title boşsa çubuk başlıksız çizilir — sayfa adına düşen bir yedek YOKTUR (runtime app-bar yalnız title'ı yazar; koşu 37 S-9, mizanpaj 06 kör koşusu). Sabit başlık için mobile_app_create title'ı, sayfaya göre değişen başlık için title'ı bir değişkene bağlayın ya da başlığı sayfanın içine text olarak koyun. leading 'auto' yığında geri düğmesi, kökte (menuTarget varsa) menü düğmesi çizer.",
+    "catalog": "app-bar, slot ve drawer mobil kataloğun Dalga 1 bileşenleridir. component_list mobil uygulamada bunları döndürmüyorsa katalog henüz yazılmamıştır ve layout_create 422 unknown-type alır (MOB-003).",
+    "verify": "Kabuğu layout'a bağlı bir sayfada page_screenshot ile doğrula (mobilde varsayılan device: 'phone').",
+    "menuTarget": "app-bar.menuTarget çekmecenin elementId'sidir (nav_drawer); iç rol app_bar__menu düğmesidir — page_screenshot actions:[{ action:'click', target:'app_bar__menu' }] çekmeceyi açar.",
+    "drawerFlows": "Menü düğmelerine akış ayrı adımda bağlanır: flow_create (host: 'layout', adım redirect { path: '<sayfa slug'ı>' }) → layout_schema_patch set_event { target: 'menu_gorevler', event: 'click' }.",
+    "drawerNode": "Çekmece mobil kataloğun `drawer` bileşenidir (kind 'component', çocuk alır): layout'a doğrudan yazılır, prop'ları katalogdakilerdir (`position`, `size`, `title`, `isDismissDisabled`); kapalı doğar, `app-bar` menüsü `isOpen: true` yazarak açar. Katalogda olmayan prop (ör. `width`, `overlay`) ya da seçenek dışı değer (düğmede `variant: 'ghost'` — geçerli olanlar `solid`/`text`/`outline`) layout_create'i 422 ile düşürür.",
+    "layoutContract": "Mizanpaj sözleşmesi: üst güvenli alan tek yerde, kabukta (app-bar 'safe-area' edges:'top' içinde; sayfa ikinci pay vermez). Ekran kenarı boşluğu tek değer (16) ve tek yerde: slot'un yatay ve üst margin'i — içerik app-bar'ın 16 dp altından başlar, kabuksuz sayfadaki gibi. shell_root 'shrink' ve padding'siz — düz container olduğu için tip yazılmazsa runtime 10 dp padding verir ve app-bar kenardan kopar.",
+    "layerAtRoot": "Katman (drawer, modal) layout ya da sayfa şemasının KÖK dizisinde, kök kabın kardeşi olarak durur; kabın içinde 422 layer-outside-root alır. Çekmece runtime'da katman olarak açılır, akıştaki yeri yoktur."
+  },
+  "mobileAppCreate": {
+    "slug": "saha-menu",
+    "name": "Saha",
+    "drawer": true,
+    "pages": [
+      {
+        "pageSlug": "gorevler",
+        "pageName": "Görevler"
+      },
+      {
+        "pageSlug": "profil",
+        "pageName": "Profil"
+      }
+    ]
+  },
+  "layoutCreate": {
+    "name": "Mobil kabuk",
+    "views": [
+      {
+        "elementId": "shell_root",
+        "name": "shell_root",
+        "type": "container",
+        "kind": "component",
+        "props": {
+          "title": {
+            "type": "static",
+            "ref": null,
+            "data": ""
+          },
+          "direction": {
+            "type": "static",
+            "ref": null,
+            "data": "column"
+          },
+          "gap": {
+            "type": "static",
+            "ref": null,
+            "data": "none"
+          },
+          "size": {
+            "type": "static",
+            "ref": null,
+            "data": "shrink"
+          },
+          "wrap": {
+            "type": "static",
+            "ref": null,
+            "data": false
+          }
+        },
+        "states": {
+          "isDroppable": true,
+          "isWrapper": true
+        },
+        "appearance": {
+          "heightType": "fill",
+          "widthType": "fill",
+          "paddingType": "none"
+        },
+        "blocks": [],
+        "events": [],
+        "validations": [],
+        "stateBindings": [],
+        "children": [
+          {
+            "elementId": "sa_ust",
+            "name": "sa_ust",
+            "type": "safe-area",
+            "kind": "component",
+            "props": {
+              "edges": {
+                "type": "static",
+                "ref": null,
+                "data": "top"
+              }
+            },
+            "states": {
+              "isDroppable": true
+            },
+            "appearance": {
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "app_bar",
+                "name": "app_bar",
+                "type": "app-bar",
+                "kind": "component",
+                "props": {
+                  "title": {
+                    "type": "static",
+                    "ref": null,
+                    "data": ""
+                  },
+                  "leading": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "menu"
+                  },
+                  "menuTarget": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "nav_drawer"
+                  }
+                },
+                "appearance": {
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              }
+            ]
+          },
+          {
+            "elementId": "page_slot",
+            "name": "page_slot",
+            "type": "slot",
+            "kind": "component",
+            "props": {},
+            "appearance": {
+              "widthType": "fill",
+              "heightType": "fill",
+              "marginType": "custom",
+              "marginValues": {
+                "top": 16,
+                "right": 16,
+                "bottom": 0,
+                "left": 16
+              }
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        ]
+      },
+      {
+        "elementId": "nav_drawer",
+        "name": "nav_drawer",
+        "type": "drawer",
+        "kind": "component",
+        "props": {
+          "position": {
+            "type": "static",
+            "ref": null,
+            "data": "left"
+          },
+          "size": {
+            "type": "static",
+            "ref": null,
+            "data": "default"
+          }
+        },
+        "appearance": {},
+        "blocks": [],
+        "events": [],
+        "validations": [],
+        "stateBindings": [],
+        "children": [
+          {
+            "elementId": "menu_gorevler",
+            "name": "menu_gorevler",
+            "type": "button",
+            "kind": "component",
+            "props": {
+              "text": {
+                "type": "static",
+                "ref": null,
+                "data": "Görevler"
+              },
+              "variant": {
+                "type": "static",
+                "ref": null,
+                "data": "text"
+              }
+            },
+            "appearance": {
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          },
+          {
+            "elementId": "menu_profil",
+            "name": "menu_profil",
+            "type": "button",
+            "kind": "component",
+            "props": {
+              "text": {
+                "type": "static",
+                "ref": null,
+                "data": "Profil"
+              },
+              "variant": {
+                "type": "static",
+                "ref": null,
+                "data": "text"
+              }
+            },
+            "appearance": {
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        ]
+      }
+    ]
+  }
+}

package/dist/resources/examples/mobile-app-shell-stack.json

@@ -0,0 +1,157 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mobil uygulama kabuğu — YIĞIN (varsayılan gezinme): app-bar + tek slot. Sekme ayarı yok; redirect sayfayı yığına iter, app-bar geri düğmesi ve cihaz geri tuşu döner. layout_create'in views alanına olduğu gibi verilebilir; mobile_app_create tabs ve drawer verilmeyince bu kabuğu kurar.",
+    "pairsWith": "mobile-app-shell-tab (sekmeli), mobile-app-shell-drawer (çekmeceli), mobile-list-detail-form (üç sayfa)",
+    "sourceRef": "platform_guide('mobile') §Gezinme; plans/mobil-uygulama-expo/05-mobil-ayarlar-ve-gezinme.md §2.5-2.6"
+  },
+  "_rules": {
+    "flexOnly": "Mobil çizer yalnız flex'tir: blocks boş, sıra dizi indeksi, ölçü appearance ile (MOB-001). Kökte layout prop'u YOK — mobil container şeması onu düşürür.",
+    "singleSlot": "TEK slot; sayfa şeması slot'a yerleşir (LAY-002 / LAY-006 web'dekiyle aynı).",
+    "appBarTitle": "app-bar.title boşsa çubuk başlıksız çizilir — sayfa adına düşen bir yedek YOKTUR (runtime app-bar yalnız title'ı yazar; koşu 37 S-9, mizanpaj 06 kör koşusu). Sabit başlık için mobile_app_create title'ı, sayfaya göre değişen başlık için title'ı bir değişkene bağlayın ya da başlığı sayfanın içine text olarak koyun. leading 'auto' yığında geri düğmesi, kökte (menuTarget varsa) menü düğmesi çizer.",
+    "catalog": "app-bar, slot ve drawer mobil kataloğun Dalga 1 bileşenleridir. component_list mobil uygulamada bunları döndürmüyorsa katalog henüz yazılmamıştır ve layout_create 422 unknown-type alır (MOB-003).",
+    "verify": "Kabuğu layout'a bağlı bir sayfada page_screenshot ile doğrula (mobilde varsayılan device: 'phone').",
+    "layoutContract": "Mizanpaj sözleşmesi: üst güvenli alan tek yerde, kabukta (app-bar 'safe-area' edges:'top' içinde; sayfa ikinci pay vermez). Ekran kenarı boşluğu tek değer (16) ve tek yerde: slot'un yatay ve üst margin'i — içerik app-bar'ın 16 dp altından başlar, kabuksuz sayfadaki gibi. shell_root 'shrink' ve padding'siz — düz container olduğu için tip yazılmazsa runtime 10 dp padding verir ve app-bar kenardan kopar."
+  },
+  "mobileAppCreate": {
+    "slug": "saha",
+    "name": "Saha",
+    "pages": [
+      {
+        "pageSlug": "gorevler",
+        "pageName": "Görevler"
+      },
+      {
+        "pageSlug": "detay",
+        "pageName": "Görev detayı"
+      }
+    ]
+  },
+  "layoutCreate": {
+    "name": "Mobil kabuk",
+    "views": [
+      {
+        "elementId": "shell_root",
+        "name": "shell_root",
+        "type": "container",
+        "kind": "component",
+        "props": {
+          "title": {
+            "type": "static",
+            "ref": null,
+            "data": ""
+          },
+          "direction": {
+            "type": "static",
+            "ref": null,
+            "data": "column"
+          },
+          "gap": {
+            "type": "static",
+            "ref": null,
+            "data": "none"
+          },
+          "size": {
+            "type": "static",
+            "ref": null,
+            "data": "shrink"
+          },
+          "wrap": {
+            "type": "static",
+            "ref": null,
+            "data": false
+          }
+        },
+        "states": {
+          "isDroppable": true,
+          "isWrapper": true
+        },
+        "appearance": {
+          "heightType": "fill",
+          "widthType": "fill",
+          "paddingType": "none"
+        },
+        "blocks": [],
+        "events": [],
+        "validations": [],
+        "stateBindings": [],
+        "children": [
+          {
+            "elementId": "sa_ust",
+            "name": "sa_ust",
+            "type": "safe-area",
+            "kind": "component",
+            "props": {
+              "edges": {
+                "type": "static",
+                "ref": null,
+                "data": "top"
+              }
+            },
+            "states": {
+              "isDroppable": true
+            },
+            "appearance": {
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "app_bar",
+                "name": "app_bar",
+                "type": "app-bar",
+                "kind": "component",
+                "props": {
+                  "title": {
+                    "type": "static",
+                    "ref": null,
+                    "data": ""
+                  },
+                  "leading": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "auto"
+                  }
+                },
+                "appearance": {
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              }
+            ]
+          },
+          {
+            "elementId": "page_slot",
+            "name": "page_slot",
+            "type": "slot",
+            "kind": "component",
+            "props": {},
+            "appearance": {
+              "widthType": "fill",
+              "heightType": "fill",
+              "marginType": "custom",
+              "marginValues": {
+                "top": 16,
+                "right": 16,
+                "bottom": 0,
+                "left": 16
+              }
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        ]
+      }
+    ]
+  }
+}