@appaflytech/zeyrek-ai-mcp 0.0.12 → 0.0.14

package/dist/knowledge/normalize.js

@@ -140,6 +140,49 @@ export function normalizeMicroserviceDefinition(definition) {
         return [];
     return normalizeTableParameters(definition.sourceParameters, definition.entityId);
 }
+/**
+ * S-2: `microservice_patch`in yamaladığı belge YAZMA komutu değil OKUMA şeklidir
+ * (`MicroserviceDto`) — rol listesi orada `roles: [{ id, name }]`tır ve `UpdateMicroserviceCommand.FromDto`
+ * onu `RoleIds`'e eşler. Yazma gövdesinin adı (`roleIds`) patch belgesinde YOKTUR: `replace` yolu
+ * `OPERATION_PATH_UNRESOLVABLE` ile düşer, `add` ise platformda sessizce yutulur
+ * (`StJsonOptions.Read` bilinmeyen üyeyi atar, 200 döner, rol değişmez). Ajan yazma adını öğrenmiş
+ * olarak geldiği için yolu reddetmek yerine ÇEVİRİYORUZ ve çeviriyi `gatewayNormalized` ile
+ * söylüyoruz — istek geçer, doğru ad öğrenilir.
+ */
+export function normalizeMicroservicePatchOps(operations, definition) {
+    const notes = [];
+    const rolesIsArray = Array.isArray(definition.roles);
+    for (const operation of operations) {
+        const path = typeof operation.path === 'string' ? operation.path : '';
+        if (path !== '/roleIds' && !path.startsWith('/roleIds/') && path !== '/roles' && !path.startsWith('/roles/'))
+            continue;
+        if (path === '/roleIds' || path.startsWith('/roleIds/')) {
+            operation.path = `/roles${path.slice('/roleIds'.length)}`;
+            notes.push(`patch yolu '${path}' → '${operation.path}': yamalanan belge microservice_get'in OKUMA şeklidir (MicroserviceDto) ve rol listesi orada 'roles' [{ id, name }] alanıdır; 'roleIds' yalnız create/update GÖVDESİNDE vardır. Çevrilmeseydi replace çözülemez, add ise platformda sessizce yutulurdu.`);
+        }
+        const targetPath = operation.path;
+        if (targetPath === '/roles' && Array.isArray(operation.value)) {
+            const bare = operation.value.filter(entry => typeof entry === 'string');
+            if (bare.length > 0) {
+                operation.value = operation.value.map(entry => typeof entry === 'string' ? { id: entry } : entry);
+                notes.push(`'${targetPath}' değerindeki ${bare.length} çıplak guid { id } nesnesine sarıldı — rol listesi id/ad çiftleri taşır, 'name' isteğe bağlıdır (platform yalnız id okur).`);
+            }
+        }
+        if (targetPath.endsWith('/-') && typeof operation.value === 'string') {
+            operation.value = { id: operation.value };
+            notes.push(`'${targetPath}' değeri { id } nesnesine sarıldı — listeye eklenen öğe rol kaydıdır, çıplak guid değil.`);
+        }
+        // `roles` null gelirse (platform boş listeyi null serileştirebiliyor) diziye ekleme yolu
+        // çözülemez: tek öğelik tam dizi yazmaya katlanır, yoksa istek gitmeden düşerdi.
+        if (!rolesIsArray && targetPath === '/roles/-') {
+            operation.op = 'add';
+            operation.path = '/roles';
+            operation.value = [operation.value];
+            notes.push("okunan kayıtta 'roles' dizi değil (null) — '/roles/-' eklemesi tek öğelik tam dizi yazmaya ('add /roles') katlandı.");
+        }
+    }
+    return notes;
+}
 export function withNormalization(payload, fixes) {
     if (fixes.length > 0) {
         logStep('düzeltme', `gateway ${fixes.length} otomatik düzeltme uyguladı — gövdeye istek gönderilmeden ÖNCE işlendi, yanıta gatewayNormalized olarak eklenir`, fixes);
@@ -1998,32 +2041,76 @@ export function orphanedFlowPlan(schema, pageEvents, ops) {
         if (op.op !== 'set_event' && op.op !== 'remove_event')
             continue;
         const eventName = String(op.event ?? '');
+        const eventValue = typeof op.eventValue === 'string' ? op.eventValue : undefined;
+        const boundTo = (events) => asObjects(events)
+            .filter(event => String(event.name ?? '') === eventName && typeof event.value === 'string' && event.value !== '');
+        // Bir olaya birden fazla akış bağlı olabilir. Değersiz `remove_event` o durumda platformda
+        // `ambiguous-event` ile düşer ve hiçbir bağ kalkmaz; değerli olan yalnız o akışı çözer.
+        const removedBy = (named) => eventValue === undefined
+            ? (named.length === 1 ? named : [])
+            : named.filter(event => event.value === eventValue);
         // `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)));
+            const removed = removedBy(boundTo(hostEvents));
+            const surviving = new Set(hostEvents.filter(event => !removed.includes(event) && 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] });
+            const flowIds = [...new Set(removed.map(event => String(event.value)))].filter(flowId => !surviving.has(flowId));
+            if (flowIds.length > 0)
+                plan.push({ target, op: 'remove_event', flowIds });
             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 : '';
-        if (currentValue === '' || currentValue === String(op.eventValue ?? ''))
+        const named = boundTo(node?.events);
+        // `set_event` adın BÜTÜN bağlarını tek kayda indirir; yeni değerden farklı her akış bağını kaybeder.
+        const losing = op.op === 'set_event' ? named.filter(event => event.value !== eventValue) : removedBy(named);
+        if (losing.length === 0)
             continue;
         const surviving = survivingRefs(target, eventName);
-        if (!surviving.has(currentValue))
-            plan.push({ target, op: String(op.op), flowIds: [currentValue] });
+        for (const event of named) {
+            if (!losing.includes(event))
+                surviving.add(String(event.value));
+        }
+        const flowIds = [...new Set(losing.map(event => String(event.value)))].filter(flowId => !surviving.has(flowId));
+        if (flowIds.length > 0)
+            plan.push({ target, op: String(op.op), flowIds });
     }
     return plan;
 }
