@appaflytech/zeyrek-ai-mcp 0.0.25 → 0.0.26

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.26",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",