@appaflytech/zeyrek-ai-mcp 0.0.25 → 0.0.27

package/dist/knowledge/componentCatalog.js

@@ -358,15 +358,18 @@ export const componentKnowledge = {
             "SEÇİM İKİ YOLDAN YAZILIR, ikisi de self.selectedIndex'e: (1) satırın HERHANGİ bir yerine tıklama — her tıklamada `select`, satır değiştiyse önce `change`; (2) satırdaki bir çocuğun yaydığı olay (buton click, girdi change/focus…) — satır değiştiyse `change`. Yalnız text/image taşıyan kart da tıklamayla seçilir (2026-09-15'ten önce ancak olay yayan bir çocukla seçilebiliyordu). İSTİSNA: tıklamayı kendisi yutan etkileşimli çocuklar (dropdown-button, collapsible-container, tag-input, tarih seçici, dosya girdileri, tree-view, table) satıra ulaştırmaz — orada select gelmez, seçim yalnız o çocuk olay yayarsa change ile yazılır. Etikete tıklamak (switch/checkbox/radio) tek tıklama sayılır. Satırdaki butona tıklanınca akışların BAŞLAMA sırası: repeater `change` → butonun click akışı → repeater `select` (akışlar asenkron, bitiş sırası garanti değil); butonun akışında <repeater>.selectedIndex zaten o satırdır. Butonun akışı satırı SİLER ya da selectedIndex'e null yazarsa, ardından gelen select eski sırayla yayılır ve selectedIndex'i yeniden yazar — silme/temizleme akışını butona bağla, repeater'ın select'ine iş bağlama.",
             "SEÇİLİ SATIRIN VERİSİ `selectedItem`'dır (şema prop'u DEĞİL, runtime türetir): `{{ <repeater>.selectedItem.<alan> }}` ve akışta self.selectedItem. selectedIndex yazılmamışken İLK SATIRI (rows[0]) döndürür — 'henüz seçim yok' ile 'ilk satır seçili'yi ayırmak için selectedIndex'e bak (sayı değilse seçim yok). rows yenilenince selectedIndex SIFIRLANMAZ; eski sıra yeni listede başka satırı gösterebilir, gerekiyorsa sorgu akışında selectedIndex'i null yaz.",
             "rows dizi DEĞİLSE (henüz koşmamış sorgu, null yazan akış) liste boş çizilir, sayfa düşmez; aynı _id/id'yi taşıyan satırlar da çizilir AMA çocuk girdilerin satır başına değerleri o kimliğe göre tutulduğu için bu satırlar yazılan değeri PAYLAŞIR — girdi taşıyan kartlarda id'ler benzersiz olmalı. Boş liste için ayrı bir emptystate bileşeni koy ve isHidden'ını `{{ (<repeater>.rows || []).length > 0 }}` yap — repeater'ın kendi boş durum metni yok.",
-            "Izgara: columnCount kolon (en az 1), kartlar arası dikey boşluk verticalSpacing (px, yazılmazsa 20), yatay boşluk horizontalSpacing (px, yazılmazsa 0). autoRowSize:false iken bütün satırlar EN UZUN kart kadar yüksek (1fr); true iken her satır kendi içeriği kadar. Boş/null boşluk varsayılana düşer."
+            "Izgara: columnCount kolon (en az 1; katalog varsayılanı 5, yazılmamış eski düğüm 1), kartlar arası dikey boşluk verticalSpacing (px; katalog varsayılanı 12, yazılmazsa 20), yatay boşluk horizontalSpacing (px; katalog varsayılanı 12, yazılmazsa 0). autoRowSize:false iken bütün satırlar EN UZUN kart kadar yüksek (1fr); true iken her satır kendi içeriği kadar. Boş/null boşluk varsayılana düşer.",
+            "KARTIN İÇİ container ailesiyle AYNI yedi yerleşim prop'uyla dizilir (2026-09-29): layout ('flex' | 'grid', katalog varsayılanı 'flex') + direction/horizontalAlign/verticalAlign/size/gap/wrap — anlamları container kaydındakiyle birebir; TEK FARK direction varsayılanının 'column' olması (kart dikey yığındır). Satır (row) akışında heightType:'fill' yalnız align-self:stretch'tir ve wrap açıkken kısa kart hücreyi doldurmaz — eşit boylu kartlar için column kullan. Her satırın kartı ayrı bir .ng-app__node-children sarmalıdır ve bu düzeni giyer; çocuklar blocks[].position sırasıyla (önce y, sonra x) akar ve flex çocuk sözleşmesini (appearance.widthType/heightType, spacer mode) alır. Kartların KENDİ dizilişi (kaç kolon, aralarındaki boşluk) hâlâ columnCount/verticalSpacing/horizontalSpacing'tir. layout prop'u hiç yazılmamış eski repeater'ın kartı 12 kolon ızgara kalır.",
+            "Studio'ya bırakılan YENİ repeater dolu doğar: 10 görselli örnek satır (id, image, title, category, price, description; satırda 5 kart, iki tam sıra) ve tek bir kart şablonu — tema yüzeyli bir container (layout flex, direction column, gap small; appearance widthType/heightType 'fill') içinde image (240px kapak), kategori, başlık (1 satır), açıklama (2 satır), esnek spacer (mode 'flex' — fiyatı ve butonu kartın tabanına iter), fiyat ('{{ item.price }} ₺') ve buton (kind 'info'). Şemayı sen kuruyorsan bu şablon GELMEZ: kartı children olarak yaz; kartın içindeki her parçaya appearance.widthType:'fill' ver — sütun akışında genişliği yazılmamış çocuk 12 kolon payına düşer ve o pay sütunda yükseklik anlamına gelir."
         ],
         propNotes: {
             surfaceStyle: NODE_SURFACE_NOTE,
             rows: "Yinelenen veri; çocuk komponent ifadelerinde satıra item / Row ile, satırın sırasına RowIndex ile (0'dan başlar) erişilir. Satırlara kalıcı bir id ya da _id ver: girilen değerler ve kart örnekleri ona göre eşlenir.",
             columns: "YALNIZ Studio'daki Rows düzenleyicisinin alanlarını tanımlar; runtime OKUMAZ. Kartta ne görüneceğini repeater'ın children'ı ve onların `{{ item.<alan> }}` ifadeleri belirler — columns yazmak kartı değiştirmez.",
-            columnCount: 'Bir satırdaki kart sayısı (tam sayı, en az 1; 0/boş 1 sayılır).',
-            verticalSpacing: 'Kart satırları arası boşluk, px. Yazılmazsa 20 (şema varsayılanı; 2026-09-15 öncesi yazılmamış düğüm 0 çiziyordu).',
-            horizontalSpacing: 'Yan yana kartlar arası boşluk, px. Yazılmazsa 0.',
+            columnCount: 'Bir satırdaki kart sayısı (tam sayı, en az 1; 0/boş 1 sayılır). Katalog varsayılanı 5 (2026-09-29).',
+            verticalSpacing: 'Kart satırları arası boşluk, px. Yazılmazsa 20 (bileşen varsayılanı; 2026-09-15 öncesi yazılmamış düğüm 0 çiziyordu); yeni düğümün katalog varsayılanı 12 (2026-09-29).',
+            horizontalSpacing: 'Yan yana kartlar arası boşluk, px. Yazılmazsa 0; katalog varsayılanı 12 (2026-09-29).',
+            layout: "KARTIN İÇİ: 'flex' (katalog varsayılanı; akış) | 'grid' (12 kolonluk ızgara). Prop hiç yazılmamışsa renderer IZGARA çizer. Diğer altı yerleşim prop'u yalnız 'flex' iken etkilidir; anlamları container kaydındakiyle aynı.",
             selectedIndex: "Tıklanan/olay yayan satırın sırası (0'dan). Runtime `change` ve `select` ile yazar; akışta self.selectedIndex, başka bileşende `{{ <repeater>.selectedIndex }}`. Şemada gizli durum prop'udur (panelde çizilmez); akış yazarak seçimi değiştirebilir ya da null yazıp temizleyebilir. Seçili satırın verisi için behavior'daki selectedItem maddesine bak."
         }
     },
