@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.7

package/dist/platform/tokenVault.js

@@ -0,0 +1,89 @@
+import { PlatformApiError } from './errors.js';
+import { randomBytes } from 'node:crypto';
+/**
+ * `page_screenshot`/`page_runtime_get` açıklaması "jetonu uygulamanın kendi giriş ucundan alın
+ * (`microservice_execute`)" diyor, ama gizli alan maskesi `access_token`'ı `***` yapıyor ve o yol
+ * kapanıyor (ölçüldü 2026-09-04, benchmark 4. koşu — jeton geçici olarak maskelenmeyen bir alana
+ * taşınıp geri alınarak çalışıldı, yani uygulamanın yanıt sözleşmesi bozuldu).
+ *
+ * Kasa bu çelişkiyi jetonu bağlama HİÇ sokmadan çözer: maskelenen JWT gateway sürecinde tutulur,
+ * yanıta yalnız kısa ömürlü bir referans (`tok_…`) döner ve kimlik isteyen tool'lar referansı
+ * çözer. Jeton ne yanıtta ne günlükte açık görünür.
+ */
+const ttlMs = 15 * 60 * 1000;
+const maxEntries = 64;
+const vault = new Map();
+export const tokenRefPattern = /^tok_[0-9a-f]{16}$/;
+/** Üç base64url parçalı JWT — parola ya da API anahtarı bu şekle uymaz. */
+export function looksLikeJwt(value) {
+    return typeof value === 'string' && /^[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}$/.test(value);
+}
+function sweep(now) {
+    for (const [ref, entry] of vault) {
+        if (entry.expires <= now)
+            vault.delete(ref);
+    }
+    while (vault.size >= maxEntries) {
+        const oldest = vault.keys().next();
+        if (oldest.done)
+            break;
+        vault.delete(oldest.value);
+    }
+}
+export function rememberToken(token) {
+    const now = Date.now();
+    sweep(now);
+    for (const [ref, entry] of vault) {
+        if (entry.token === token) {
+            entry.expires = now + ttlMs;
+            return ref;
+        }
+    }
+    const ref = `tok_${randomBytes(8).toString('hex')}`;
+    vault.set(ref, { token, expires: now + ttlMs });
+    return ref;
+}
+export function resolveToken(reference) {
+    const entry = vault.get(reference);
+    if (!entry)
+        return undefined;
+    if (entry.expires <= Date.now()) {
+        vault.delete(reference);
+        return undefined;
+    }
+    return entry.token;
+}
+export function clearTokenVault() {
+    vault.clear();
+}
+/**
+ * `tok_…` referansı kasadan çözülür, ham JWT olduğu gibi geçer. Süresi dolmuş referans sessizce
+ * başlıksız isteğe DÜŞMEZ — o durumda çağrı anonim gider ve "korumalı uç 401 döndü" diye yanlış
+ * teşhis üretir. Sayfa ve uç araçları aynı sözleşmeyi paylaşsın diye burada yaşar (G-20).
+ */
+export function resolveIdentityToken(value) {
+    if (value === undefined || !tokenRefPattern.test(value))
+        return value;
+    const token = resolveToken(value);
+    if (token === undefined) {
+        throw new PlatformApiError(`'${value}' referansı geçersiz ya da süresi dolmuş (15 dk). Uygulamanın giriş ucunu microservice_execute ile yeniden çağırıp yanıttaki tokenRefs değerini kullanın.`, 400);
+    }
+    return token;
+}
+/**
+ * Kimlik iki kanalda birden taşınır: `Authorization` başlığı VE `NG_AccessToken` çerezi. Middleware
+ * jetonu çerezden okuyor (`cookie.CORE_Token || cookie.NG_AccessToken`), gateway ise yalnız başlık
+ * gönderiyordu; bu yüzden uca middleware bağlandığı anda preview/debug/execute 401'e düşüyordu
+ * (ölçüldü 2026-09-05, Corecruiter koşusu `S-21`). Uygulamanın kendi çerez adı için `cookies`.
+ */
+export function identityHeaders(asUser, cookies, callerHeaders) {
+    const token = resolveIdentityToken(asUser);
+    const cookieText = Object.entries(cookies ?? {}).map(([name, value]) => `${name}=${value}`).join('; ');
+    if (token === undefined && cookieText === '')
+        return callerHeaders;
+    return {
+        ...(token === undefined ? {} : { authorization: `Bearer ${token}` }),
+        ...callerHeaders,
+        ...(cookieText === '' ? {} : { cookie: cookieText })
+    };
+}

package/dist/platform/writeDiff.js