+/**
+ * PAGE-034 — dolu bir olaya farklı akışla `set_event` gelmesi. `set_event` adın bütün bağlarını
+ * TEK kayda indirir, yani önceki akış bağını sessizce kaybeder; akış başka yerden de
+ * referanslıysa `orphanedFlowPlan` da susar ve kayıp hiç görünmez (maddelerim 4: makale önerisi
+ * akışı, akıllı öneri bağlanınca çalışmaz oldu). Olaya ikinci akış eklemek `add_event`'tir; bilerek
+ * değiştirmek için op'a `replaceBoundFlows: true` verilir. Okunan ağaçta olmayan hedef denetlenmez.
+ */
+export function boundEventOps(schema, ops) {
+    const nodes = asObjects(schema);
+    return asObjects(ops)
+        .filter(op => op.op === 'set_event' && op.replaceBoundFlows !== true)
+        .flatMap(op => {
+        const target = String(op.target ?? '');
+        const event = String(op.event ?? '');
+        const eventValue = typeof op.eventValue === 'string' ? op.eventValue : '';
+        const bound = asObjects(findNodeByElementId(nodes, target)?.events)
+            .filter(entry => String(entry.name ?? '') === event && typeof entry.value === 'string' && entry.value !== '')
+            .map(entry => String(entry.value));
+        const replaced = [...new Set(bound)].filter(flowId => flowId !== eventValue);
+        if (replaced.length === 0)
+            return [];
+        return [`PAGE-034: '${target}' komponentinin '${event}' olayına zaten bağlı akış var (${replaced.join(', ')}). set_event olayın BÜTÜN bağlarını tek akışa indirir ve bu akışlar olay tetiklenince artık çalışmaz. `
+                + `Olaya bir akış daha eklemek için { op: 'add_event', target: '${target}', event: '${event}', eventValue: '${eventValue}' } kullanın — bağlı akışların hepsi paralel koşar. `
+                + `Mevcut bağı bilerek değiştirmek istiyorsanız aynı op'a replaceBoundFlows: true ekleyin.`];
+    });
+}
+/** Gateway'e ait op alanları platforma gitmez. */
+export function stripGatewayEventFields(ops) {
+    for (const op of ops)
+        delete op.replaceBoundFlows;
+}
 export function orphanedFlowMessage(plan) {
     const lines = plan.map(entry => `'${entry.target}' (${entry.op}) → ${entry.flowIds.join(', ')}`);
     return `İstek gönderilmedi: bu yama ${plan.reduce((total, entry) => total + entry.flowIds.length, 0)} akışı sayfada referanssız bırakıyor ve platform referanssız akışı KALICI siler — ${lines.join(' · ')}. `

package/dist/knowledge/outlines.js

@@ -44,6 +44,9 @@ export function microserviceOutline(definition) {
         url: definition.url,
         workflowId: definition.workflowId ?? null,
         queryId: definition.queryId ?? null,
+        // S-2: rol listesi okuma şeklinde `roles`, yazma gövdesinde `roleIds` — outline yazma adını
+        // basar ki patch'ten sonra "rol tuttu mu" sorusu ikinci bir microservice_get istemesin.
+        roleIds: asArray(definition.roles).map(role => role.id),
         sourceParameters: {
             operation: sourceParameters.operation,
             entityId: sourceParameters.entityId,
@@ -55,9 +58,10 @@ export function microserviceOutline(definition) {
             filterCount: asArray(sourceParameters.filters).length
         },
         view: 'outline',
-        hint: "Parça için view:'part', part:'sourceParameters.joins' gibi; değişiklik için microservice_patch."
+        hint: "Parça için view:'part', part:'sourceParameters.joins' gibi; değişiklik için microservice_patch. Rol listesi patch belgesinde '/roles' [{ id, name }] yolundadır."
     };
 }
+const enumOutlineValueLimit = 30;
 export function entityOutline(definition) {
     return {
         id: definition.id,
@@ -75,7 +79,16 @@ export function entityOutline(definition) {
             nullable: field.nullable,
             relationType: field.relationType ?? 'none',
             relationId: field.relationId ?? null,
-            isLocalized: Boolean(field.isLocalized)
+            isLocalized: Boolean(field.isLocalized),
+            // S-1: enum'a tek op'la yazılan değerin kanıtı outline'da dursun — aksi hâlde `entity_patch`
+            // yanıtı "liste gitti mi" sorusuna cevap vermiyor ve ajan tam gövdeye dönüyor. Bütçe K3:
+            // ilk 30 değer; `icon`/`labels` outline'a girmez, sayı toplamı söyler.
+            ...(asArray(field.valueOptions).length > 0
+                ? {
+                    values: asArray(field.valueOptions).slice(0, enumOutlineValueLimit).map(option => option.value),
+                    valueOptionCount: asArray(field.valueOptions).length
+                }
+                : {})
         })),
         indexCount: asArray(definition.indexes).length,
         // Index'ler alanlardan çok daha az sayıdadır; tam projeksiyon outline'ı şişirmez ve yazılan
@@ -91,7 +104,7 @@ export function entityOutline(definition) {
             }
             : {}),
         view: 'outline',
