@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.8

package/dist/platform/csv.js

@@ -0,0 +1,123 @@
+/**
+ * Gateway'in kendi minimal RFC 4180 okuyucusu. `packages/ng-apps-ui`'daki `csv-parse.ts`
+ * kopyalanmaz: o dosya tarayıcı için yazılmıştır ve bu proje frontend workspace'ine dahil
+ * değildir (sözleşme D5) — kopya iki yerde birden bozulurdu.
+ *
+ * Değerler HEP string döner. Tip dönüşümü backend'in işidir: `1.234,56` ile `1,234.56` arasındaki
+ * fark kültüre bağlıdır ve gateway istek kültürünü bilmez.
+ */
+/**
+ * Ayraç ilk satırdan tahmin edilir. Türkçe Excel `;` ile yazar ve o dosyalarda virgül ONDALIK
+ * AYRACIDIR — yanlış tahmin `1,5` değerini iki sütuna böler, hem de sessizce.
+ */
+export function detectDelimiter(firstLine) {
+    let semicolons = 0;
+    let commas = 0;
+    let quoted = false;
+    for (const character of firstLine) {
+        if (character === '"')
+            quoted = !quoted;
+        else if (quoted)
+            continue;
+        else if (character === ';')
+            semicolons += 1;
+        else if (character === ',')
+            commas += 1;
+    }
+    return semicolons > commas ? ';' : ',';
+}
+function stripBom(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+function firstLineOf(text) {
+    let quoted = false;
+    for (let index = 0; index < text.length; index += 1) {
+        const character = text[index];
+        if (character === '"')
+            quoted = !quoted;
+        else if (!quoted && (character === '\n' || character === '\r'))
+            return text.slice(0, index);
+    }
+    return text;
+}
+/**
+ * Satır satır hücre dizisi. Tırnaklı hücre ayraç ve satır sonu taşıyabilir, `""` tek tırnaktır;
+ * tamamen boş satırlar atılır — Excel'in dosya sonuna bıraktığı boş satır aksi hâlde her alanı
+ * boş bir kayıt üretirdi.
+ */
+export function parseCsv(text, delimiter) {
+    const content = stripBom(text);
+    const separator = delimiter ?? detectDelimiter(firstLineOf(content));
+    const rows = [];
+    let row = [];
+    let value = '';
+    let quoted = false;
+    let index = 0;
+    const endValue = () => {
+        row.push(value);
+        value = '';
+    };
+    const endRow = () => {
+        endValue();
+        if (row.some(cell => cell.length > 0))
+            rows.push(row);
+        row = [];
+    };
+    while (index < content.length) {
+        const character = content[index];
+        if (quoted) {
+            if (character === '"') {
+                if (content[index + 1] === '"') {
+                    value += '"';
+                    index += 2;
+                    continue;
+                }
+                quoted = false;
+                index += 1;
+                continue;
+            }
+            value += character;
+            index += 1;
+            continue;
+        }
+        if (character === '"' && value.length === 0) {
+            quoted = true;
+            index += 1;
+            continue;
+        }
+        if (character === separator) {
+            endValue();
+            index += 1;
+            continue;
+        }
+        if (character === '\r' || character === '\n') {
+            endRow();
+            index += character === '\r' && content[index + 1] === '\n' ? 2 : 1;
+            continue;
+        }
+        value += character;
+        index += 1;
+    }
+    if (value.length > 0 || row.length > 0)
+        endRow();
+    return rows;
+}
+/**
+ * Başlık satırını anahtar yapan satır sözlükleri. Başlık boş olan sütun atlanır (Excel'in sağa
+ * doğru uzattığı boş sütunlar aksi hâlde `''` anahtarlı bir alan üretirdi) ve fazladan hücre
+ * taşıyan satır kırpılır.
+ */
+export function csvRows(text, delimiter) {
+    const grid = parseCsv(text, delimiter);
+    if (grid.length === 0)
+        return [];
+    const headers = (grid[0] ?? []).map(header => header.trim());
+    return grid.slice(1).map(cells => {
+        const row = {};
+        headers.forEach((header, column) => {
+            if (header.length > 0)
+                row[header] = cells[column] ?? '';
+        });
+        return row;
+    });
+}

package/dist/platform/errors.js

@@ -1,6 +1,12 @@
 export class PlatformApiError extends Error {
     status;
     code;
+    /**
+     * Toplu satır yazmasında düşen satırın parti içi indeksi (`BulkRowErrorResponse.rowIndex`).
+     * Mesajda da geçer ama metinden ayıklanamaz: parti döngüsü dosya satır numarasını hesaplamak
+     * için sayıya ihtiyaç duyar, çağıran hangi satırı düzelteceğini ancak öyle bilir.
+     */
+    rowIndex;
     constructor(message, status, code) {
         super(message);
         this.status = status;
@@ -50,6 +56,56 @@ function collectValidationMessages(payload) {
  * hatalı prop'ları sessizce kaydediyordu). Orada op listesi yoktur ve `page_schema_validate` de
  * uygulanmaz — ipucu bu yüzden yola göre ayrışır.
  */
+/**
+ * Merge apply'ın iki 409'u da aynı şeyi söyler: plan artık uygulanabilir değil. Ajan bunu
+ * 'geçici hata, tekrar dene' diye okuyup aynı çağrıyı yollamasın diye yol açıkça yazılır.
+ */
+function mergeHint(path) {
+    if (!/\/merges\//.test(path))
+        return '';
+    return " Üç sebepten biri: çözülmemiş çakışma, ya da plan alındığından beri DALIN veya development’ın değişmesi (MergePlanStaleException) — ikincisinde planın taşıdığı liste eskidir ve uygulansaydı sonradan yapılan iş sessizce düşerdi. merge_get ile planı yeniden okuyun (isStale), bayatsa merge_refresh ile tazeleyin — yeni plan açmanız gerekmez. Aynı merge_apply çağrısını tekrarlamak sonucu değiştirmez.";
+}
+function mergeRevertHint(code) {
+    if (code === 'MergeRevertWindowExpiredException') {
+        return " Geri alma penceresi doldu: pencere kapanınca merge öncesi anlık görüntü de silinir, bu yüzden plan artık geri alınamaz. merge_list status:'applied' ile pencere içindeki bir plan seçin.";
+    }
+    if (code === 'MergePlanNotRevertableException') {
+        return ' Bu plan bir GERİ ALMA planı (kind=revert) ve geri almanın geri alması yoktur. Geri almayı iptal etmek istiyorsanız dalı yeniden merge edin.';
+    }
+    if (code === 'MergePlanNotAppliedException') {
+        return " Plan uygulanmış DEĞİL — durumu mesajda yazıyor (failed / discarded / reverted / planned…). Yalnız 'applied' ve 'applied-with-drift' geri alınabilir; merge_list status:'applied' ile uygun planı seçin. Zaten geri alınmış bir planın durumu 'reverted'dır ve ikinci kez geri alınamaz.";
+    }
+    return '';
+}
+/**
+ * İçe aktarma zinciri dört çağrıdır ve her hata farklı bir adıma geri gönderir: plan süresi
+ * dolduysa analizden, anahtar benzersiz değilse plan gövdesinden, hata oranı yüksekse dosyanın
+ * kendisinden. Kod olmadan mesajlar "422" diye okunur ve ajan aynı çağrıyı tekrarlar.
+ */
+function importHint(code, path) {
+    if (code === 'ImportPlanExpiredException') {
+        return ' Plan bir saat geçerlidir ve süresi doldu (ya da başka bir kullanıcıya ait). import_analyze ile dosyayı yeniden okuyup import_plan ile yeni bir plan üretin — aynı planId bir daha çalışmaz.';
+    }
+    if (code === 'ImportTooManyErrorsException') {
+        return " Satırların yarısından fazlası kuru koşuda düştü. Önce planın `errors` listesine bakın: çoğu zaman tek bir yanlış `locale` ya da yanlış sütun tipi bütün satırları düşürür. Dosya gerçekten böyleyse import_run'ı `force: true` ile çağırın.";
+    }
+    if (code === 'ImportKeyFieldNotUniqueException') {
+        return " Upsert/update anahtarı benzersiz olmalı: alanın kendisi unique/primary key olmalı, ya da tek alanlı bir unique index taşımalı, ya da 'id'/'code' olmalı. entity_get ile alanın `unique` bayrağını doğrulayın.";
+    }
+    if (code === 'ImportRelationMatchFieldNotUniqueException') {
+        return ' Ad → id eşlemesi yalnız hedef tablonun display alanı ya da benzersiz bir alanıyla yapılır; benzersiz olmayan bir alanda aynı ad iki satıra gidebilir ve hangisinin yazılacağı belirsiz olur.';
+    }
+    if (code === 'ImportSheetEmptyException' || code === 'ImportRowLimitExceededException') {
+        return ' `headerRow` doğru mu kontrol edin (0 = başlık yok); satır sınırı aşıldıysa dosyayı sayfalara bölün.';
+    }
+    if (code === 'DataJobNotUndoableException' && path.endsWith('/cancel')) {
+        return ' İş zaten bitmiş (completed / failed / undone / cancelled); iptal edilecek bir şey yok. Tamamlanmış işi geri almak için import_undo.';
+    }
+    if (code === 'DataJobNotUndoableException' && path.endsWith('/undo')) {
+        return ' Yalnız tamamlanmış ve undoAvailableUntil geçmemiş bir içe aktarma geri alınır; mevcut tabloya yalnız ekleme yapan işin penceresi hiç açılmaz. Süren işi durdurmak için import_cancel.';
+    }
+    return '';
+}
 function pageSchemaHint(code, path) {
     if (code === 'PageSchemaVersionConflictException') {
         return ' Sayfa siz okuduktan sonra değişti ve HİÇBİR op uygulanmadı. page_schema_get ile yeniden okuyup planı tazeleyin, yeni `version` değerini `baseVersion` olarak gönderin.';
@@ -133,7 +189,7 @@ export function mapPlatformError(status, payload, context) {
         if (validationMessages.length > 0) {
             return new PlatformApiError(`Doğrulama hatası (${location}): ${validationMessages.join(' ; ')}. Gövde şeması için ilgili ngapps://schemas kaynağına ya da mevcut bir kaydın *_get çıktısına bakın.`, status, code);
         }
-        return new PlatformApiError(`Geçersiz istek (${location}): ${apiMessage ?? 'API gövdeyi reddetti.'}`, status, code);
+        return new PlatformApiError(`Geçersiz istek (${location}): ${apiMessage ?? 'API gövdeyi reddetti.'}${mergeRevertHint(code)}${importHint(code, context.path)}`, status, code);
     }
     if (status === 401) {
         const hint = context.authMode === 'local'
@@ -151,7 +207,7 @@ export function mapPlatformError(status, payload, context) {
         if (context.method !== 'GET' && /\/flows(\/|$)/.test(context.path)) {
             return new PlatformApiError(`Adımda referans verilen kayıt çözümlenemedi (${location}). Bu uçta 404 akışın kendisini DEĞİL bir adım argümanını kastediyor: flow-trigger adımının args'ında ne flowId ne triggerElementId var (ya da triggerElementId sayfadaki hiçbir elementId ile eşleşmiyor), setter adımının iteratees[].element'i bulunamıyor, ya da bir adım silinmiş bir komponente bakıyor. Adım argümanlarını page_schema_get'teki elementId'lerle karşılaştırın; flow-trigger'ın iki geçerli şekli için platform_guide('page') Kural 1c.`, status, code);
         }
-        return new PlatformApiError(`Kayıt bulunamadı (${location}).${environmentHint} id/slug değerini ilgili *_list tool'uyla doğrulayın.`, status, code);
+        return new PlatformApiError(`Kayıt bulunamadı (${location}).${environmentHint} id/slug değerini ilgili *_list tool'uyla doğrulayın.${importHint(code, context.path)}`, status, code);
     }
     if (status === 409 || status === 422) {
         const projectConflictHint = status === 409 && context.method === 'POST' && /\/projects\/?$/.test(context.path)
@@ -159,7 +215,10 @@ export function mapPlatformError(status, payload, context) {
             : '';
         const validationMessages = collectValidationMessages(body);
         const detail = validationMessages.length > 0 ? ` → ${validationMessages.join(' ; ')}` : '';
-        return new PlatformApiError(`İş kuralı reddetti (${location}): ${apiMessage ?? 'çakışma'}${code ? ` [${code}]` : ''}${detail}${projectConflictHint}${pageSchemaHint(code, context.path)}${bulkRowHint(code)}${versionConflictHint(code, context.path)}`, status, code);
+        const rejected = new PlatformApiError(`İş kuralı reddetti (${location}): ${apiMessage ?? 'çakışma'}${code ? ` [${code}]` : ''}${detail}${projectConflictHint}${pageSchemaHint(code, context.path)}${bulkRowHint(code)}${importHint(code, context.path)}${versionConflictHint(code, context.path)}${mergeHint(context.path)}`, status, code);
+        if (typeof body.rowIndex === 'number')
+            rejected.rowIndex = body.rowIndex;
+        return rejected;
     }
     const fallbackValidationMessages = collectValidationMessages(body);
     const fallbackDetail = fallbackValidationMessages.length > 0 ? ` → ${fallbackValidationMessages.join(' ; ')}` : '';

package/dist/platform/http.js

@@ -42,8 +42,16 @@ function appendQuery(url, query) {
         if (value === undefined || value === null || value === '')
             continue;
         if (Array.isArray(value)) {
-            for (const entry of value)
-                url.searchParams.append(key, String(entry));
+            if (value.some(entry => entry !== null && typeof entry === 'object')) {
+                url.searchParams.append(key, JSON.stringify(value));
+            }
+            else {
+                for (const entry of value)
+                    url.searchParams.append(key, String(entry));
+            }
+        }
+        else if (typeof value === 'object') {
+            url.searchParams.append(key, JSON.stringify(value));
         }
         else {
             url.searchParams.append(key, String(value));
@@ -125,6 +133,7 @@ export class Platform {
             ...(authorization === undefined ? {} : { authorization }),
             ...(options.environment ? { 'x-environment': options.environment } : {}),
             ...callerHeaders,
+            'x-client': 'mcp',
             ...(options.mirrorAuthorizationCookie && authorization !== undefined && callerHeaders.cookie === undefined
                 ? { cookie: `NG_AccessToken=${authorization.replace(/^Bearer /, '')}` }
                 : {})

package/dist/platform/responses.js

@@ -1,5 +1,6 @@
 import { logError, logStep } from '../observability/trace.js';
 import { PlatformApiError } from './errors.js';
+import { PolicyBlockError } from '../knowledge/policy.js';
 import { maskSecrets } from './secrets.js';
 export function prune(value) {
     if (Array.isArray(value))
@@ -126,12 +127,15 @@ function asStructured(payload) {
         return payload;
     return { data: payload };
 }
-export function toolResult(payload, config) {
+export function toolResult(payload, config, expectFailure) {
     const pruned = prune(payload);
     const { payload: safe, masked, tokenRefs } = maskSecrets(pruned);
     const runtimeErrors = runtimeErrorSummary(safe);
     if (runtimeErrors.length > 0) {
-        logStep('akış hatası ✕', `${runtimeErrors.length} adım hata ile bitti — platform HTTP 200 döndürdüğü için çağrı başarılı görünüyordu`, runtimeErrors);
+        // Kasıtlı negatif test (expectFailure:true) bir kusur değil bir KANIT: çağıran beklediğini
+        // söylediyse SONUÇ satırı 'başarılı' yazılır ve ölçüm aracının plansız hata oranını şişirmez
+        // (pages.ts'teki page_screenshot expectFailure deseniyle aynı; artık her handle()'lı tool'da geçerli).
+        logStep('akış hatası ✕', `${runtimeErrors.length} adım hata ile bitti — platform HTTP 200 döndürdüğü için çağrı başarılı görünüyordu${expectFailure === true ? ' (expectFailure:true — kasıtlı negatif test)' : ''}`, runtimeErrors);
     }
     if (masked.length > 0) {
         logStep('maskeleme', `${masked.length} gizli alan yanıttan çıkarıldı — değer *** ile değiştirildi, yolu gatewayMasked'de`, masked);
@@ -144,6 +148,7 @@ export function toolResult(payload, config) {
     const enriched = {
         ...structured,
         ...(runtimeErrors.length > 0 ? { runtimeErrors } : {}),
+        ...(runtimeErrors.length > 0 && expectFailure === true ? { expectedFailure: true } : {}),
         ...(masked.length > 0 ? { gatewayMasked: masked } : {}),
         ...(Object.keys(tokenRefs).length > 0 ? { tokenRefs, tokenRefNote: "Maskelenen JWT'ler gateway içinde tutuldu; bu referansları page_screenshot / page_runtime_get 'asUser' alanına verebilirsiniz (15 dk geçerli). Jetonun kendisi yanıta ve günlüğe hiç girmez." } : {}),
         ...(truncated ? { truncated: true, truncationNote: 'Liste, yanıt boyutu sınırı nedeniyle kırpıldı; sayfalama ya da daha dar filtre kullanın.' } : {})
@@ -155,7 +160,8 @@ export function toolResult(payload, config) {
 }
 export function toolError(error) {
     logError(error);
-    const message = error instanceof PlatformApiError
+    // Politika durdurması bilinçli bir karardır, "beklenmeyen" değil (33/S-5).
+    const message = error instanceof PlatformApiError || error instanceof PolicyBlockError
         ? error.message
         : error instanceof Error
             ? `Beklenmeyen gateway hatası: ${error.message}`
@@ -168,7 +174,13 @@ export function toolError(error) {
 export function handle(config, run) {
     return async (args) => {
         try {
-            return toolResult(await run(args), config);
+            // Tool'un kendi input şeması `expectFailure: z.boolean().optional()` taşıyorsa (ör.
+            // microservice_execute, automation_preview) burada otomatik okunur ve toolResult'a geçirilir
+            // — kasıtlı negatif testler (yanlış parola, yetkisiz erişim, iş kuralı ihlali) ölçüm
+            // aracının plansız hata oranını şişirmez. Şemasında bu alan olmayan tool'larda args'ta
+            // anahtar hiç bulunmaz, davranış değişmez.
+            const expectFailure = args?.expectFailure === true;
+            return toolResult(await run(args), config, expectFailure);
         }
         catch (error) {
             return toolError(error);

package/dist/platform/screenshot.js

@@ -1,6 +1,13 @@
 import { PlatformApiError } from './errors.js';
 import { INTERNAL_ROLE_SEPARATOR, knownInternalRoles } from '../knowledge/componentCatalog.js';
 import { logStep } from '../observability/trace.js';
+/**
+ * Ziyaretçinin tema tercihinin yaşadığı localStorage anahtarı — `theme-toggle` bunu yazar,
+ * `Theme` okur ve projenin kendi modunun önüne geçirir
+ * (`zeyrek-frontend/packages/ng-apps-ui/src/shared/theme/stores.ts`). Anahtar uygulama başına
+ * DEĞİL tarayıcı başına tektir.
+ */
+const VIEWER_MODE_STORAGE_KEY = 'zeyrek-viewer-theme-mode';
 /**
  * G-24 — gateway sayfayı kurabiliyor, okuyabiliyor ve çizdirebiliyordu ama üzerinde OLAY
  * TETİKLEYEMİYORDU: "filtre değişince veri yenileniyor" iddiası yalnız şema okumasıyla
@@ -26,11 +33,54 @@ export function actionScript(action) {
       return { found: true, applied: true, requests: count };
     })()`;
     }
+    // G-09 — kanban kartı ve takvim etkinliği HTML5 DnD ile taşınır. Olaylar sentetik atılır ve
+    // TEK DataTransfer'i paylaşır; koordinat bırakma hedefinin merkezidir, çünkü takvimin saat
+    // kolonu bırakılan saati `clientY`'den hesaplar (slot hedefi o saatin ortasına düşer).
+    // Playwright `dragTo` gerçek fare sürer ama ScreenshotPage bu yeteneği taşımaz; betik yolu
+    // öteki eylemlerle aynı ölçüm döngüsünden (requests · flowRuns) geçer.
+    if (action.action === 'drag') {
+        const destination = JSON.stringify(`[data-element-id="${String(action.to ?? '')}"]`);
+        const destinationName = JSON.stringify(String(action.to ?? ''));
+        return `(function () {
+      var count = performance.getEntriesByType('resource').length;
+      var node = document.querySelector(${selector});
+      if (!node) return { found: false, applied: false, requests: count };
+      var drop = document.querySelector(${destination});
+      if (!drop) return { found: false, applied: false, note: "sürükleme kaynağı bulundu ama bırakma hedefi ('to') sayfada yok: " + ${destinationName} + " — kanban kolonu <elementId>__col-<value>, takvim günü <elementId>__day-<yyyy-MM-dd>, saat dilimi <elementId>__slot-<yyyy-MM-dd>T<HH>", requests: count };
+      if (node.getAttribute('draggable') !== 'true') return { found: true, applied: false, note: "kaynak sürüklenebilir değil (draggable != true) — kanban isDraggable ya da eventcalendar isEditable kapalı olabilir", requests: count };
+      var transfer = new DataTransfer();
+      var center = function (element) { var rect = element.getBoundingClientRect(); return { x: rect.left + rect.width / 2, y: rect.top + rect.height / 2 }; };
+      var fire = function (element, type, at) { element.dispatchEvent(new DragEvent(type, { bubbles: true, cancelable: true, composed: true, dataTransfer: transfer, clientX: at.x, clientY: at.y })); };
+      var from = center(node);
+      var to = center(drop);
+      fire(node, 'dragstart', from);
+      fire(drop, 'dragenter', to);
+      fire(drop, 'dragover', to);
+      fire(drop, 'drop', to);
+      fire(node, 'dragend', to);
+      return { found: true, applied: true, requests: count };
+    })()`;
+    }
+    const target = String(action.target ?? '');
+    const root = rootElementId(target);
+    // G-14 — `applied` yalnız "DOM'a yazıldı" demekti: tarih seçici olayı dinlemiyordu, kutu dolu
+    // görünüyor, prop boş kalıyordu. Kökün prop parmak izi eylemden ÖNCE alınır; runActions
+    // yerleşmeden sonra yeniden okuyup `propWritten`'ı çıkarır. Çok alanlı bileşenin kökünde tek
+    // değer yoktur — ilk kutuya yazmak yarım değeri "uygulandı" diye raporluyordu, kök reddedilir.
     return `(function () {
     var count = performance.getEntriesByType('resource').length;
     var node = document.querySelector(${selector});
     if (!node) return { found: false, applied: false, requests: count };
     var wanted = String(${value});
+    var propsBefore = ${runtimePropsScript(root)};
+    var finish = function (result) { if (propsBefore !== undefined) result.propsBefore = propsBefore; return result; };
+
+    if (${JSON.stringify(root === target)}) {
+      var parts = Array.prototype.slice.call(node.querySelectorAll(${JSON.stringify(`[data-element-id^="${root}${INTERNAL_ROLE_SEPARATOR}"]`)}))
+        .filter(function (part) { return part.querySelector('input, select, textarea'); })
+        .map(function (part) { return part.getAttribute('data-element-id'); });
+      if (parts.length > 1) return finish({ found: true, applied: false, note: "çok alanlı bileşen: kökte tek değer yok, değeri kutulardan birine yazın — " + parts.join(' · '), requests: count });
+    }
 
     // Açılır kutu (dropdown / multi-select) NATIVE alan değildir: değeri yazmak
     // hiçbir şey yapmaz, seçeneğe TIKLANMASI gerekir. Liste ancak kutu açıkken
@@ -48,29 +98,46 @@ export function actionScript(action) {
           var match = options.filter(function (option) { return option.getAttribute('data-value') === wanted; })[0]
             || options.filter(function (option) { return (option.textContent || '').trim() === wanted; })[0];
           if (!match) {
-            resolve({ found: true, applied: false, note: "açılır kutu açıldı ama bu değere karşılık gelen seçenek yok: " + wanted + " — options listesini page_runtime_get ile doğrulayın; seçenek sayısı: " + options.length, requests: count });
+            resolve(finish({ found: true, applied: false, note: "açılır kutu açıldı ama bu değere karşılık gelen seçenek yok: " + wanted + " — options listesini page_runtime_get ile doğrulayın; seçenek sayısı: " + options.length, requests: count }));
             return;
           }
           (match.querySelector('button') || match).click();
-          resolve({ found: true, applied: true, requests: count });
+          resolve(finish({ found: true, applied: true, requests: count }));
         }, 300);
       });
     }
 
     var field = node.matches('input, select, textarea') ? node : node.querySelector('input, select, textarea');
-    if (!field) return { found: true, applied: false, note: 'düğümde input/select/textarea yok — bu komponent native alan kullanmıyor olabilir, click ile deneyin', requests: count };
+    if (!field) return finish({ found: true, applied: false, note: 'düğümde input/select/textarea yok — bu komponent native alan kullanmıyor olabilir, click ile deneyin', requests: count });
     var proto = field instanceof HTMLSelectElement ? HTMLSelectElement.prototype
       : (field instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype);
     if (field instanceof HTMLInputElement && (field.type === 'checkbox' || field.type === 'radio')) {
       var shouldCheck = wanted === 'true' || wanted === '1' || wanted === 'on';
       if (field.checked !== shouldCheck) field.click();
-      return { found: true, applied: true, requests: count };
+      return finish({ found: true, applied: true, requests: count });
     }
     var setter = Object.getOwnPropertyDescriptor(proto, 'value').set;
     setter.call(field, ${value});
     field.dispatchEvent(new Event('input', { bubbles: true }));
     field.dispatchEvent(new Event('change', { bubbles: true }));
-    return { found: true, applied: true, requests: count };
+    return finish({ found: true, applied: true, requests: count });
+  })()`;
+}
+/** `rf_range__start` → `rf_range`: iç rol hedefinin prop'ları kök düğümde yaşar. */
+export function rootElementId(target) {
+    const separator = target.indexOf(INTERNAL_ROLE_SEPARATOR);
+    return separator > 0 ? target.slice(0, separator) : target;
+}
+/**
+ * Düğümün runtime prop'larının parmak izi (`@ng-apps/flow` → flow-runtime-props.ts,
+ * `window.__ngAppsReadProps`). `undefined` okuyucu yayınlanmıyor (eski runtime) ya da prop'lar
+ * serileşmiyor; `null` hiçbir makine düğümü tanımıyor; dize karşılaştırılabilir iz.
+ */
+export function runtimePropsScript(elementId) {
+    return `(function () { /* runtimePropsSnapshot */
+    var read = window.__ngAppsReadProps;
+    if (typeof read !== 'function') return undefined;
+    try { var props = read(${JSON.stringify(elementId)}); return props === null ? null : JSON.stringify(props); } catch (error) { return undefined; }
   })()`;
 }
 /**
@@ -421,19 +488,31 @@ export class StudioScreenshotter {
                 : navigated
                     ? activityAfter.completed
                     : activityBefore === null ? undefined : Math.max(activityAfter.completed - activityBefore.completed, 0);
+            // G-14 — DOM'a yazmak değerin prop'a ulaştığını kanıtlamaz. İz yalnız okuyucu yayınlanıyor ve
+            // makine düğümü tanıyorsa (dize) karşılaştırılır; aksi hâlde propWritten bilinmez kalır.
+            const propsAfter = typeof before.propsBefore === 'string' && before.applied === true && !navigated
+                ? await page.evaluate(runtimePropsScript(rootElementId(String(action.target ?? '')))).catch(() => undefined)
+                : undefined;
+            const propWritten = typeof propsAfter === 'string' ? propsAfter !== before.propsBefore : undefined;
+            const applied = before.applied === true && propWritten !== false;
+            const note = propWritten === false
+                ? `değer DOM'a yazıldı ama '${rootElementId(String(action.target ?? ''))}' düğümünün runtime prop'ları DEĞİŞMEDİ — bileşen olayı kendi change yoluna çevirmedi ya da değer zaten aynıydı. Çok alanlı bileşende <elementId>__<rol> kutusunu hedefleyin (component_get → internalRoles).`
+                : before.note;
             outcomes.push({
                 index,
                 action: String(action.action),
                 ...(action.target === undefined ? {} : { target: action.target }),
+                ...(action.to === undefined ? {} : { to: action.to }),
                 found: before.found === true,
-                applied: before.applied === true,
-                ...(before.note === undefined ? {} : { note: before.note }),
+                applied,
+                ...(propWritten === undefined ? {} : { propWritten }),
+                ...(note === undefined ? {} : { note }),
                 requests,
                 ...(flowRuns === undefined ? {} : { flowRuns }),
                 pageState: readiness.state
             });
         }
-        logStep('tarayıcı ⤵', `${outcomes.length} etkileşim adımı koştu`, outcomes.map(outcome => `${outcome.index}. ${outcome.action}${outcome.target ? ` '${outcome.target}'` : ''} → ${outcome.found ? (outcome.applied ? 'uygulandı' : 'bulundu ama uygulanamadı') : 'hedef BULUNAMADI'} · ${outcome.requests} ağ isteği`));
+        logStep('tarayıcı ⤵', `${outcomes.length} etkileşim adımı koştu`, outcomes.map(outcome => `${outcome.index}. ${outcome.action}${outcome.target ? ` '${outcome.target}'` : ''}${outcome.to ? ` ⇒ '${outcome.to}'` : ''} → ${outcome.found ? (outcome.applied ? 'uygulandı' : 'bulundu ama uygulanamadı') : 'hedef BULUNAMADI'} · ${outcome.requests} ağ isteği`));
         return outcomes;
     }
     /**
@@ -505,7 +584,7 @@ export class StudioScreenshotter {
             });
             context = await browser.newContext({ viewport: request.viewport, deviceScaleFactor: 1 });
         }
-        logStep('tarayıcı →', `GET ${request.url} · viewport ${request.viewport.width}x${request.viewport.height}${request.fullPage ? ' · fullPage' : ''}${request.token ? '' : ' · gateway jetonu YOK'}${(request.cookies ?? []).length > 0 ? ` · caller çerezleri: ${(request.cookies ?? []).map(cookie => cookie.name).join(', ')}` : ''}${request.token || (request.cookies ?? []).length > 0 ? '' : ' · ANONİM (çerez YOK)'}`);
+        logStep('tarayıcı →', `GET ${request.url} · viewport ${request.viewport.width}x${request.viewport.height}${request.fullPage ? ' · fullPage' : ''}${request.token ? '' : ' · gateway jetonu YOK'}${(request.cookies ?? []).length > 0 ? ` · caller çerezleri: ${(request.cookies ?? []).map(cookie => cookie.name).join(', ')}` : ''}${request.token || (request.cookies ?? []).length > 0 ? '' : ' · ANONİM (çerez YOK)'}${request.colorScheme ? ` · tema ${request.colorScheme}` : ''}`);
         try {
             const cookies = new Map();
             if (request.token)
@@ -515,6 +594,16 @@ export class StudioScreenshotter {
             if (cookies.size > 0) {
                 await context.addCookies([...cookies].map(([name, value]) => ({ name, value, url: request.cookieUrl, httpOnly: false })));
             }
+            // Tema tercihi çerezde değil localStorage'da yaşar ve tema store'u değerini modül İLK
+            // değerlendirildiğinde okur: sayfa açıldıktan sonra yazmak bir sonraki yüklemeye kadar
+            // etkisizdir. Bu yüzden tercih, sayfanın script'lerinden önce koşan bağlam script'iyle
+            // ekilir. Yeteneği olmayan bağlamda çağrı SESSİZCE açık temada kare almaz, hata verir.
+            if (request.colorScheme) {
+                if (!context.addInitScript) {
+                    throw new PlatformApiError(`colorScheme='${request.colorScheme}' uygulanamadı: tarayıcı bağlamı addInitScript desteklemiyor. Tema tercihi sayfa açılmadan ekilmek zorunda; desteksiz bağlamda kare projenin varsayılan modunda çıkardı ve bu sessizce yanlış olurdu.`);
+                }
+                await context.addInitScript(`try { localStorage.setItem(${JSON.stringify(VIEWER_MODE_STORAGE_KEY)}, ${JSON.stringify(request.colorScheme)}) } catch (error) { /* localStorage kapalıysa proje varsayılanı çizilir */ }`);
+            }
             const page = await context.newPage();
             // Soğuk Vite derlemesinde sayfanın kendi veri isteği 15 sn'yi aşabiliyor; delayMs bu
             // bütçeyi de uzatır (09-02 E-2). Yanıt hazırlık döngüsünü BLOKLAMAZ: runtime dışına

package/dist/platform/strictArguments.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+function isRawShape(value) {
+    if (!value || typeof value !== 'object' || '_def' in value)
+        return false;
+    return Object.values(value).every(entry => entry instanceof z.ZodType);
+}
+/**
+ * GW-005 — tanınmayan üst düzey argüman REDDEDİLİR.
+ *
+ * SDK ham şekli `z.object(shape)` ile sarar ve zod'un varsayılanı bilinmeyen anahtarı hata vermeden
+ * ATMAKTIR: şemada olmayan bir alan doğrulamadan geçer, handler'a hiç ulaşmaz ve çağrı başarıyla
+ * biter. 2026-09-15 G-13'te `microservice_execute`/`microservice_debug`/`query_preview`'a verilen
+ * `parameters` böyle kayboldu — dört farklı filtre aynı gövdeyi döndü ve ölçüm aracı çağıranı
+ * olmayan bir sorgu kusuruna yönlendirdi. Tek tek tool'lara alan eklemek sınıfı kapatmaz; sessizlik
+ * burada, SDK'ya şema verilmeden önce kaldırılır.
+ */
+export function rejectUnknownArguments(server) {
+    const registerTool = server.registerTool.bind(server);
+    server.registerTool = ((name, config, callback) => {
+        if (!isRawShape(config.inputSchema))
+            return registerTool(name, config, callback);
+        const shape = config.inputSchema;
+        const accepted = Object.keys(shape).join(', ');
+        const inputSchema = z.object(shape, {
+            errorMap: (issue, context) => issue.code === 'unrecognized_keys'
+                ? { message: `${name} şu üst düzey argümanları tanımıyor: ${issue.keys.map(key => `'${key}'`).join(', ')}. Tanınmayan alan sessizce yok sayılmaz — çağrı hiç gönderilmedi. Bu tool'un okuduğu alanlar: ${accepted}.` }
+                : { message: context.defaultError }
+        }).strict();
+        return registerTool(name, { ...config, inputSchema }, callback);
+    });
+    return server;
+}

package/dist/platform/writeDiff.js

@@ -1,3 +1,4 @@
+import { PROP_VALUE_TYPES } from '../knowledge/normalize.js';
 import { logStep } from '../observability/trace.js';
 const maxDrops = 20;
 const maxDepth = 12;
@@ -214,9 +215,11 @@ export function unwrapProps(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'
+        // Platform `static` dışındaki her tipte değeri `ref`'e yazar (Prop ctor'u,
+        // DesignComponentManagementSchema.cs:666); `data` ya boştur ya türetilmiştir (file URL'i, page
+        // slug'ı, translation tasarım yedeği). `data`'yı taşıyıcı saymak bağlı akışı her yazmada
+        // "kaydedilen null" gösteriyordu (S-7).
+        const carrier = record.type !== 'static' && PROP_VALUE_TYPES.has(record.type)
             ? (Object.hasOwn(record, 'ref') ? record.ref : record.data)
             : (Object.hasOwn(record, 'data') ? record.data : record.ref);
         return unwrapProps(carrier);

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>" }
+}