@appaflytech/zeyrek-ai-mcp 0.0.21 → 0.0.23

package/dist/platform/capture/actions.js

@@ -0,0 +1,333 @@
+import { INTERNAL_ROLE_SEPARATOR } from '../../knowledge/componentCatalog.js';
+import { studioWebTarget } from './targets/studio-web.js';
+/**
+ * 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
+ * kanıtlanabiliyordu. 09-05 koşusunda üç olay bağının ikisi şemada "bağlı" görünüp gerçekte
+ * çalışmıyordu (form submit hiç doğmuyordu, `code` adımının gövdesi kaydedilmemişti) ve ikisi de
+ * yalnız gerçek tıklamayla görüldü.
+ *
+ * Değer yazarken NATIVE setter kullanılır ve `input`+`change` olayları bubbles ile atılır: DOM
+ * value'sunu düz atamak framework'ün duyduğu olayı üretmez, alan dolu görünür ama akış çalışmaz.
+ * `resource` sayacı "istek gerçekten gitti mi" sorusunu cevaplar — koşuda kusuru kesinleştiren
+ * gözlem tam olarak buydu (ağ kaydında hiç istek yoktu).
+ */
+export function actionScript(action, captureTarget = studioWebTarget) {
+    const selector = JSON.stringify(`[data-element-id="${String(action.target ?? '')}"]`);
+    const value = JSON.stringify(action.value ?? '');
+    // Tek tırnakla gömülür: seçiciler sabittir ve çift tırnak taşır; web betiğinin metni değişmesin.
+    const optionSelector = `'${captureTarget.optionSelector}'`;
+    // Seçeneklerin arandığı kök: web'de kutunun kabı (`scope`), mobilde belge (liste `Modal` katmanında).
+    const optionRoot = captureTarget.optionsOutsideNode ? 'document' : 'scope';
+    if (action.action === 'click') {
+        return `(function () {
+      var count = performance.getEntriesByType('resource').length;
+      var node = document.querySelector(${selector});
+      if (!node) return { found: false, applied: false, requests: count };
+      var target = node.matches('button, a, [role="button"]') ? node : (node.querySelector('button, a, [role="button"]') || node);
+      // S-2: sekme grubunun KÖKÜNE click, DOM sırasındaki ilk sekmeye gider ve "uygulandı" der —
+      // ajan ikinci sekmeyi hiç seçemiyordu (2026-09-16 raporu madde 6). Sekme seçmek 'tab'in işi.
+      if (target.closest && target.closest('[role="tablist"]') && !node.matches('[role="tab"]')) {
+        return { found: true, applied: false, note: "hedef bir sekme grubu: click İLK sekmeye giderdi — sekme seçmek için { action: 'tab', target: '" + ${JSON.stringify(String(action.target ?? ''))} + "', value: '<sekme anahtarı ya da metni>' } kullanın", requests: count };
+      }
+      target.click();
+      return { found: true, applied: true, requests: count };
+    })()`;
+    }
+    // S-2 — sekme SEÇİLEMİYORDU: kimlik `<elementId>__tab-<key>` (frontend f-02) önce denenir,
+    // runtime onu basmıyorsa görünen metinle eşlenir ve rapor hangisiyle eşlediğini söyler —
+    // metin çeviriye bağlıdır, dil değişince kırılır.
+    if (action.action === 'tab') {
+        const roleSelector = JSON.stringify(`[data-element-id="${String(action.target ?? '')}__tab-${String(action.value ?? '')}"]`);
+        return `(function () {
+      var count = performance.getEntriesByType('resource').length;
+      var root = document.querySelector(${selector});
+      if (!root) return { found: false, applied: false, requests: count };
+      var wanted = String(${value});
+      var byRole = document.querySelector(${roleSelector});
+      var buttons = Array.prototype.slice.call(root.querySelectorAll('[role="tab"]'));
+      var byText = buttons.filter(function (button) { return (button.textContent || '').trim() === wanted; })[0]
+        || buttons.filter(function (button) { return (button.textContent || '').trim().toLowerCase() === wanted.toLowerCase(); })[0];
+      var target = byRole || byText;
+
+      if (!target) {
+        var names = buttons.map(function (button) { return (button.textContent || '').trim(); }).join(' · ');
+        return { found: true, applied: false, optionsSeen: buttons.length, requests: count, note: buttons.length === 0
+          ? "bu düğümde sekme yok (role=tab) — hedef gerçekten bir sekme grubu mu? page_schema_get ile tipe bakın"
+          : "sekme bulunamadı: " + wanted + " — sekme ANAHTARINI ya da görünen metnini verin; görülenler: " + names };
+      }
+
+      if (target.disabled === true || target.getAttribute('aria-disabled') === 'true') {
+        return { found: true, applied: false, note: "sekme devre dışı (disabled): " + wanted, requests: count };
+      }
+
+      target.click();
+      return { found: true, applied: true, matchedBy: byRole ? 'role' : 'text', requests: count };
+    })()`;
+    }
+    // S-3 — açılır kutuda seçim. 'set' ile aynı gövde; buradaki fark yalnız prop izi tutulmamasıdır
+    // (seçim kutunun kendi değerini yazar, DOM'a elle yazılan bir değer yoktur).
+    if (action.action === 'select') {
+        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 finish = function (result) { return result; };
+
+    var combobox = node.querySelector('[role="combobox"], .ng-select__value-container, .ng-multiselect__value-container');
+    if (combobox) {
+      // Liste BU kutunun kabının içindedir. Sorgular belge kapsamlı kaldığında açık duran başka
+      // bir kutunun (multiselect seçimden sonra kapanmıyor) seçeneğine tıklanabiliyordu ve adım
+      // "uygulandı" diyordu; komşunun yükleme göstergesi de bu kutunun kararını blokluyordu (B-5).
+      var scope = combobox.closest('.ng-select, .ng-multiselect') || node;
+
+      combobox.click();
+
+      return new Promise(function (resolve) {
+        var waited = 0;
+        var step = 100;
+        var limit = 3000;
+
+        var attempt = function () {
+          var loading = scope.querySelector('.ng-select__loading, .ng-multiselect__loading');
+          var options = Array.prototype.slice.call(${optionRoot}.querySelectorAll(${optionSelector}));
+          var byValue = options.filter(function (option) { return option.getAttribute('data-value') === wanted; })[0];
+          var byText = options.filter(function (option) { return (option.textContent || '').trim() === wanted; })[0];
+          var match = byValue || byText;
+
+          if (match) {
+            var button = match.querySelector('button');
+            // Seçilemeyen seçeneğe tıklamak hiçbir şey yapmaz; "uygulandı" demek yanlış olurdu (B-6).
+            if (match.getAttribute('aria-disabled') === 'true' || (button && button.disabled)) {
+              resolve(finish({ found: true, applied: false, optionsSeen: options.length, waitedMs: waited, requests: count, note: "seçenek devre dışı (aria-disabled): " + wanted }));
+              return;
+            }
+
+            (button || match).click();
+            resolve(finish({ found: true, applied: true, matchedBy: byValue ? 'value' : 'text', optionsSeen: options.length, waitedMs: waited, requests: count }));
+            return;
+          }
+
+          var settled = !loading && (options.length > 0 || !!scope.querySelector('.ng-select__empty, .ng-multiselect__empty'));
+
+          if (settled || waited >= limit) {
+            var seen = options.slice(0, 10).map(function (option) { return (option.textContent || '').trim(); }).join(' · ');
+            // Liste HİÇ açılmadıysa kusur sorguda değil kutunun kendisinde olabilir:
+            // handleContainerClick kilitli/salt-okunur/yükleniyor kutuda erken döner.
+            var locked = !scope.querySelector('.ng-select__list, .ng-multiselect__list');
+            var note = options.length > 0
+              ? "açılır kutuda bu değere karşılık gelen seçenek yok: " + wanted + " — görülen " + options.length + " seçenek: " + seen
+              : locked
+                ? "açılır kutu AÇILMADI (" + waited + " ms): kutu devre dışı, salt okunur ya da hâlâ yükleniyor olabilir — page_runtime_get ile isDisabled/isReadonly/isLoading prop'larına bakın"
+                : "açılır kutu açıldı ama " + waited + " ms içinde hiç seçenek basılmadı — seçenekler bir sorgudan geliyorsa query_preview ile doğrulayın, yavaşsa önce bir wait adımı ekleyin";
+            resolve(finish({ found: true, applied: false, optionsSeen: options.length, waitedMs: waited, requests: count, note: note }));
+            return;
+          }
+
+          waited += step;
+          setTimeout(attempt, step);
+        };
+
+        attempt();
+      });
+    }
+      return { found: true, applied: false, note: "bu düğümde açılır kutu yok (role=combobox / .ng-select__value-container) — native alan için 'set', butona basmak için 'click' kullanın", requests: count };
+    })()`;
+    }
+    // S-4 — form gönderme. Gönder butonu olmayan ya da Enter ile gönderilen form başsız
+    // doğrulanamıyordu; `requestSubmit` formun kendi submit olayını doğduğu gibi doğurur.
+    if (action.action === 'submit') {
+        // Mobil hedefte ağaçta `<form>` yoktur: runtime köprüsü form düğümünün `submit` olayını
+        // makineye iletir. Köprü düğümü tanımıyorsa (eski runtime, yanlış hedef) DOM yoluna düşülür.
+        const bridge = captureTarget.submitBridge === undefined
+            ? ''
+            : `var bridge = window[${JSON.stringify(captureTarget.submitBridge)}];
+      if (typeof bridge === 'function') {
+        var bridged = bridge(${JSON.stringify(String(action.target ?? ''))});
+        if (bridged && bridged.found) return { found: true, applied: bridged.applied === true, submitVia: 'bridge', requests: count, note: bridged.note };
+      }
+      `;
+        return `(function () {
+      var count = performance.getEntriesByType('resource').length;
+      var node = document.querySelector(${selector});
+      if (!node) return { found: false, applied: false, requests: count };
+      ${bridge}var form = node.matches('form') ? node : (node.querySelector('form') || node.closest('form'));
+
+      if (form) {
+        if (typeof form.requestSubmit === 'function') {
+          form.requestSubmit();
+          return { found: true, applied: true, submitVia: 'requestSubmit', requests: count };
+        }
+
+        form.dispatchEvent(new Event('submit', { bubbles: true, cancelable: true }));
+        return { found: true, applied: true, submitVia: 'dispatch', requests: count };
+      }
+
+      var button = node.querySelector('button[type="submit"]');
+
+      if (button) {
+        button.click();
+        return { found: true, applied: true, submitVia: 'button', requests: count };
+      }
+
+      return { found: true, applied: false, note: "bu düğüm bir form değil ve içinde submit butonu da yok — form komponentinin elementId'sini hedefleyin", 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. 'set' bu noktada 'select' fiiliyle AYNI yola girer —
+    // iki kopya seçim mantığı tutulmaz.
+
+    var combobox = node.querySelector('[role="combobox"], .ng-select__value-container, .ng-multiselect__value-container');
+    if (combobox) {
+      // Liste BU kutunun kabının içindedir. Sorgular belge kapsamlı kaldığında açık duran başka
+      // bir kutunun (multiselect seçimden sonra kapanmıyor) seçeneğine tıklanabiliyordu ve adım
+      // "uygulandı" diyordu; komşunun yükleme göstergesi de bu kutunun kararını blokluyordu (B-5).
+      var scope = combobox.closest('.ng-select, .ng-multiselect') || node;
+
+      combobox.click();
+
+      return new Promise(function (resolve) {
+        var waited = 0;
+        var step = 100;
+        var limit = 3000;
+
+        var attempt = function () {
+          var loading = scope.querySelector('.ng-select__loading, .ng-multiselect__loading');
+          var options = Array.prototype.slice.call(${optionRoot}.querySelectorAll(${optionSelector}));
+          var byValue = options.filter(function (option) { return option.getAttribute('data-value') === wanted; })[0];
+          var byText = options.filter(function (option) { return (option.textContent || '').trim() === wanted; })[0];
+          var match = byValue || byText;
+
+          if (match) {
+            var button = match.querySelector('button');
+            // Seçilemeyen seçeneğe tıklamak hiçbir şey yapmaz; "uygulandı" demek yanlış olurdu (B-6).
+            if (match.getAttribute('aria-disabled') === 'true' || (button && button.disabled)) {
+              resolve(finish({ found: true, applied: false, optionsSeen: options.length, waitedMs: waited, requests: count, note: "seçenek devre dışı (aria-disabled): " + wanted }));
+              return;
+            }
+
+            (button || match).click();
+            resolve(finish({ found: true, applied: true, matchedBy: byValue ? 'value' : 'text', optionsSeen: options.length, waitedMs: waited, requests: count }));
+            return;
+          }
+
+          var settled = !loading && (options.length > 0 || !!scope.querySelector('.ng-select__empty, .ng-multiselect__empty'));
+
+          if (settled || waited >= limit) {
+            var seen = options.slice(0, 10).map(function (option) { return (option.textContent || '').trim(); }).join(' · ');
+            // Liste HİÇ açılmadıysa kusur sorguda değil kutunun kendisinde olabilir:
+            // handleContainerClick kilitli/salt-okunur/yükleniyor kutuda erken döner.
+            var locked = !scope.querySelector('.ng-select__list, .ng-multiselect__list');
+            var note = options.length > 0
+              ? "açılır kutuda bu değere karşılık gelen seçenek yok: " + wanted + " — görülen " + options.length + " seçenek: " + seen
+              : locked
+                ? "açılır kutu AÇILMADI (" + waited + " ms): kutu devre dışı, salt okunur ya da hâlâ yükleniyor olabilir — page_runtime_get ile isDisabled/isReadonly/isLoading prop'larına bakın"
+                : "açılır kutu açıldı ama " + waited + " ms içinde hiç seçenek basılmadı — seçenekler bir sorgudan geliyorsa query_preview ile doğrulayın, yavaşsa önce bir wait adımı ekleyin";
+            resolve(finish({ found: true, applied: false, optionsSeen: options.length, waitedMs: waited, requests: count, note: note }));
+            return;
+          }
+
+          waited += step;
+          setTimeout(attempt, step);
+        };
+
+        attempt();
+      });
+    }
+
+    var field = node.matches('input, select, textarea') ? node : node.querySelector('input, select, textarea');
+    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 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 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; }
+  })()`;
+}
+/**
+ * Hangi sekme AÇIK? `tab` adımı tıklamanın işe yarayıp yaramadığını ancak bununla kanıtlar:
+ * tıklama "uygulandı" dese de bileşen seçimi kendi `selected` prop'una yazmamış olabilir.
+ * `undefined` düğüm yok, `null` sekme grubu var ama hiçbiri seçili değil.
+ */
+export function activeTabScript(elementId) {
+    return `(function () { /* activeTabSnapshot */
+    var root = document.querySelector(${JSON.stringify(`[data-element-id="${elementId}"]`)});
+    if (!root) return undefined;
+    var active = root.querySelector('[role="tab"][aria-selected="true"]');
+    return active ? String(active.textContent || '').replace(/\\s+/g, ' ').trim() : null;
+  })()`;
+}

package/dist/platform/capture/browser.js

@@ -0,0 +1 @@
+export {};