-        hint: "Bir alanın tam gövdesi için view:'part', part:'fields[slug=<slug>]'; değişiklik için entity_patch. isLocalized alanlar için platform_guide('entity') §'Çoklu dilli alan'."
+        hint: "Bir alanın tam gövdesi için view:'part', part:'fields[slug=<slug>]'; değişiklik için entity_patch. Enum'a tek değer: entity_patch add '/fields[slug=<slug>]/valueOptions/-'. isLocalized alanlar için platform_guide('entity') §'Çoklu dilli alan'."
     };
 }
 const identityKeys = ['id', 'slug', 'name', 'elementId', 'stepId'];

package/dist/knowledge/rules.js

@@ -2172,7 +2172,7 @@ export const policyRules = [
         id: 'WF-018',
         module: 'workflow',
         appliesTo: ['create', 'update', 'preview'],
-        sourceRef: "LoopStep.cs:41 çocuk kuralı rule.Children.FirstOrDefault() ile okur ama API sözleşmesinde alan TEKİLdir (StepRuleDto.StepRule, WorkflowDto.cs:498). 'children' gönderilirse Children boş kalır, çocuk adım null rule ile koşar ve loop NullReferenceException verir — hata arrayExpression'ı işaret ettiği için yanlış yere baktırır. Ölçüm: anket-admin/anket-kaydet, 2026-08-19",
+        sourceRef: "LoopStep.cs:41 çocuk kuralı rule.Children.FirstOrDefault() ile okur ama API sözleşmesinde alan TEKİLdir (StepRuleDto.StepRule, WorkflowDto.cs:498). 'children' gönderilirse Children boş kalır, çocuk adım null rule ile koşar ve loop NullReferenceException verir — hata arrayExpression'ı işaret ettiği için yanlış yere baktırır. Ölçüm: anket-admin/anket-kaydet, 2026-08-19. loopItem kapsamı 2026-09-16'da ölçüldü: table çocuğunun filtre ifadesinde çalışıyor, code çocuğunda tanımsız (LoopStep.cs:38 loop'un kendi motoruna yazıyor, code adımı ayrı motor kuruyor)",
         check: (definition, context) => {
             const body = workflowBody(definition, context.workflowKind);
             return workflowSteps(body)
@@ -2185,7 +2185,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; geçerli öğeye çocuk ifadelerinde 'loopItem' ile erişilir, loop'un çıktısı [{ item, result }] dizisidir.`,
+                        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.`,
                         guide: 'ngapps://guides/workflow'
                     });
                 }
@@ -2845,6 +2845,74 @@ export const policyRules = [
             guide: 'ngapps://guides/entity'
         }))
     },
+    /**
+     * WF-033 — `http` adımının sözleşmesi. Gövde ayrı bir alan değildir: `payloadExpression` tek
+     * ifadeyle `{ header, body, queryString }` ÜÇÜNÜ birden üretmek zorundadır, çünkü yürütücü
+     * üçüne de `dynamic` üye erişimiyle bakar (HttpStep.cs:32,42,59) ve eksik anahtar adımı
+     * `RuntimeBinderException` ile düşürür — ölçüldü 2026-09-16, mesaj birebir
+     * "'System.Dynamic.ExpandoObject' does not contain a definition for 'queryString'".
+     *
+     * Anahtar denetimi YALNIZ nesne literalinde yapılır (`(`/`{` ile başlayan ifade): bir fonksiyon
+     * çağrısı ya da değişken döndüren ifadenin içini statik olarak göremeyiz ve orada susmak
+     * yanlış pozitif üretmemekten iyidir (AGENTS §10).
+     */
+    {
+        id: 'WF-033',
+        module: 'workflow',
+        appliesTo: ['create', 'update', 'preview'],
+        sourceRef: "HttpStep.cs:26-32,42,59,63-85 — url rule.UrlExpression'dan (JS ifadesi → string), method rule.HttpMethod'dan (HttpMethod.Parse), gövde rule.PayloadExpression'ın body/header/queryString anahtarlarından okunur; eksik anahtar RuntimeBinderException. contentType boşsa gövde body.ToString() ile gider. Ölçüm 2026-09-16, test/development: üç anahtarlı çağrı 200, queryString'siz çağrı RuntimeBinderException",
+        check: definition => {
+            const httpMethods = new Set(['get', 'post', 'put', 'patch', 'delete', 'head', 'options']);
+            const bodyCarryingMethods = new Set(['post', 'put', 'patch']);
+            return workflowSteps(workflowBody(definition))
+                .filter(step => step.type === 'http')
+                .flatMap((step) => {
+                const rule = (step.rule ?? {});
+                const findings = [];
+                const payload = String(rule.payloadExpression ?? '').trim();
+                if (!hasText(rule.urlExpression)) {
+                    findings.push({
+                        ruleId: 'WF-033',
+                        severity: 'block',
+                        message: `'${stepLabel(step)}' http adımında rule.urlExpression yok. Adres bir JS İFADESİDİR, düz metin değil: sabit adresi tırnak içinde yazın ("'https://api.example.com/v1/rates'"), dinamik adresi ifadeyle kurun ("'https://api.example.com/orders/' + input.orderId"). Tırnaksız yazarsanız JS onu değişken sanır ve adım "x is not defined" ile düşer.`,
+                        guide: 'ngapps://guides/workflow'
+                    });
+                }
+                if (!httpMethods.has(String(rule.httpMethod ?? '').trim().toLowerCase())) {
+                    findings.push({
+                        ruleId: 'WF-033',
+                        severity: 'block',
+                        message: `'${stepLabel(step)}' http adımında rule.httpMethod ${hasText(rule.httpMethod) ? `'${String(rule.httpMethod)}' — tanınmıyor` : 'yok'}. Platform değeri HttpMethod.Parse ile çözer; geçerli değerler: ${[...httpMethods].map(method => method.toUpperCase()).join(' · ')}.`,
+                        guide: 'ngapps://guides/workflow'
+                    });
+                }
+                if (payload.startsWith('(') || payload.startsWith('{')) {
+                    const missing = ['body', 'header', 'queryString']
+                        .filter(key => !new RegExp(`['"]?${key}['"]?\\s*:`).test(payload));
+                    if (missing.length > 0) {
+                        findings.push({
+                            ruleId: 'WF-033',
+                            severity: 'block',
+                            message: `'${stepLabel(step)}' http adımının payloadExpression'ında ${missing.join(', ')} anahtarı yok. Gövde AYRI BİR ALAN DEĞİLDİR: bu tek ifade body, header ve queryString ÜÇÜNÜ BİRDEN taşımak zorundadır — boş olanı da yazın: "({ body: {}, header: {}, queryString: {} })". Eksik anahtar çalışma anında RuntimeBinderException verir ("'System.Dynamic.ExpandoObject' does not contain a definition for '${missing[0]}'") ve adım fail dalına düşer. Örnek: ngapps://examples/workflow-http-step`,
+                            guide: 'ngapps://guides/workflow'
+                        });
+                    }
+                }
+                // Gövde taşıyan metotlarda contentType'ın boş olması sessiz bir bozulmadır. Gövdenin
+                // DOLU olup olmadığını ifade metninden ayrıştırmaya çalışmıyoruz (K7): metot yeterli
+                // ve kesin bir sinyal, gövde ayrıştırması yanlış pozitif üretir.
+                if (!hasText(rule.contentType) && bodyCarryingMethods.has(String(rule.httpMethod ?? '').trim().toLowerCase())) {
+                    findings.push({
+                        ruleId: 'WF-033',
+                        severity: 'warn',
+                        message: `'${stepLabel(step)}' http adımı ${String(rule.httpMethod).toUpperCase()} ile gövde gönderiyor ama rule.contentType boş: platform gövdeyi body.ToString() ile yollar ve nesne gövdesi tip adının kendisine dönüşür (HttpStep.cs:63-85). JSON gönderiyorsanız contentType: 'application/json' yazın.`,
+                        guide: 'ngapps://guides/workflow'
+                    });
+                }
+                return findings;
+            });
+        }
+    },
     {
         id: 'MW-003',
         module: 'workflow',

package/dist/resources/examples/function-total.json

@@ -10,7 +10,8 @@
     "scope": "Yalnız source:'studio'. application: her sayfada (tarayıcı). page: yalnız o sayfanın tarayıcı bağlamında, pageId zorunlu. Ad uygulama içinde kapsamlar arası benzersizdir (K3); workflow adı tenant içinde benzersizdir. Aynı ad iki kaynakta yan yana olabilir.",
     "isAsync": "Yalnız studio'da anlamlı; false bırakın: true olsaydı {{ }} bağlaması '[object Promise]' çizerdi. await gerekmeyen gövdede isAsync:true FN-004 uyarısı alır. workflow kaynağında true FN-004 block (motor senkron).",
     "naming": "Ad JS tanımlayıcısı; ayrılmış sözcük olamaz. studio'da 'Functions' yasak (FN-001, block); workflow'da motor global adları (system, input, Now, crypto…) yasak (FN-001, block). Uygulama fonksiyonunda sayfaya özgü ad (komponent adı, state.page), workflow fonksiyonunda adım adı kullanmayın — çağrıldığı yerde yoksa 'X is not defined'.",
-    "source": "workflow: SUNUCU, tenant geneli, applicationId/scope/pageId VERİLMEZ, isAsync olamaz, çıplak adla çağrılır. studio: TARAYICI, applicationId + scope zorunlu (application: her sayfada; page: yalnız o sayfa, pageId zorunlu), Functions.<ad>() ile çağrılır. Kaynak sonradan değişmez; sunucu ifadesinde Functions.<ad>( → WF-030 block."
+    "source": "workflow: SUNUCU, tenant geneli, applicationId/scope/pageId VERİLMEZ, isAsync olamaz, çıplak adla çağrılır. studio: TARAYICI, applicationId + scope zorunlu (application: her sayfada; page: yalnız o sayfa, pageId zorunlu), Functions.<ad>() ile çağrılır. Kaynak sonradan değişmez; sunucu ifadesinde Functions.<ad>( → WF-030 block.",
+    "update": "function_update TAM gövde PUT'lar ama gateway mevcut kaydı okuyup vermediğin alanları oradan doldurur: gövdeyi değiştirmek için { functionId, body } yeter — ayrı bir patch aracı YOKTUR, fonksiyonun tek büyük alanı gövdedir. source/applicationId/scope/pageId DEĞİŞMEZ. Yanıt dependents (kullanan flow/workflow adları) ve signatureChange (ad ya da parametre ad/sırası) taşır; ikisi de doluysa warnings çağıranların etkileneceğini söyler ve güncelleme YİNE yapılır (K12). Adı değiştirirsen platform çağıranları aynı işlemde yeni ada taşır ve renamedReferences kaç kaydın yazıldığını söyler."
   },
   "functionCreateArgs": {
     "source": "studio",
@@ -55,6 +56,10 @@
     ],
     "body": "return fiyat * adet;"
   },