@@ -1196,9 +1199,9 @@ export const componentKnowledge = {
         }
     },
     navigations: {
-        summary: "Çok seviyeli gezinme menüsü. 2026-08-27'de araç kutusuna alındı; 2026-09-22'de TEK AĞAÇ · 12 DÜZEN modeline geçti (layout prop'u): sidebar, header, hybrid (header+sidebar), dual (rail+panel), bottom (alt sekme çubuğu), dock, tabs, breadcrumb, command (komut paleti), launcher, footer, toc (içindekiler). Aynı navigations ağacı hepsinde kullanılır.",
+        summary: "Çok seviyeli gezinme menüsü. 2026-08-27'de araç kutusuna alındı; 2026-09-22'de TEK AĞAÇ · 12 DÜZEN modeline geçti (navLayout prop'u — 2026-09-29'a kadar adı layout idi): sidebar, header, hybrid (header+sidebar), dual (rail+panel), bottom (alt sekme çubuğu), dock, tabs, breadcrumb, command (komut paleti), launcher, footer, toc (içindekiler). Aynı navigations ağacı hepsinde kullanılır.",
         behavior: [
-            "layout prop'u hangi KABUĞUN çizeceğini seçer; seçim tipli bir kayıttan yapılır (components/navigations/navigation-layouts/). Tanınmayan ya da temizlenmiş (null) bir değer sidebar'a düşer — ekran boş kalmaz.",
+            "navLayout prop'u hangi KABUĞUN çizeceğini seçer; seçim tipli bir kayıttan yapılır (components/navigations/navigation-layouts/). Tanınmayan ya da temizlenmiş (null) bir değer sidebar'a düşer — ekran boş kalmaz.",
             "variant 'drawer' bir düzen DEĞİL sidebar/hybrid'in menü tipidir ve kendi kabuğunu çağırır (tetikleyici + karartma + örtü katmanı); içindeki satırların düz mü akordiyon mu olduğunu drawerContent söyler.",
             "Derin seviyeler nestingMode ile açılır: 'inline' yerinde ağaç, 'drill' panel içinde panel (drillHeader üç biçimde), 'cascade' sidebar'da kademeli flyout / drawer'da drawer-içinde-drawer. inlineDepth bir panelde yerinde gösterilen seviye sayısıdır.",
             "Bazı prop bileşimlerinin ekranda karşılığı yoktur ve ÇİZİM ANINDA zorlanır (navigation-effective.ts): drawerSide 'bottom' iken cascade → drill ve push → overlay; fullscreen + cascade → üst üste; ≤768px'te sidebar/header/hybrid/dual/dock drawer'a döner (mobileBehavior 'drawer' ise) ve hover ile açma kapanır.",
@@ -1212,13 +1215,15 @@ export const componentKnowledge = {
             "Daraltma durumu tarayıcıda (localStorage, 'ng-nav-collapsed:<elementId>') saklanır ve SONRAKİ SAYFADA okunur — menü linkleri tam sayfa yüklediği için bellekteki durum her tıklamada kayboluyordu. Tuvalde okunmaz.",
             "Menü içi arama bir ALAN gibi çizilir (kenarlık + açık zemin + '/' ipucu); sayfada yazı alanı dışındayken '/' aramaya odaklanır (kısayolun sayfada tek sahibi vardır). command düzeninin tetikleyicisi de alan görünümündedir ve Ctrl K / ⌘ K ipucu taşır; iki yerde de yer tutucu searchPlaceholder'dır.",
             "KAPSAYICIDIR (isDroppable, 2026-09-24): layout gibi içine komponent bırakılır ve bırakılan çocuklar menünün YANINDA/ALTINDA kendi içerik alanında çizilir, menü satırlarının arasında değil. Akış yönünü düzen belirler (navigation-content.ts): sidebar/hybrid/dual menü solda içerik sağda — sidebarSide right ise ters; toc tocPosition ile; header/tabs/breadcrumb içerik altta; footer/bottom ve dock bottom içerik üstte (dock top altta); drawer/command/launcher akışta yer kaplamaz, içerik alanı tek başına kalır. İçerik alanı navigations dizisi BOŞKEN de durur — son menü öğesi silinince bırakılan bileşenler kaybolmaz. İçine hiçbir şey bırakılmamışsa alan akıştan çıkar (menünün yanına boşluk düşmez); kenara yapışık panelde (sidebar/hybrid/dual, floating değil) menü ile içerik arasında boşluk YOKTUR, panelin kenarlığı ayırır. Bırakılan içerik alanın boyunu doldurur (fill zinciri) — yan menü + içerik sütunu kabuğu tek navigations ile kurulabilir. Kanvasta çocukların çizilmesi için kayıtlı düğümde states.isDroppable true olmalı.",
+            "İÇERİK ALANININ YERLEŞİMİ container ailesiyle AYNI yedi prop'tur (2026-09-29): layout ('flex' | 'grid', katalog varsayılanı 'flex') + direction/horizontalAlign/verticalAlign/size/gap/wrap, anlamları ve varsayılanları container kaydındakiyle birebir. Bunlar menüyü DEĞİL, menünün yanına bırakılan çocukları dizer (RenderComponent içerik alanındaki .ng-app__node-children sarmalına yazar). Menünün kendi biçimi navLayout, satır yoğunluğu density'dir. layout prop'u 'flex'/'grid' dışında bir değer taşıyan (ya da hiç taşımayan) düğümün içerik alanı 12 kolon IZGARA çizilir.",
+            "YENİDEN ADLANDIRMA (2026-09-29, ADR 0007): menü düzeni layout → navLayout, satır yoğunluğu size → density. Kayıtlı eski düğümler göç görmedi: navLayout yoksa bileşen eski layout değerini (sidebar/header/… ise) düzen sayar, density yoksa eski size'ı (sm/md/lg ise) — ekranda değişiklik olmaz. AMA backend doğrulayıcısı eski değerli düğüme DOKUNAN patch'i invalid-enum-value ile reddeder (layout artık flex|grid, size shrink|grow): böyle bir düğümü düzenlerken aynı patch'te navLayout'a eski layout değerini, density'ye eski size değerini yaz ve layout'u 'grid' (eski görünüm) ya da 'flex', size'ı 'shrink' yap.",
             "sidebar ve layout bileşenleri bu ağacı GÖMÜLÜ kipte mount eder (embedded): panel kromunu — genişlik, kenarlık, zemin, logo, kullanıcı alanı — o kabuklar çizer, navigations ikinci kez çizmez.",
             "Satır görünümü TİPLİ navigationStyle grubuyla verilir (layout ile aynı grup); serbest style'ın &__item, &__item--active ve &__icon parçaları gruptan SONRA gelir (son söz).",
-            'Karar kaydı: zeyrek-frontend/docs/adr/0001-navigation-duzen-kaydi.md.'
+            'Karar kayıtları: zeyrek-frontend/docs/adr/0001-navigation-duzen-kaydi.md (düzen kaydı), 0007-navigation-duzen-proplari-yeniden-adlandirildi.md (navLayout/density adları).'
         ],
         propNotes: {
             navigations: "Ağaç: { title, href, icon, isHidden, isExpandable, isExpanded, children } + görünüm alanları { badge, badgeTone, isDisabled, target }. Alan adları kaydedilmiş sayfaların sözleşmesidir ve değişmedi. href düz metin ya da bağlantı seçicisinin nesnesi ({ type:'page', data, ref }) olabilir; ikisini de getHref çözer.",
-            layout: "Navigasyonun ekrandaki yeri ve biçimi; 12 seçenek. Kabuk seçimini bu prop yapar — tek istisna, sidebar ve hybrid düzenlerinde drawer menü tipinin kendi kabuğunu çağırmasıdır (bkz. variant).",
+            navLayout: "Navigasyonun ekrandaki yeri ve biçimi; 12 seçenek (2026-09-29'a kadar prop'un adı layout idi). Kabuk seçimini bu prop yapar — tek istisna, sidebar ve hybrid düzenlerinde drawer menü tipinin kendi kabuğunu çağırmasıdır (bkz. variant).",
             variant: "Menü tipi: 'flat' (alt öğeler hep açık), 'accordion' (açılır/kapanır), 'drawer' (tetikleyiciyle açılan panel). Yalnız sidebar ailesinde anlamlıdır.",
             displayMode: "'full' ikon+metin · 'rail' yalnız ikon (alt seviyeler kademeli flyout) · 'text' yalnız metin.",
             nestingMode: "Derin seviyeler nasıl açılır: 'inline' | 'drill' | 'cascade'. Rail'de her zaman cascade'e zorlanır.",
@@ -1296,7 +1301,7 @@ export const componentKnowledge = {
             showFooter: "Panelin alt bandı (kullanıcı alanı vb.). Kapatılırsa liste panelin dibine kadar uzar.",
             showBadges: "Öğelerin badge alanını çizer. Rail modunda rozetin yazacak yeri olmadığı için sayı tek bir NOKTAYA iner.",
             tooltips: "Yalnız ikon görünen satırlarda üzerine gelince adı balonla gösterir. Rail’de ve daraltılabilir panelde anlamlıdır; etiketin zaten göründüğü yerde basılmaz.",
-            size: "Yoğunluk kademesi: 'sm' | 'md' | 'lg'. Tek bir prop satır yüksekliğini, yazı boyutunu, satır dolgusunu ve ikon-metin boşluğunu birlikte değiştirir (navigation-tokens.ts ROW_HEIGHTS/FONT_SIZES/ROW_PADDINGS/ROW_GAPS) — bunlar ayrı ayrı ayarlanmaz.",
+            density: "Yoğunluk kademesi: 'sm' | 'md' | 'lg' (2026-09-29'a kadar prop'un adı size idi). Tek bir prop satır yüksekliğini, yazı boyutunu, satır dolgusunu ve ikon-metin boşluğunu birlikte değiştirir (navigation-tokens.ts ROW_HEIGHTS/FONT_SIZES/ROW_PADDINGS/ROW_GAPS) — bunlar ayrı ayrı ayarlanmaz.",
             radius: "Satırın köşe yuvarlaklığı (px, 0–24). SIFIR verildiğinde satırın dış boşluğu da sıfırlanır ve satır panelin kenarına dayanır — yuvarlak köşeli bir satırın kenara yapışması tasarımın istemediği tek durumdur.",
             indent: "Bir seviyenin girintisi (px, 8–48). maxIndent’e kadar her seviye bu kadar içeri alınır, sonrası 12px’lik küçük adımlara döner. Rail’de girinti çizilecek yer yoktur.",
             itemGap: "Satırlar arası dikey boşluk (px, 0–16). Kök listeye ve her çocuk listesine birlikte uygulanır; satır yüksekliğini değiştirmez (onu size belirler).",
@@ -1316,7 +1321,14 @@ export const componentKnowledge = {
             activeBgColor: "Aktif satırın zemini. activeIndicator hangisi olursa olsun geçerlidir — \"bar\"/\"pill\"/\"text\" kendi tonlarını yazar ama AÇIK seçimini ezmez (--ng-nav-active-bg-set).",
             activeTextColor: "Aktif satırın yazı rengi. activeBgColor ile aynı kural: gösterge biçimi bunu ezmez.",
             hoverColor: "Fare üzerindeyken satırın zemini. \"bar\" göstergesi aktif satırın zemini olarak da bunu kullanır.",
-            borderColor: "Panel kenarlığı, grup ayraçları ve kılavuz çizgilerinin ortak rengi."
+            borderColor: "Panel kenarlığı, grup ayraçları ve kılavuz çizgilerinin ortak rengi.",
+            layout: "İÇERİK ALANI yerleşimi: 'flex' (katalog varsayılanı; akış) | 'grid' (12 kolonluk ızgara). Menüyü değil bırakılan çocukları dizer; anlamı container kaydındakiyle aynı. Menünün düzeni navLayout'tur.",
+            direction: "İçerik alanı flex yönü: 'row' (varsayılan) | 'column'. Yalnız flex yerleşimde okunur; container ile aynı.",
+            horizontalAlign: 'left | center | right | stretch — içerik alanı; container ile aynı eksen kuralları.',
+            verticalAlign: 'top | middle | bottom | stretch — içerik alanı; container ile aynı eksen kuralları.',
+            size: "İçerik alanı çocuk boyu: 'shrink' (varsayılan) | 'grow'. Satır yoğunluğu DEĞİLDİR — o density'dir (2026-09-29'a kadar size yoğunluktu).",
+            gap: 'none | small | medium (varsayılan) | large ya da ham CSS değeri — içerik alanı çocukları arası; container ile aynı.',
+            wrap: 'İçerik alanında flex-wrap; varsayılan açık, container ile aynı.'
         }
     },
     'layout-shell': {

package/dist/knowledge/normalize.js

@@ -1910,7 +1910,7 @@ export const FLEX_LAYOUT_PROP_NAMES = new Set(['layout', ...Object.keys(FLEX_LAY
  * `icon` gibi komponentlerin KENDİ `size` prop'u flex `size`'ı değildir ve dokuz komponent için
  * yanlış uyarı üretiyordu (09-04 Y-08).
  */
-const FLEX_LAYOUT_HOST_TYPES = new Set(['aibox', 'box', 'box-section', 'container', 'page-container', 'form', 'layout', 'widget-area']);
+const FLEX_LAYOUT_HOST_TYPES = new Set(['aibox', 'box', 'box-section', 'container', 'page-container', 'form', 'layout', 'widget-area', 'repeater', 'navigations']);
 /**
  * Eski `cssgrid` (box/aibox'ın akan gerçek `display:grid` kipi; 2026-09-02'de seçenek olmaktan
  * çıktı, kayıtlı düğümlerde çalışmaya devam ediyor) düzen prop'larının HEPSİNİ ölü yapmaz:

package/dist/knowledge/rules.js

@@ -69,12 +69,21 @@ function carriesValue(value) {
         return value.trim() !== '';
     return true;
 }
-function workflowCallSites(body) {
+/**
+ * `type` tipindeki adımlar ve `loop` adımının `rule.stepType === type` olan çocuk kuralı.
+ * `LoopStep.cs` çocuğu `rule.Children.FirstOrDefault()` ile aynı tipin keyed `IStep`'ine verir:
+ * çocuk, üst seviyedeki aynı tip adımla AYNI kuralı okur ve aynı denetimden geçmelidir. İki
+ * kullanıcısı var: WF-032 (`workflow`) ve WF-MF-001 (`microfunction`; loop içinde koştuğu
+ * ölçüldü 2026-09-28, zeyrek-backend/docs/microfunction/03-workflow-adimi.md §Loop içinde).
+ * Etiketteki "(loop çocuğu)" bulguyu okuyan
+ * ajanı adımın `rule.stepRule`'una yönlendirir.
+ */
+function stepCallSites(body, type) {
     return workflowSteps(body).flatMap((step) => {
         const rule = (step.rule ?? {});
-        if (step.type === 'workflow')
+        if (step.type === type)
             return [{ step, rule, label: stepLabel(step) }];
-        if (step.type === 'loop' && rule.stepType === 'workflow' && rule.stepRule && typeof rule.stepRule === 'object') {
+        if (step.type === 'loop' && rule.stepType === type && rule.stepRule && typeof rule.stepRule === 'object') {
             return [{ step, rule: rule.stepRule, label: `${stepLabel(step)} (loop çocuğu)` }];
         }
         return [];
@@ -713,19 +722,17 @@ export const policyRules = [
         id: 'WF-MF-001',
         module: 'workflow',
         appliesTo: ['create', 'update', 'preview'],
-        sourceRef: "MicrofunctionStep.cs: rule.MicrofunctionId ile kayıt yüklenir, Status != Published ise FailedOutput(MicrofunctionNotPublishedException) — adım hata dalına düşer, akış 200 dönse bile iş yapılmaz. Ölçüldü 2026-09-10 (B4 doğrulaması: taslak fonksiyona bağlı uç 500 MicrofunctionNotPublishedException)",
-        check: definition => {
-            const body = workflowBody(definition);
-            return workflowSteps(body)
-                .filter(step => step.type === 'microfunction')
-                .flatMap((step) => {
-                const rule = (step.rule ?? {});
+        sourceRef: "MicrofunctionStep.cs: rule.MicrofunctionId ile kayıt yüklenir, Status != Published ise FailedOutput(MicrofunctionNotPublishedException) — adım hata dalına düşer, akış 200 dönse bile iş yapılmaz. Ölçüldü 2026-09-10 (B4 doğrulaması: taslak fonksiyona bağlı uç 500 MicrofunctionNotPublishedException). Loop çocuğu (rule.stepType: 'microfunction', rule.stepRule) aynı adımla koşar — ölçüldü 2026-09-28, microfunction-faz-2/development; taslak seçen loop İLK iterasyonda fail dalına düşer ve durur (ölçülen çıktı [{ item: 1 }])",
+        check: (definition, context) => {
+            const body = workflowBody(definition, context.workflowKind);
+            return stepCallSites(body, 'microfunction')
+                .flatMap(({ rule, label }) => {
                 const microfunctionId = rule.microfunctionId;
                 if (!hasText(microfunctionId)) {
                     return [{
                             ruleId: 'WF-MF-001',
                             severity: 'block',
-                            message: `'${stepLabel(step)}' microfunction adımında rule.microfunctionId yok — adım hangi fonksiyonu koşturacağını bilmez. microfunction_list(status: 'published') ile id seçin; argümanlar rule.expression'a yazılır (fonksiyonun parameterDto'su varsa o şemaya göre).`,
+                            message: `'${label}' microfunction adımında rule.microfunctionId yok — adım hangi fonksiyonu koşturacağını bilmez. microfunction_list(status: 'published') ile id seçin; argümanlar rule.expression'a yazılır (fonksiyonun parameterDto'su varsa o şemaya göre).`,
                             guide: 'ngapps://guides/microfunction'
                         }];
                 }
@@ -733,7 +740,7 @@ export const policyRules = [
                     return [{
                             ruleId: 'WF-MF-001',
                             severity: 'block',
-                            message: `'${stepLabel(step)}' adımının rule.microfunctionId'si GUID değil: '${String(microfunctionId)}'. Platform alanı Guid'e çeviremediği için 400 döner.`,
+                            message: `'${label}' adımının rule.microfunctionId'si GUID değil: '${String(microfunctionId)}'. Platform alanı Guid'e çeviremediği için 400 döner.`,
                             guide: 'ngapps://guides/microfunction'
                         }];
                 }
@@ -746,7 +753,7 @@ export const policyRules = [
         module: 'workflow',
         appliesTo: ['create', 'update', 'preview'],
         sourceRef: "WorkflowStep.cs EvaluateAsync: kural yalnız rule.WorkflowId ve rule.Expression okur; girdi workflow.HasParameter iken Expression'ın DataTransferObjectExpression.Eval'iyle bağlanır, başka hiçbir alan okunmaz. Studio WorkflowTrigger.svelte de yalnız bu iki alanı yazar ve expression'ı çağrılan akışın parameterScheme'inden nesne literali olarak doldurur. RFQ koşusu W-7 (2026-09-14): payloadExpression/customParameters kaydedildi, alt akış girdisiz koştu",
-        check: (definition, context) => workflowCallSites(workflowBody(definition, context.workflowKind)).flatMap(({ label, rule }) => {
+        check: (definition, context) => stepCallSites(workflowBody(definition, context.workflowKind), 'workflow').flatMap(({ label, rule }) => {
             const workflowId = rule.workflowId;
             if (!hasText(workflowId)) {
                 return [{
@@ -2206,7 +2213,7 @@ export const policyRules = [
                     findings.push({
                         ruleId: 'WF-018',
                         severity: 'block',
-                        message: `'${stepLabel(step)}' loop step'inde rule.stepRule yok${hasChildren ? " — ama rule.children dolu: çocuk kural alanının adı 'children' DEĞİL 'stepRule'dur (tekil)" : ''}. Çocuksuz loop çalışma anında NullReferenceException verir ve hata mesajı arrayExpression'ı suçlar. Çocuğun kendi rule gövdesini rule.stepRule'a koyun; loop'un çıktısı [{ item, result }] dizisidir. Geçerli öğeye 'loopItem' ile erişilir AMA yalnız loop'un kendi değerlendirdiği ifadelerde (table çocuğunun fields[].value / filters[].value gibi) — 'code' çocuğunda loopItem TANIMSIZDIR ve adım "loopItem is not defined" ile düşer (ölçüldü 2026-09-16); her öğe için hesabı arrayExpression'da önden yapın.`,
+                        message: `'${stepLabel(step)}' loop step'inde rule.stepRule yok${hasChildren ? " — ama rule.children dolu: çocuk kural alanının adı 'children' DEĞİL 'stepRule'dur (tekil)" : ''}. Çocuksuz loop çalışma anında NullReferenceException verir ve hata mesajı arrayExpression'ı suçlar. Çocuğun kendi rule gövdesini rule.stepRule'a koyun; loop'un çıktısı [{ item, result }] dizisidir. Geçerli öğeye 'loopItem' ile erişilir AMA yalnız loop'un kendi değerlendirdiği ifadelerde (table çocuğunun fields[].value / filters[].value, workflow ve microfunction çocuğunun expression'ı gibi) — 'code' çocuğunda loopItem TANIMSIZDIR ve adım "loopItem is not defined" ile düşer (ölçüldü 2026-09-16); her öğe için hesabı arrayExpression'da önden yapın.`,
                         guide: 'ngapps://guides/workflow'
                     });
                 }
@@ -2974,15 +2981,13 @@ export const policyRules = [
 export async function microfunctionStepFindings(platform, project, environment, definition, kind, policyOverride = false) {
     if (platform.config.policyMode === 'off')
         return [];
-    const steps = workflowSteps(workflowBody(definition, kind))
-        .filter(step => step.type === 'microfunction')
-        .filter(step => hasText((step.rule ?? {}).microfunctionId));
-    if (steps.length === 0)
+    const sites = stepCallSites(workflowBody(definition, kind), 'microfunction')
+        .filter(site => hasText(site.rule.microfunctionId));
+    if (sites.length === 0)
         return [];
     const records = new Map();
     const findings = [];
-    for (const step of steps) {
-        const rule = (step.rule ?? {});
+    for (const { rule, label } of sites) {
         const microfunctionId = String(rule.microfunctionId);
         if (!records.has(microfunctionId)) {
             try {
@@ -3000,7 +3005,7 @@ export async function microfunctionStepFindings(platform, project, environment,
             findings.push({
                 ruleId: 'WF-MF-001',
                 severity: 'block',
-                message: `'${stepLabel(step)}' adımının microfunctionId'si (${microfunctionId}) bu ortamda YOK. Adım kuralı step_rules.microfunction_id ile kayda FK'lıdır: gövde gitseydi platform 400 dönerdi. microfunction_list ile bu ortamdaki kayıtları görün — fonksiyon başka bir dalda/ortamda kalmış olabilir.`,
+                message: `'${label}' adımının microfunctionId'si (${microfunctionId}) bu ortamda YOK. Adım kuralı step_rules.microfunction_id ile kayda FK'lıdır: gövde gitseydi platform 400 dönerdi. microfunction_list ile bu ortamdaki kayıtları görün — fonksiyon başka bir dalda/ortamda kalmış olabilir.`,
                 guide: 'ngapps://guides/microfunction'
             });
             continue;
@@ -3010,7 +3015,7 @@ export async function microfunctionStepFindings(platform, project, environment,
             findings.push({
                 ruleId: 'WF-MF-001',
                 severity: 'block',
-                message: `'${stepLabel(step)}' adımı '${String(record.name ?? microfunctionId)}' fonksiyonunu seçiyor ama kaydın durumu '${status}'${status === 'publish-failed' && hasText(record.publishError) ? ` (publishError: ${String(record.publishError)})` : ''}. Step YALNIZ yayındaki kaydı koşturur: MicrofunctionStep kaydı yükleyip Status != Published görünce MicrofunctionNotPublishedException ile FAIL dalına düşer — akış kurulur, kaydedilir ve koşumda sessizce hata yoluna girer. Önce microfunction_publish çağırın ve microfunction_get ile 'published' olduğunu görün.`,
+                message: `'${label}' adımı '${String(record.name ?? microfunctionId)}' fonksiyonunu seçiyor ama kaydın durumu '${status}'${status === 'publish-failed' && hasText(record.publishError) ? ` (publishError: ${String(record.publishError)})` : ''}. Step YALNIZ yayındaki kaydı koşturur: MicrofunctionStep kaydı yükleyip Status != Published görünce MicrofunctionNotPublishedException ile FAIL dalına düşer — akış kurulur, kaydedilir ve koşumda sessizce hata yoluna girer. Önce microfunction_publish çağırın ve microfunction_get ile 'published' olduğunu görün.`,
                 guide: 'ngapps://guides/microfunction'
             });
             continue;
@@ -3019,7 +3024,7 @@ export async function microfunctionStepFindings(platform, project, environment,
             findings.push({
                 ruleId: 'WF-MF-001',
                 severity: 'warn',
-                message: `'${stepLabel(step)}' adımının fonksiyonu ('${String(record.name ?? microfunctionId)}') şu anda yayınlanıyor. Yayın ASENKRONDUR: bu akış şimdi koşarsa adım fail dalına düşer. microfunction_get ile 'published' olduğunu doğrulayın (yayın başarısız olursa durum 'publish-failed' olur).`,
+                message: `'${label}' adımının fonksiyonu ('${String(record.name ?? microfunctionId)}') şu anda yayınlanıyor. Yayın ASENKRONDUR: bu akış şimdi koşarsa adım fail dalına düşer. microfunction_get ile 'published' olduğunu doğrulayın (yayın başarısız olursa durum 'publish-failed' olur).`,
                 guide: 'ngapps://guides/microfunction'
             });
         }
@@ -3035,7 +3040,7 @@ export async function microfunctionStepFindings(platform, project, environment,
             findings.push({
                 ruleId: 'WF-MF-001',
                 severity: 'warn',
-                message: `'${stepLabel(step)}' adımında rule.expression boş ama '${String(record.name ?? microfunctionId)}' fonksiyonunun bir parametre DTO'su var (parameterDtoId: ${String(record.parameterDtoId)}). Fonksiyon args olarak boş nesne alır ve kendi alanlarını undefined görür. Argümanları ifadeyle geçirin — şemayı microfunction_get çıktısındaki parameterScheme verir.`,
+                message: `'${label}' adımında rule.expression boş ama '${String(record.name ?? microfunctionId)}' fonksiyonunun bir parametre DTO'su var (parameterDtoId: ${String(record.parameterDtoId)}). Fonksiyon args olarak boş nesne alır ve kendi alanlarını undefined görür. Argümanları ifadeyle geçirin — şemayı microfunction_get çıktısındaki parameterScheme verir.`,
                 guide: 'ngapps://guides/microfunction'
             });
         }
@@ -3061,7 +3066,7 @@ export async function workflowStepFindings(platform, project, environment, appli
         : hasText(definition.applicationId) ? String(definition.applicationId) : undefined;
     if (application === undefined)
         return [];
-    const sites = workflowCallSites(workflowBody(definition, kind))
+    const sites = stepCallSites(workflowBody(definition, kind), 'workflow')
         .filter(site => GUID_PATTERN.test(String(site.rule.workflowId ?? '')));
     if (sites.length === 0)
         return [];

package/dist/resources/guides/microfunction.md

@@ -131,6 +131,34 @@ kullanılabilir. Kuralı iki alan taşır:
 - `workflow_preview` adımı GERÇEK runtime'da koşturur; preview'ın rollback garantisi fonksiyonun
   dış dünyada yaptığı işi geri ALMAZ.
 
+### Loop içinde
+
+Loop adımı dizinin her öğesi için fonksiyonu bir kez çağırır. Çocuğun tipi loop'un kendi
+`rule.stepType`'ında, kuralı `rule.stepRule`'dadır (tekil — `children` değil, WF-018):
+
+```jsonc
+{ "id": "<GUID>", "name": "her", "type": "loop",
+  "rule": {
+    "stepType": "microfunction",
+    "arrayExpression": "input.kalemler || []",
+    "stepRule": { "stepType": "microfunction", "microfunctionId": "<published id>", "expression": "({ x: loopItem.x })" }
+  },
+  "branches": [ /* success + fail */ ] }
+```
+
+- Çıktı `[{ item, result }]` dizisidir: `result` fonksiyonun o öğedeki dönüşü. Sonraki adımda
+  `her.data.map(r => r.result)`.
+- **Öğe fonksiyona yalnız `args` ile gider.** `expression` loop'un motorunda değerlendirilir:
+  `loopItem`, `input` ve loop'tan önceki adımlar orada görünür. `context.input` akışın kendi
+  girdisidir, iterasyonun öğesi DEĞİL.
+- `context.steps` loop'tan önce koşmuş adımları taşır (2026-09-28'den önce loop içinde boş
+  geliyordu; backend düzeltmesi).
+- WF-MF-001 loop çocuğunu da denetler; bulgu adımı `her (loop çocuğu)` diye adlandırır. Taslak bir
+  fonksiyonu seçen loop ilk iterasyonda fail dalına düşer ve orada durur.
+- Her iterasyon önceki adımların çıktısını `context.steps` ile yeniden taşır ve bu da
+  `MaxPayloadBytes` (5 MB) sınırına sayılır: büyük bir sorgudan sonra koşan loop'ta sınır
+  iterasyon başına dolabilir.
+
 Tam gövde örneği: `ngapps://examples/microfunction-node-sum`.
 
 ## Built-In ve AWS Lambda farkı

package/dist/resources/guides/workflow.md

@@ -373,7 +373,7 @@ gidilir, hiçbiri tutmazsa `else` dalı yürür:
 
 | Step | workflow | automation | middleware |
 |------|:-:|:-:|:-:|
-| start, condition, code, loop, table, query, http, workflow, email, file-upload | ✓ | ✓ | ✓ |
+| start, condition, code, loop, table, query, http, workflow, microfunction, email, file-upload | ✓ | ✓ | ✓ |
 | variable (Set Variable), set-user, setcookie, redirect | – | – | ✓ |
 | response | ✓ | – | ✓ |
 | convert | ✓ | – | – |
@@ -521,6 +521,7 @@ Tek uçta "başlık + N alt kayıt" yazmanın yolu budur (anket + sorular + seç
   `fields[].value` / `filters[].value` ifadelerinde `loopItem.<alan>` yazılır (ölçüldü 2026-09-16:
   `table` çocuğunun filtresinde `loopItem.slug` → `'super-admin'`); `input` ve önceki adımlar
   (`createSurvey.data.id`) da görünmeye devam eder.
+- **`microfunction` çocuğunda `loopItem` argüman ifadesinde görünür** (`stepRule.expression`, loop'un motorunda değerlendirilir); fonksiyon öğeyi yalnız `args` ile alır. Ayrıntı: `platform_guide('microfunction')` §Workflow adımı → Loop içinde.
 - **`code` çocuğunda `loopItem` YOKTUR (ölçüm 2026-09-16).** `code` adımı kendi JS motorunu kurar
   ve `LoopStep`'in `loopItem` ataması oraya ulaşmaz: adım **`Error: loopItem is not defined`** ile
   düşer, o yinelemenin çıktısında `result` hiç oluşmaz. Motorda görünenler `input` · `system` ·

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",