@@ -0,0 +1,281 @@
+import { logStep } from '../observability/trace.js';
+const maxDrops = 20;
+const maxDepth = 12;
+const missing = Symbol('missing');
+/**
+ * Platformun kendi doldurduğu alanlar. Yalnız gönderilen tarafta da varsalar (patch yolunda gövde
+ * okunup geri yazılır) fark üretirlerdi ve bu fark hep gürültüdür: `audit.updatedAt` her yazmada
+ * değişir. 09-05 koşusunda `microservice_patch` yanıtındaki iki satırdan biri buydu.
+ */
+const serverManagedKeys = new Set([
+    'audit', 'createdAt', 'updatedAt', 'createdUserId', 'createdUserName', 'updatedUserId', 'updatedUserName'
+]);
+/**
+ * Platformun KENDİ ürettiği kimlik. Gönderilen id kaydedilenden farklıysa bu bir kayıp değildir:
+ * öğe kaydedilmiştir, yalnız kimliğini platform atamıştır (`args.iteratees[].id`,
+ * `args.parameters[].id` — 09-05 koşusunda `flow_create` 19, `flow_patch` 21 sahte satır üretti ve
+ * ajan hepsini elle ayıkladı). Kaydedilen tarafta id HİÇ yoksa bu muafiyet geçmez; o gerçek bir
+ * kayıptır. Adım ve dal id'leri zaten gönderildiği gibi kaydedilir, dolayısıyla fark üretmezler.
+ */
+const platformAssignedKeys = new Set(['id']);
+/**
+ * Dizi öğelerini indeksle değil KİMLİKLE eşleştirmek için aranan alanlar, öncelik sırasıyla.
+ * Platform diziyi kendi sırasında geri döndürüyor (`flow_get` adımları kayıt sırasında vermiyor);
+ * indeksle karşılaştırma o durumda her öğeyi "değişmiş" gösterir ve diff okunamaz hâle gelir.
+ *
+ * `id` listenin SONUNDADIR: platform onu yeniden atıyor (`platformAssignedKeys`), dolayısıyla
+ * kimlik olarak en zayıf aday odur. `fieldId` başta çünkü `sourceParameters.selectFields`
+ * elemanlarının tek kararlı anahtarı odur — 2026-09-06 koşusunda o dizi başka sırada geri döndü
+ * ve indeks tabanlı karşılaştırma altı sahte satır üretti (`S-1`).
+ */
+const identityKeys = ['fieldId', 'stepId', 'elementId', 'slug', 'name', 'key', 'id'];
+/**
+ * Platformun KABUL EDİP saklamadığı kolaylık alanları. Yanıtta ya hiç yoklar ya da `null`
+ * dönerler; ikisi de kayıp değildir, alan zaten türetilebilir. Her satır hangi ölçümle eklendi:
+ *
+ * - `fieldSlug` — 2026-09-06 koşusu, üç `workflow_create` yanıtında 24 satır
+ *   (`gönderilen "id" ↔ kaydedilen null`). Platform slug'ı `fieldId`'den çözüyor, saklamıyor.
+ *
+ * Muafiyet YALNIZ saklanmama durumunu kapsar: alan dolu ama BAŞKA değerle döndüyse fark yine
+ * bildirilir — orası gerçek bir yeniden yazmadır.
+ */
+export const unstoredKeys = new Set(['fieldSlug']);
+/**
+ * Platformun kanonik adıyla sakladığı eşdeğer değerler. Fark gerçektir ama KAYIP değildir:
+ * `silentlyDropped` yerine `gatewayNormalized` ile bildirilir. Her satır hangi ölçümle eklendi:
+ *
+ * - `type: string ↔ text` — 2026-09-06 koşusu, `queryParameters.type` (`S-1`).
+ */
+const canonicalValues = {
+    type: [['string', 'text']]
+};
+/**
+ * Yolun son alan adı; `tags[0]` ya da `fields[fieldId=x]` gibi indeks/anahtar ekini atar.
+ */
+function leafKey(path) {
+    return (path.split('.').pop() ?? '').replace(/\[[^\]]*\]$/, '');
+}
+function render(value) {
+    const text = JSON.stringify(value) ?? String(value);
+    return text.length > 160 ? `${text.slice(0, 157)}…` : text;
+}
+function identityKeyFor(entries) {
+    const objects = entries.filter((entry) => Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry));
+    if (objects.length === 0 || objects.length !== entries.length)
+        return undefined;
+    return identityKeys.find(key => {
+        const values = objects
+            .map(entry => entry[key])
+            .filter(value => typeof value === 'string' || typeof value === 'number')
+            .map(String);
+        return values.length === objects.length && new Set(values).size === objects.length;
+    });
+}
+function lookup(saved, key) {
+    if (typeof key === 'number')
+        return Array.isArray(saved) && key < saved.length ? saved[key] : missing;
+    if (!saved || typeof saved !== 'object' || Array.isArray(saved))
+        return missing;
+    const record = saved;
+    return Object.hasOwn(record, key) ? record[key] : missing;
+}
+function compare(sent, saved, path, sink, depth) {
+    if (sink.dropped.length >= maxDrops || depth > maxDepth)
+        return;
+    if (Array.isArray(sent)) {
+        if (saved === missing) {
+            sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
+            return;
+        }
+        const key = Array.isArray(saved) ? identityKeyFor(sent) : undefined;
+        const savedByIdentity = key
+            ? new Map(saved
+                .filter((entry) => Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry))
+                .map(entry => [String(entry[key]), entry]))
+            : undefined;
+        // Hiçbir kimlik örtüşmüyorsa anahtar bu dizide anlamlı değildir (öğe yeniden adlandırılmış ya
+        // da dizi baştan yazılmış olabilir); indeksle karşılaştırmak orada daha okunur bir fark üretir.
+        if (key && savedByIdentity && sent.some(entry => savedByIdentity.has(String(entry[key])))) {
+            for (const entry of sent) {
+                const identity = String(entry[key]);
+                compare(entry, savedByIdentity.has(identity) ? savedByIdentity.get(identity) : missing, `${path}[${key}=${identity}]`, sink, depth + 1);
+            }
+            return;
+        }
+        const before = sink.dropped.length;
+        sent.forEach((entry, index) => compare(entry, lookup(saved, index), `${path}[${index}]`, sink, depth + 1));
+        // Sıra tabanlı karşılaştırmada "değişmiş" görünen öğe aslında yer değiştirmiş olabilir. Tek
+        // elemanlı dizide sıra farkı imkânsız olduğu için not düşülmez (2026-09-06 · S-1).
+        if (Array.isArray(saved) && sent.length > 1 && saved.length > 1 && sink.dropped.length > before) {
+            sink.dropped.splice(before, 0, `${path}: (sıra tabanlı karşılaştırma — anahtar yok) aşağıdaki farklar platform diziyi başka sırada sakladıysa yanıltıcıdır`);
+        }
+        return;
+    }
+    if (sent && typeof sent === 'object') {
+        if (saved === missing) {
+            sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
+            return;
+        }
+        for (const [key, entry] of Object.entries(sent)) {
+            if (serverManagedKeys.has(key))
+                continue;
+            compare(entry, lookup(saved, key), path === '' ? key : `${path}.${key}`, sink, depth + 1);
+        }
+        return;
+    }
+    if (sent === null || sent === undefined)
+        return;
+    const field = leafKey(path);
+    if (unstoredKeys.has(field) && (saved === missing || saved === null))
+        return;
+    if (saved === missing) {
+        sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
+        return;
+    }
+    if (sent === saved)
+        return;
+    if (platformAssignedKeys.has(field))
+        return;
+    if (canonicalValues[field]?.some(group => group.includes(String(sent)) && group.includes(String(saved)))) {
+        sink.normalized.push(`${path}: gönderilen ${render(sent)} platformun kanonik adıyla ${render(saved)} olarak saklandı — eşdeğer, kayıp değil`);
+        return;
+    }
+    sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen ${render(saved)}`);
+}
+/**
+ * Sol taraf platforma GİDEN gövdedir (gateway normalizasyonu uygulandıktan sonrası), sağ taraf
+ * platformun döndürdüğü kayıt. Yalnız sol tarafta var olan yollar dolaşılır; sunucunun eklediği
+ * id/createdAt gibi alanlar fark üretmez. Kök hiç örtüşmüyorsa (yanıt bir kabul/kuyruk gövdesiyse)
+ * karşılaştırma yapılmaz — "her şey düştü" gürültüsü yanlış alarmdır.
+ *
+ * İki liste döner: `dropped` gerçekten kaybolan alanlar, `normalized` platformun kanonik adıyla
+ * sakladığı eşdeğerler. İkincisi `gatewayNormalized`a gider, uyarıya değil.
+ */
+export function writeDiff(sent, saved, aliases = {}) {
+    const sink = { dropped: [], normalized: [] };
+    if (!sent || typeof sent !== 'object')
+        return sink;
+    const wrapper = saved && typeof saved === 'object' && !Array.isArray(saved)
+        ? saved
+        : undefined;
+    const inner = wrapper?.data;
+    const root = inner && typeof inner === 'object' ? inner : saved;
+    // Bazı uçlar gönderilen alanı BAŞKA ADLA geri döner (query: parameters → parameterScheme).
+    // Alias verilmezse alan "sessizce düştü" diye raporlanır; bu yanlış alarm 09-04 koşusunda
+    // ajanı parametreleri kaldırmaya yöneltti ve kayıt 500 ile reddedildi (B-15).
+    const comparable = Object.fromEntries(Object.entries(sent)
+        .filter(([key]) => aliases[key] === undefined || lookup(root, aliases[key]) === missing));
+    const keys = Object.keys(comparable);
+    const shared = keys.filter(key => lookup(root, key) !== missing);
+    if (keys.length > 0 && shared.length === 0)
+        return sink;
+    compare(comparable, root, '', sink, 0);
+    if (sink.dropped.length >= maxDrops) {
+        sink.dropped.push(`… ilk ${maxDrops} fark listelendi, daha fazla fark var — gövdeyi *_get ile okuyup karşılaştırın.`);
+    }
+    return sink;
+}
+export function silentlyDropped(sent, saved, aliases = {}) {
+    return writeDiff(sent, saved, aliases).dropped;
+}
+export function withWriteDiff(payload, diff) {
+    const drops = Array.isArray(diff) ? diff : diff.dropped;
+    const normalized = Array.isArray(diff) ? [] : diff.normalized;
+    if (drops.length > 0) {
+        logStep('sessiz düşme ⚠', `${drops.length} alan gönderildi ama kayda geçmedi — platform hata vermeden yok saydı, yanıta silentlyDropped olarak eklenir`, drops);
+    }
+    if (normalized.length > 0) {
+        logStep('düzeltme', `platform ${normalized.length} alanı kanonik adıyla sakladı — eşdeğer, yanıta gatewayNormalized olarak eklenir`, normalized);
+    }
+    if (!payload || typeof payload !== 'object')
+        return payload;
+    if (drops.length === 0 && normalized.length === 0)
+        return payload;
+    const existing = payload.gatewayNormalized;
+    return {
+        ...payload,
+        ...(drops.length > 0 ? { silentlyDropped: drops } : {}),
+        ...(normalized.length > 0
+            ? { gatewayNormalized: [...(Array.isArray(existing) ? existing : []), ...normalized] }
+            : {})
+    };
+}
+/**
+ * Platform şemada her değeri bir Prop nesnesine sarar (`{ type, data, ref? }`) ve iç içe sözlükleri
+ * de sarar: `style: { padding: '40px' }` kaydedilince `style.data.padding = { type: 'static',
+ * data: '40px' }` olur. Micro-op ise HAM değer gönderir. Karşılaştırmadan önce sarmalı açmazsak
+ * doğru kaydedilmiş her prop "değişmiş" görünür.
+ */
+export function unwrapProps(value) {
+    if (Array.isArray(value))
+        return value.map(unwrapProps);
+    if (!value || typeof value !== 'object')
+        return value;
+    const record = value;
+    const isProp = typeof record.type === 'string' && (Object.hasOwn(record, 'data') || Object.hasOwn(record, 'ref'));
+    if (isProp) {
+        // `code` ve `translation` prop'larında taşıyıcı alan `ref`'tir; `data` yalnız tasarım zamanı
+        // yedeğidir (platform_guide('translation')).
+        const carrier = record.type === 'code' || record.type === 'translation'
+            ? (Object.hasOwn(record, 'ref') ? record.ref : record.data)
+            : (Object.hasOwn(record, 'data') ? record.data : record.ref);
+        return unwrapProps(carrier);
+    }
+    return Object.fromEntries(Object.entries(record).map(([key, entry]) => [key, unwrapProps(entry)]));
+}
+function findByElementId(nodes, elementId) {
+    if (!Array.isArray(nodes))
+        return undefined;
+    for (const node of nodes) {
+        if (!node || typeof node !== 'object')
+            continue;
+        const record = node;
+        if (record.elementId === elementId)
+            return record;
+        const found = findByElementId(record.children, elementId);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+/**
+ * Micro-op'un YAZMAK İSTEDİĞİ ile şemada KAYITLI olanı karşılaştırır. Tam gövde yazmalarında
+ * `silentlyDropped` gönderilen gövdeyi dönen kayıtla karşılaştırabiliyor; micro-op yolunda dönen
+ * yanıt yalnız `appliedPatch` olduğu için karşılaştırma yamadan SONRA okunan şemaya dayanır.
+ */
+export function schemaOpDrops(schema, ops) {
+    if (!Array.isArray(ops))
+        return [];
+    const drops = [];
+    for (const op of ops) {
+        if (op.op === 'add_component') {
+            const component = (op.component ?? {});
+            const elementId = String(component.elementId ?? '');
+            const saved = elementId ? findByElementId(schema, elementId) : undefined;
+            if (!elementId)
+                continue;
+            if (!saved) {
+                drops.push(`add_component '${elementId}': komponent şemada bulunamadı — yama 200 döndü ama düğüm kaydedilmemiş.`);
+                continue;
+            }
+            for (const entry of silentlyDropped(unwrapProps(component), unwrapProps(saved))) {
+                drops.push(`add_component '${elementId}' → ${entry}`);
+            }
+            continue;
+        }
+        if (op.op === 'replace_prop' && typeof op.target === 'string' && typeof op.prop === 'string') {
+            const saved = findByElementId(schema, op.target);
+            if (!saved)
+                continue;
+            const props = (saved.props ?? {});
+            if (!Object.hasOwn(props, op.prop)) {
+                drops.push(`replace_prop '${op.target}.${op.prop}': prop şemada yok — değer kaydedilmemiş.`);
+                continue;
+            }
+            for (const entry of silentlyDropped({ [op.prop]: unwrapProps(op.value) }, { [op.prop]: unwrapProps(props[op.prop]) })) {
+                drops.push(`replace_prop '${op.target}' → ${entry}`);
+            }
+        }
+    }
+    return drops.slice(0, maxDrops);
+}

package/dist/resources/examples/flow-call-function.json

@@ -0,0 +1,66 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Bir butonun click olayına bağlanan akış: 'function' adımı kullanıcı fonksiyonunu çağırır (fiyat komponent prop'undan, adet sabit), sonraki setter sonucu Steps.<adımAdı>.data'dan okuyup metne yazar. Canlı kanıt: 2026-09-08/09 fonksiyon-demo sayfası (kabul senaryosu 2 → 30). Şekil backend StepManagementSchema + ng-apps-flow tasks/function/function.ts okunarak kuruldu.",
+    "harvestedFrom": "kod + canlı doğrulama: zeyrek-frontend packages/ng-apps-flow/src/tasks/function, zeyrek-backend Contexts/Studio/Flows/StepArgument (UiFunctionId/UiFunctionName) (2026-09-09)"
+  },
+  "_rules": {
+    "functionId": "args.functionId ZORUNLU ve uygulamada var olmalı — backend 422 UiFunctionNotFound, gateway FLOW-024 (block). Id'yi function_list'ten alın. Runtime fonksiyonu ÖNCE id ile çözer (K9); functionName gösterim ve yedektir.",
+    "parameters": "parameters[].name bildirimdeki parametre adıyla eşleşir; value şekli microservice adımıyla aynı (static · property · storage · state · variable · code · page · item). Eksik zorunlu parametre adımı 'Functions.<ad>: \"<param>\" is required' ile düşürür; tanınmayan ad sessizce düşer — FLOW-024 ikisini de uyarır.",
+    "output": "Çıktı Steps.<adım ADI>.data (stepId değil — machine.setStorage(task.name, …)); hata Steps.<ad>.error.message (nesne). Setter'ın storage okuması mapping.source: 'hesapla.data' ile yapılır (setter.ts:161 mapping.source doluysa value.ref okunmaz).",
+    "branchName": "Dal adı 'always' (motor anahtarı, FLOW-004). Son adımın dalı nextStepId: null ile biter; 'end' adımı koyma (FLOW-023).",
+    "binding": "Akışı olaya bağlamak ayrı adımdır: page_schema_patch set_event { target: 'btn_hesapla', event: 'click', eventValue: '<flow id>' }.",
+    "async": "isAsync=true fonksiyon bu adımdan güvenle çağrılır (Promise beklenir); {{ }} bağlamasında ise '[object Promise]' olur."
+  },
+  "flowCreateArgs": {
+    "host": "page",
+    "hostId": "<page id>",
+    "name": "btn_hesapla - click",
+    "slug": "btn-hesapla-click",
+    "steps": [
+      {
+        "stepId": "start",
+        "name": "start",
+        "type": "start",
+        "kind": "normal",
+        "args": {},
+        "branches": [ { "name": "always", "nextStepId": "hesapla" } ]
+      },
+      {
+        "stepId": "hesapla",
+        "name": "hesapla",
+        "type": "function",
+        "kind": "normal",
+        "args": {
+          "functionId": "<function_list id — toplamHesapla>",
+          "functionName": "toplamHesapla",
+          "parameters": [
+            { "name": "fiyat", "value": { "type": "property", "ref": { "source": "component", "element": "num_fiyat", "property": "value" } } },
+            { "name": "adet", "value": { "type": "static", "ref": 3 } }
+          ]
+        },
+        "branches": [ { "name": "always", "nextStepId": "yaz" } ]
+      },
+      {
+        "stepId": "yaz",
+        "name": "yaz",
+        "type": "setter",
+        "kind": "normal",
+        "args": {
+          "iteratees": [
+            {
+              "type": "change",
+              "element": "txt_sonuc",
+              "property": "content",
+              "source": "component",
+              "mapping": { "source": "hesapla.data", "mappings": {} },
+              "value": { "type": "storage", "ref": "" }
+            }
+          ]
+        },
+        "branches": [ { "name": "always", "nextStepId": null } ]
+      }
+    ]
+  },
+  "bindEvent": { "op": "set_event", "target": "btn_hesapla", "event": "click", "eventValue": "<flow id>" }
+}

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

@@ -0,0 +1,70 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "toplamHesapla(fiyat, adet = 1) = fiyat * adet — aynı gövde İKİ KAYNAKTA: source:'studio' (uygulama kapsamlı, tarayıcı: {{ }} bağlaması ve UI flow 'code'/'function' adımı) ve source:'workflow' (sunucu: workflow/middleware/automation ifadesinde çıplak ad). Kod ve parametre biçimi aynıdır, fark nerede çalıştığıdır. Canlı kanıt: 2026-09-10 fonksiyon-demo sayfası ({{ Functions.toplamHesapla(10, 3) }} → 30) ve workflow_preview code adımı (return toplamHesapla(10, 3) → 30).",
+    "harvestedFrom": "kod + canlı doğrulama: zeyrek-backend Contexts/Studio/GlobalFunctions, zeyrek-frontend packages/ng-apps-flow/src/functions (2026-09-10)"
+  },
+  "_rules": {
+    "body": "Gövde DÜZ deyimlerdir, iki kaynakta aynı: 'return fiyat * adet;'. function (…) { } sarmalı ya da arrow yazılmaz. return serbesttir; dönüşsüz gövde undefined döner. Platform kaydetmeden sözdizimini ayrıştırır (422 GlobalFunctionBodyInvalid).",
+    "parameters": "Bildirim SIRALIDIR ve çağrı KONUMSALDIR (K5): toplamHesapla(10, 3) → fiyat=10, adet=3. defaultValue argüman undefined kalınca uygulanır; required kontrolü ondan SONRA çalışır ve 'toplamHesapla: \"fiyat\" is required' (studio'da 'Functions.toplamHesapla: …') fırlatır. type yalnız Studio imzası içindir, çalışma zamanı tip denetlemez.",
+    "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."
+  },
+  "functionCreateArgs": {
+    "source": "studio",
+    "applicationId": "<application id>",
+    "scope": "application",
+    "name": "toplamHesapla",
+    "description": "fiyat × adet; adet verilmezse 1 sayılır",
+    "isAsync": false,
+    "parameters": [
+      {
+        "name": "fiyat",
+        "type": "number",
+        "required": true,
+        "description": "Birim fiyat"
+      },
+      {
+        "name": "adet",
+        "type": "number",
+        "defaultValue": 1,
+        "description": "Adet; verilmezse 1"
+      }
+    ],
+    "body": "return fiyat * adet;"
+  },
+  "workflowFunctionCreateArgs": {
+    "source": "workflow",
+    "name": "toplamHesapla",
+    "description": "fiyat × adet; adet verilmezse 1 sayılır",
+    "parameters": [
+      {
+        "name": "fiyat",
+        "type": "number",
+        "required": true,
+        "description": "Birim fiyat"
+      },
+      {
+        "name": "adet",
+        "type": "number",
+        "defaultValue": 1,
+        "description": "Adet; verilmezse 1"
+      }
+    ],
+    "body": "return fiyat * adet;"
+  },
+  "usage": {
+    "propBinding": {
+      "op": "set_binding",
+      "target": "txt_toplam",
+      "prop": "content",
+      "expression": "{{ Functions.toplamHesapla(10, 3) }}"
+    },
+    "uiFlowCodeStep": "const toplam = Functions.toplamHesapla(num_fiyat.value, num_adet.value);\nstate.page.sonuc = toplam;",
+    "uiFlowFunctionStep": "ngapps://examples/flow-call-function",
+    "workflowCodeStep": "return { toplam: toplamHesapla(10, 3) };",
+    "automationCondition": "toplamHesapla(row.fiyat, row.adet) > 1000"
+  }
+}

package/dist/resources/examples/layout-app-shell.json

@@ -12,7 +12,7 @@
     "slotRowIsOpenEnded": "Slot'un grid satırı açık uçludur (runtime 'y / auto' yazar): sayfa uzadıkça slot uzar. Slot'a sabit yükseklik vermeye çalışma.",
     "positionComesFromBlocks": "Konum ve boyut blocks[]'ten gelir. layout-region'daki dock prop'u konum DEĞİL biçim belirler; bu örnekte region hiç kullanılmıyor.",
     "gridStacksFlexDoesNot": "Bu örnek layout:'flex' — fill'in 'kalanı doldur' anlamı flex'te tanımlıdır (sütunda flex:1 1 auto, satırda align-self:stretch). Bedeli MOBİL: runtime'ın mobil kuralı yalnız ızgara özelliklerini ezer, flex satırı telefonda yan yana kalır (375px'te ölçüldü: 49/310px). Telefonda alt alta düşmesi gereken kabuk için kökü layout:'grid' kur; o zaman yükseklik yine blocks satırlarından gelir.",
-    "fixedPxWidthIsFlexOnly": "Bu örnek flex olduğu için yan menüye appearance.widthPx:240 verilebilir; verilmezse genişlik kolon payıdır (12'de 2 ≈ 1440px tasarım genişliğinde 240px). Izgara kabında widthPx okunmaz.",
+    "fixedPxWidthIsFlexOnly": "Bu örnek flex olduğu için yan menüye appearance.widthType:'fixed' + appearance.widthString:'240px' verilebilir (serbest CSS uzunluğu; string yalnız 'fixed' modda okunur). Öteki modlar: 'fill' kabın tüm genişliği, 'auto' içerik kadar; widthType hiç verilmezse genişlik kolon payıdır (12'de 2 ≈ 1440px tasarım genişliğinde 240px). Izgara kabında widthString okunmaz. Üç modun bir arada örneği: ngapps://examples/page-flex-sections.",
     "navigationsStyleIsDead": "navigations'ın style prop'u hiçbir şey yapmaz (Navigations.svelte style prop'u kabul etmiyor) — menü satırı biçimlendirmeye çalışma.",
     "verifyWithRuntime": "Layout'un kendi serve URL'i yok: gerçek çıktıyı layout'a bağlı bir sayfada page_runtime_get ile, slot kurgusunu page_state.layoutSlots ile doğrula.",
     "wrapperRoot": "Kök, sayfanın page_container'ının yerleşim ikizidir: states.isWrapper:true (çerçevesiz, başlıksız, saydam) + blocks x0/w12. Sarmalayıcı olmayan bir kök kenarlıklı beyaz bir kart olarak çizilir.",

package/dist/resources/examples/microfunction-node-sum.json

@@ -0,0 +1,56 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "test-project/development ortamında gerçek uçta doğrulandı (2026-09-11): publish:true ile kayıt 'publishing' döndü ve 'published' oldu (publishedReference zf-test-project-development-...), microfunction_invoke {a:1,b:2} → ok:true output {total:3, environment:'development'}, aynı akışa bağlı microservice_execute → 200 {total:3}. Kurallar: inline kaynakta entrypoint GÖNDERİLMEZ (sabit function.handler); timeoutSeconds ve memoryMb non-nullable int'tir, eksik gönderilirse platform 422 döner; adım rule.microfunctionId YALNIZ published kaydı gösterebilir (WF-MF-001)."
+  },
+  "microfunction": {
+    "name": "toplam",
+    "description": "İki sayıyı toplar ve hangi ortamda koştuğunu döner.",
+    "language": "node",
+    "provider": "built-in",
+    "sourceKind": "inline",
+    "code": "exports.handler = async (args, context) => {\n  return { total: (args.a ?? 0) + (args.b ?? 0), environment: context.environment }\n}\n",
+    "parameterDtoId": "<girdi DTO id: { a: number, b: number }>",
+    "parameterBehavior": "object",
+    "returnDtoId": "<çıktı DTO id: { total: number, environment: string }>",
+    "returnBehavior": "object",
+    "timeoutSeconds": 30,
+    "memoryMb": 256,
+    "publish": true
+  },
+  "workflowStep": {
+    "id": "<GUID-3>",
+    "name": "toplam",
+    "type": "microfunction",
+    "description": "Girdideki iki sayıyı microfunction'da toplar.",
+    "rule": {
+      "microfunctionId": "<yukarıdaki kaydın id'si; status published olmalı>",
+      "expression": "({ a: input.a, b: input.b })"
+    },
+    "branches": [
+      {
+        "id": "<GUID-4>",
+        "name": "success",
+        "type": "success",
+        "nextStepId": "<response adımının id'si>"
+      },
+      {
+        "id": "<GUID-5>",
+        "name": "fail",
+        "type": "fail",
+        "nextStepId": null
+      }
+    ]
+  },
+  "responseStep": {
+    "id": "<GUID-6>",
+    "name": "Respond",
+    "type": "response",
+    "description": "Toplamı çağırana döner.",
+    "rule": {
+      "dataTransferObjectId": "<çıktı DTO id>",
+      "expression": "({ total: Steps.toplam.data.total })"
+    },
+    "branches": []
+  }
+}

package/dist/resources/examples/microservice-table-list.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "synthetic": true,
-    "note": "hr + sms projelerinde doğrulanmış şekil. Kurallar: operation 'list' YOK → get + isSingle:false; kökte entityId zorunlu; selectFields'ta fieldId zorunlu + alias = entity slug; join'li alanlarda path = ilişki alanı id zinciri (kök alanlarda path yazılmaz), joins[].path = kökEntityId + aynı zincir — path boş bırakılırsa runtime çalışır ama Studio join alanlarını seçili gösteremez; sort/limit her zaman verilir yoksa Studio formu null'da patlar; filtre value alanı JavaScript ifadesidir."
+    "note": "hr + sms projelerinde doğrulanmış şekil. Kurallar: operation 'list' YOK → get + isSingle:false; kökte entityId zorunlu; selectFields'ta fieldId zorunlu + alias = entity slug; join'li alanlarda path = ilişki alanı id zinciri (kök alanlarda path yazılmaz), joins[].path = kökEntityId + aynı zincir — path boş bırakılırsa runtime çalışır ama Studio join alanlarını seçili gösteremez; sort/limit her zaman verilir yoksa Studio formu null'da patlar; filtre value alanı JavaScript ifadesidir. isReturnSchemaArray/isParameterSchemaArray örnekten ÇIKARILDI (2026-09-07): ikisi de yalnız okuma modelinde (MicroserviceDto) var, Create/UpdateMicroserviceCommand'da yok — gönderilirse sessizce yok sayılırlar."
   },
   "definition": {
     "name": "Get Products",
@@ -43,8 +43,6 @@
         "source": "query-string"
       }
     },
-    "entityId": "<products entity id>",
-    "isReturnSchemaArray": true,
-    "isParameterSchemaArray": false
+    "entityId": "<products entity id>"
   }
 }

package/dist/resources/examples/page-dynamic-form.json

@@ -11,7 +11,7 @@
     "twoWayBinding": "Çocuk komponentin prop'u {type:'code', ref:'{{ item.<alan> }}'} kalıbına TAM uyuyorsa kullanıcı değiştirdiğinde runtime değeri rows.data[<index>].<alan>'a geri yazar (repeater.handler.ts → handleRepeaterItemPropertySet). Flow gerekmez. Kalıp bozulursa ('{{ item.answer || \"\" }}') okur ama YAZMAZ.",
     "rowId": "Satırlara kalıcı bir id ver: getRepeaterRowId sırayla row._id / row.id / index'e bakar; id yoksa index'e düşer ve liste değişince girilen değerler kayar.",
     "variantsSameCell": "Satır tipine göre farklı alan göstermek için TÜM varyantları AYNI blocks[].position'a koy ve isHidden ile ayır — alt alta dizersen gizli olanların ızgara satırları boş kalır. Bu yalnız page_schema_patch yolunda güvenlidir (micro-op hattı çakışma normalizasyonu uygulamaz).",
-    "isHiddenGap": "isHidden her komponentte YOK (radio/textarea/container/form/button var; text ve multi-select yok). Gizlenecek komponenti isHidden'ı olan bir container'a sar ve koşulu SARMALAYICIYA bağla. Sarmalayıcı states.isWrapper:false olmalı (isWrapper → min-height:80vh).",
+    "isHiddenGap": "isHidden artık 101 kaydın 99'unda tanımlıdır (2026-08-26 toplu eklemesi; tanımlamayan yalnız slot ve widget-area) — text ve multi-select dahil çoğu komponente doğrudan yazılabilir. Sarmalayıcı yalnız birden çok düğümü TEK koşulla gizlemek gerektiğinde kullanılır; o zaman states.isWrapper:false olmalı (isWrapper → min-height:80vh).",
     "readBack": "Toplu okuma flow'da <repeaterAdı>.rows'tur; microservice parametresinin value.type:'code' ifadesinde ve condition expression'ında komponentlere ADIYLA erişilir. Kod bağlamında satırlar HAM gelir; machine.getNode ile bakarsan {data,type} sarılı görünür.",
     "perRowValidation": "Satır BAŞINA validation kurulamaz — validations komponentin kendisindedir ve tüm satırlar paylaşır. Zorunluluğu satır verisinde taşı (required) ve gönderim akışının ilk condition adımında denetle (guard adımı).",
     "flowGuids": "branches[].id ve iteratees[].id GUID'leri TÜM projede tekildir. Başka bir akıştan kopyaladığın gövdeyi aynı GUID'lerle gönderirsen platform RowAlreadyExists döner ve hata slug çakışması gibi okunur — bütün id alanlarını yenile.",
@@ -25,7 +25,7 @@
       "page_container (container, isWrapper:true — tema değişkenleri ve ortalanmış sütun BURADA)",
       "├─ t_title (text, h1)",
       "├─ t_desc  (text, p)",
-      "├─ q_form (form, isWrapper:false, hideBorders+hidePadding)",
+      "├─ q_form (form, isWrapper:false, style: border none + padding 0)",
       "│  └─ q_list (repeater, isWrapper:false, rows:[], autoRowSize:true, verticalSpacing:14)",
       "│     └─ q_card (container, isWrapper:false)            ← ŞABLONUN KÖKÜ",
       "│        ├─ q_head (text)      y:0   content: {{ item.no + '. ' + item.text + (item.required ? ' *' : '') }}",
@@ -33,7 +33,7 @@
       "│        ├─ a_choice (radio)   y:2   isHidden: {{ !(item.is_single || item.is_yesno) }}",
       "│        ├─ a_text (textarea)  y:2   isHidden: {{ !item.is_text }}",
       "│        └─ box_multi (container) y:2  isHidden: {{ !item.is_multi }}",
-      "│           └─ a_multi (multi-select)  ← kendi isHidden'ı yok, o yüzden sarmalı",
+      "│           └─ a_multi (multi-select)  ← kendi isHidden'ı artık VAR; sarmal bu örneğin geçmişinden kaldı",
       "├─ box_state (container, isHidden:true) → t_state (text)   ← hata şeridi",
       "└─ btn_submit (button, type:'button')"
     ]