+  "functionUpdateArgs": {
+    "functionId": "<function_list id>",
+    "body": "return fiyat * adet * 1.2;"
+  },
   "usage": {
     "propBinding": {
       "op": "set_binding",

package/dist/resources/examples/workflow-call-workflow.json

@@ -0,0 +1,115 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "workflow adımı: bir akışın içinden BAŞKA bir kayıtlı akışı çağırır (alt akış). İki şey burada tuzaktır ve ikisi de ölçüldü: hedef ADLA değil rule.workflowId ile (GUID) seçilir, ve alt akışın girdisi YALNIZ rule.expression ile bağlanır — payloadExpression / customParameters kaydedilir ama SESSİZCE yok sayılır. Bu akış lokal stack'te koşturuldu (test projesi, development, 2026-09-16): iki yol da ayrı ayrı ölçüldü.",
+    "harvestedFrom": "canlı ölçüm 2026-09-16 (workflow_preview, test/development) + kod: zeyrek-backend WorkflowStep.cs:22-49, StepRule.cs:23,79-80"
+  },
+  "_rules": {
+    "hedef": "rule.workflowId bir GUID'dir — slug ya da ad DEĞİL. Id'yi workflow_list ile alın. Alt akış aynı application içinde kayıtlı olmalıdır (preview'daki kaydedilmemiş bir akış çağrılamaz).",
+    "girdi": "GİRDİ YALNIZ rule.expression İLE BAĞLANIR ve hedefin parameter DTO'sunun şeklini üretmelidir: \"({ orderId: load_order.data.id })\". Yürütücü ifadeyi yalnız hedef akışın parameterDtoId'si VARSA değerlendirir (WorkflowStep.cs:27-31).",
+    "sessizDusme": "ÖLÇÜLDÜ 2026-09-16: aynı adıma payloadExpression yazıldığında alan kaydedilir, istek 200 döner, adım hatasız görünür — ama alt akış GİRDİSİZ koşar. Preview'da kanıtı şudur: adımın input satırı yalnız { source: 'workflow', member: 'parameter' } olur, expression ve value alanları HİÇ GELMEZ. customParameters da aynı şekilde yok sayılır (36/S-29).",
+    "adAyniAlanUcAnlam": "rule.expression alanı üç adımda ÜÇ FARKLI şey demektir ve adı yanıltır: workflow adımında GİRDİ EŞLEMESİ, code adımında GÖVDE, query adımında PARAMETRE BAĞLAMA. Bir code adımından kopyalayıp workflow adımına yapıştırmayın.",
+    "cikti": "Alt akışın response gövdesi bu adımın çıktısı olur: <adım>.data. Ayrı bir 'çıktı değişkeni' alanı yoktur. İfade bağlamında adım { data, meta, error } şeklindedir (http adımıyla aynı sarmal).",
+    "ciktiyiDtoBicer": "ÖLÇÜLDÜ: alt akışın returnDtoId'si çıktıyı BİÇER. Alt akış bodyExpression'ında DTO'da olmayan bir anahtar dönerse o anahtar yanıttan sessizce düşer — çağıranda eksik alan görürseniz önce alt akışın return DTO'suna bakın.",
+    "hata": "Alt akış patlarsa bu adım fail dalına gider ve alt akışın son hatalı adımının istisnası taşınır (WorkflowStep.cs:49).",
+    "preview": "workflow_preview alt akışı children[] içinde kind:'subWorkflow' olarak TAM adım iziyle döner — girdinin gerçekten bağlanıp bağlanmadığını oradan görürsünüz."
+  },
+  "calleeDefinition": {
+    "name": "Fatura Oluştur",
+    "slug": "fatura-olustur",
+    "description": "Sipariş id'siyle fatura kaydı açar ve fatura numarasını döner.",
+    "type": "workflow",
+    "parameterDtoId": "<girdi DTO id: { orderId: string }>",
+    "parameterBehavior": "object",
+    "returnDtoId": "<çıktı DTO id: { faturaNo: string }>",
+    "returnBehavior": "object",
+    "steps": [
+      {
+        "id": "<GUID-C1>",
+        "name": "Start",
+        "type": "start",
+        "description": "Alt akışı başlatır.",
+        "branches": [{ "id": "<GUID-C2>", "name": "start", "type": "success", "nextStepId": "<GUID-C3>" }]
+      },
+      {
+        "id": "<GUID-C3>",
+        "name": "Response",
+        "type": "response",
+        "description": "Üretilen fatura numarasını döner; çağıran bunu <adım>.data ile okur.",
+        "rule": {
+          "stepType": "response",
+          "bodyExpression": "({ faturaNo: 'FTR-' + input.orderId })",
+          "httpStatusCode": 200
+        },
+        "branches": []
+      }
+    ]
+  },
+  "definition": {
+    "name": "Sipariş Kapat",
+    "slug": "siparis-kapat",
+    "description": "Siparişi kapatır ve fatura akışını çağırarak fatura numarasını döner.",
+    "type": "workflow",
+    "parameterDtoId": "<girdi DTO id: { orderId: string }>",
+    "parameterBehavior": "object",
+    "returnDtoId": "<çıktı DTO id: { faturaNo: string }>",
+    "returnBehavior": "object",
+    "steps": [
+      {
+        "id": "<GUID-1 üret: crypto.randomUUID()>",
+        "name": "Start",
+        "type": "start",
+        "description": "Akışı başlatır.",
+        "branches": [
+          { "id": "<GUID-2>", "name": "start", "type": "success", "nextStepId": "<GUID-3>" },
+          { "id": "<GUID-9>", "name": "global-error", "type": "global-error", "nextStepId": "<GUID-8>" }
+        ]
+      },
+      {
+        "id": "<GUID-3>",
+        "name": "fatura_akisi",
+        "type": "workflow",
+        "description": "Fatura oluşturma akışını çağırır; sipariş id'sini girdi olarak geçer.",
+        "rule": {
+          "stepType": "workflow",
+          "workflowId": "<workflow_list'ten alınan hedef akış id'si>",
+          "expression": "({ orderId: input.orderId })"
+        },
+        "branches": [
+          { "id": "<GUID-4>", "name": "success", "type": "success", "nextStepId": "<GUID-6>" },
+          { "id": "<GUID-5>", "name": "fail", "type": "fail", "nextStepId": null }
+        ]
+      },
+      {
+        "id": "<GUID-6>",
+        "name": "Response",
+        "type": "response",
+        "description": "Alt akışın ürettiği fatura numarasını 200 ile döner.",
+        "rule": {
+          "stepType": "response",
+          "bodyExpression": "({ faturaNo: fatura_akisi.data.faturaNo })",
+          "httpStatusCode": 200
+        },
+        "branches": []
+      },
+      {
+        "id": "<GUID-8>",
+        "name": "onError",
+        "type": "response",
+        "description": "Akış patlarsa hata kodunu ve mesajını 500 ile döner.",
+        "rule": {
+          "stepType": "response",
+          "bodyExpression": "({ code: error.code, message: error.message })",
+          "httpStatusCode": 500
+        },
+        "branches": []
+      }
+    ]
+  },
+  "usage": {
+    "kurulumSirasi": "1) Alt akışın girdi/çıktı DTO'larını aç, 2) alt akışı workflow_create ile KAYDET, 3) dönen id'yi çağıranın rule.workflowId alanına yaz. Kaydedilmemiş bir akış çağrılamaz.",
+    "girdiKontrolu": "workflow_preview çıktısında çağıran adımın input satırına bakın: expression ve value doluysa girdi bağlanmıştır. Yalnız { source: 'workflow', member: 'parameter' } görüyorsanız girdiniz YOK SAYILDI — büyük olasılıkla payloadExpression yazdınız, rule.expression'a taşıyın.",
+    "yanlisYol": "YANLIŞ: rule: { stepType: 'workflow', workflowId: '…', payloadExpression: \"({ orderId: 1 })\" } — kaydedilir, 200 döner, alt akış girdisiz koşar. DOĞRU: aynı ifadeyi rule.expression'a koyun.",
+    "dogrulama": "workflow_preview; yanıtta children[] içinde kind:'subWorkflow' girişinin input alanı beklediğiniz nesne olmalı."
+  }
+}

package/dist/resources/examples/workflow-http-step.json

@@ -0,0 +1,84 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "http adımı: dış (ya da platformun kendi) HTTP ucunu çağırır. Adımın üç ayrı alanı vardır — urlExpression (JS ifadesi, STRING üretir), httpMethod, contentType — ve gövde AYRI BİR ALAN DEĞİLDİR: payloadExpression tek bir ifadeyle { header, body, queryString } ÜÇÜNÜ BİRDEN taşımak zorundadır. Bu akış lokal stack'te koşturuldu (test projesi, development, 2026-09-16): platformun kendi table ucu çağrıldı, 200 döndü ve çıktı şekli ölçüldü.",
+    "harvestedFrom": "canlı ölçüm 2026-09-16 (workflow_preview, test/development) + kod: zeyrek-backend HttpStep.cs:26-99,143-158, StepRule.cs:47-51"
+  },
+  "_rules": {
+    "payloadExpression": "ÜÇ ANAHTAR DA ZORUNLUDUR, boş olsalar bile: ({ body: {}, header: {}, queryString: {} }). Yürütücü üçüne de C# dynamic üye erişimiyle bakar (HttpStep.cs:32,42,59), eksik anahtar adımı RuntimeBinderException ile düşürür. Ölçülen mesaj birebir: \"'System.Dynamic.ExpandoObject' does not contain a definition for 'queryString'\". Bu bir doğrulama hatası değildir; adım fail dalına gider.",
+    "urlExpression": "Bu bir İFADEDİR, düz metin değil: sabit adres tırnak içinde yazılır ('https://api.example.com/v1/rates'), dinamik adres ifadeyle kurulur ('https://api.example.com/orders/' + input.orderId). Tırnaksız yazarsan JS onu değişken sanır ve adım 'x is not defined' ile düşer.",
+    "output": "ÖLÇÜLDÜ 2026-09-16 — ŞEMAYLA ÇELİŞİR. workflow_step_schema('http') returnScheme'i kök seviyede { httpStatusCode, data } ilan ediyor, AMA ifade bağlamında adım { data, meta: { elapsedTime, httpStatusCode, totalCount }, error } şeklindedir: gövde <adım>.data, durum kodu <adım>.meta.httpStatusCode. <adım>.httpStatusCode UNDEFINED döner. Şemaya göre yazarsan sessizce boş değer alırsın.",
+    "responseParsing": "Yanıt gövdesi JSON'a benziyorsa ayrıştırılır, benzemiyorsa SESSİZCE boş nesne ({}) olur (HttpStep.cs:92) — XML dönen uçtan veri alamazsın ve hata da almazsın (36/W-2, açık bulgu). Ham metne erişmenin yolu yoktur.",
+    "contentType": "KOD OKUMASINDAN (bu koşuda ölçülmedi): 'application/json' → JsonContent; 'application/x-www-form-urlencoded' → düz anahtar/değer; BAŞKA BİR DEĞER ya da BOŞ → gövde body.ToString() ile gider ve nesne gövdesi için bu, tip adının kendisidir (HttpStep.cs:63-85). POST/PUT'ta contentType'ı AÇIKÇA yazın.",
+    "stepName": "Adım çıktısına ADIM ADIYLA erişilir, o yüzden ad geçerli bir JS tanımlayıcısı olmalıdır. Boşluklu ad ('Call Roles') ifadede çağrılamaz; ölçümde call_roles is not defined ile düştü. snake_case kullanın.",
+    "authorization": "Token gerekiyorsa header anahtarına koyun: header: { Authorization: 'Bearer ' + system.token }. Adım platformun kendi kimliğini OTOMATİK taşımaz."
+  },
+  "definition": {
+    "name": "Kur Çek",
+    "slug": "kur-cek",
+    "description": "Dış servisten güncel kuru çeker ve gövdesini döner.",
+    "type": "workflow",
+    "returnDtoId": "<çıktı DTO id: { kur: number }>",
+    "returnBehavior": "object",
+    "steps": [
+      {
+        "id": "<GUID-1 üret: crypto.randomUUID()>",
+        "name": "Start",
+        "type": "start",
+        "description": "Akışı başlatır.",
+        "branches": [
+          { "id": "<GUID-2>", "name": "start", "type": "success", "nextStepId": "<GUID-3>" },
+          { "id": "<GUID-9>", "name": "global-error", "type": "global-error", "nextStepId": "<GUID-8>" }
+        ]
+      },
+      {
+        "id": "<GUID-3>",
+        "name": "kur_servisi",
+        "type": "http",
+        "description": "Kur servisini çağırır; yanıtın gövdesi bir sonraki adıma geçer.",
+        "caution": "Dış bağımlılık: servis yavaşlarsa akış bekler, XML dönerse çıktı sessizce boş nesne olur.",
+        "rule": {
+          "stepType": "http",
+          "urlExpression": "'http://zeyrek-test.zeyrek.local/api/test/m/test/olcum-roller'",
+          "httpMethod": "GET",
+          "contentType": "application/json",
+          "payloadExpression": "({ body: {}, header: { 'X-Environment': 'development' }, queryString: {} })"
+        },
+        "branches": [
+          { "id": "<GUID-4>", "name": "success", "type": "success", "nextStepId": "<GUID-6>" },
+          { "id": "<GUID-5>", "name": "fail", "type": "fail", "nextStepId": null }
+        ]
+      },
+      {
+        "id": "<GUID-6>",
+        "name": "Response",
+        "type": "response",
+        "description": "Çekilen gövdeyi ve HTTP durum kodunu 200 ile döner.",
+        "rule": {
+          "stepType": "response",
+          "bodyExpression": "({ veri: kur_servisi.data, durum: kur_servisi.meta.httpStatusCode })",
+          "httpStatusCode": 200
+        },
+        "branches": []
+      },
+      {
+        "id": "<GUID-8>",
+        "name": "onError",
+        "type": "response",
+        "description": "Akış patlarsa hata kodunu ve mesajını 500 ile döner.",
+        "rule": {
+          "stepType": "response",
+          "bodyExpression": "({ code: error.code, message: error.message })",
+          "httpStatusCode": 500
+        },
+        "branches": []
+      }
+    ]
+  },
+  "usage": {
+    "postGovdesi": "POST için: { stepType: 'http', urlExpression: \"'https://api.example.com/orders'\", httpMethod: 'POST', contentType: 'application/json', payloadExpression: \"({ body: { orderId: input.orderId, adet: 2 }, header: { Authorization: 'Bearer ' + system.token }, queryString: {} })\" }",
+    "queryStringKullanimi": "Sorgu parametresi payloadExpression'ın queryString anahtarına konur, URL'e elle eklenmez: queryString: { from: 'USD', to: 'TRY' }.",
+    "onlemliOkuma": "Gövdeyi <adım>.data ile, durum kodunu <adım>.meta.httpStatusCode ile okuyun; şemanın vaat ettiği <adım>.httpStatusCode undefined'dır (ölçüldü 2026-09-16).",
+    "dogrulama": "workflow_preview ile koşturun ve yanıttaki steps[] içinde http adımının input satırlarına bakın: source:'url' ve source:'payload' iki ayrı satır olarak görünür; hata varsa runtimeErrors alanı adımı adıyla sayar."
+  }
+}