@appaflytech/zeyrek-ai-mcp 0.0.20 → 0.0.21

package/dist/knowledge/normalize.js

@@ -2,7 +2,6 @@ import { logStep } from '../observability/trace.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { ensureWorkflowErrorPath } from './errorPath.js';
 import { TYPED_STYLE_COMPONENTS } from './styleResolve.js';
-import { STEP_ALIASES } from './platform/profile.js';
 const SORT_DEFAULT = { name: 'sortField', type: 'sortType', source: 'query-string' };
 const LIMIT_DEFAULT = { name: 'limit', offset: 'offset', source: 'query-string' };
 function asArray(value) {
@@ -270,11 +269,12 @@ export function normalizeWorkflowDefinition(definition) {
  */
 /**
  * Adım tipi sözlüğü backend'in, KOŞAN tipler barındırıcının: motor yedi tip register eder, web
- * `Runtime.svelte` altı, mobil `runtime-tasks.ts` yedi tip ekler ve aynı sayfa kaydı ikisinde de
+ * `Runtime.svelte` altı, mobil `ScreenRuntime.tsx` beş tip ekler ve aynı sayfa kaydı ikisinde de
  * koşar. Register edilmemiş bir tipe gelen akış sessizce ölür (`flow-engine.ts` `process()`
  * callback bulamazsa next/completed/stopped hiç çağrılmaz), üstelik `run()` promise'i
  * çözülmediği için `__ngAppsFlowActivity.running` sıfıra inmez. İki hâl tamamen türetilebilir
- * olduğu için lint değil NORMALİZASYON; `FLOW-023` kalan hâlleri uyarır.
+ * olduğu için lint değil NORMALİZASYON — kalanı (`confirm`/`download` mobilde yok) yalnız
+ * uygulama tarafında kapanabilir, `FLOW-023` onları uyarır.
  */
 function normalizeFlowHostGaps(steps, list) {
     const fixes = [];
@@ -288,15 +288,12 @@ function normalizeFlowHostGaps(steps, list) {
         .map(step => String(step.stepId ?? ''))
         .filter(id => id.length > 0));
     for (const step of list) {
-        // navigate ile redirect'in argümanı AYNI ({ path, pageId, query, targetBlank, presentation })
-        // ama navigate'i yalnız mobil register eder; redirect ise iki barındırıcıda da koşar (mobilde
-        // aynı navigate uygulamasına eşlenir), yani redirect kesin üstün. `presentation`
-        // (push | modal | replace) yalnız mobil barındırıcıda okunur; web yok sayar.
-        const alias = STEP_ALIASES[String(step.type ?? '')];
-        if (alias) {
-            const original = String(step.type);
-            step.type = alias;
-            fixes.push(`'${label(step)}': type ${original} → ${alias} yazıldı — argüman şekli aynı ({ path, pageId, query, targetBlank, presentation }) ama ${original}'i web barındırıcısı register etmez, ${alias} ikisinde de koşar`);
+        // navigate ile redirect'in argümanı AYNI ({ path, pageId, query, targetBlank }) ama navigate'i
+        // yalnız mobil register eder; redirect ise iki barındırıcıda da koşar (mobilde aynı navigate
+        // uygulamasına eşlenir), yani redirect kesin üstün.
+        if (step.type === 'navigate') {
+            step.type = 'redirect';
+            fixes.push(`'${label(step)}': type navigate → redirect yazıldı — argüman şekli aynı ({ path, pageId, query, targetBlank }) ama navigate'i web barındırıcısı register etmez, redirect ikisinde de koşar`);
         }
         if (endStepIds.size === 0)
             continue;
@@ -653,44 +650,6 @@ export function styleKeyNote(fixed) {
             + 'değer kaydedilir ama hiç uygulanmaz ve tek işareti tarayıcı konsoludur (F-06). '
             + "Seçici anahtarlara ('&__body', ':hover', '--token') dokunulmadı."];
 }
-/**
- * Kabın `states.isDroppable`ı KATALOĞUN kararıdır. Gateway düğümü kurarken bu alanı
- * yazmıyordu (`DEFAULT_STATES` hepsini `false` bırakır) ve Studio kanvası düğümü kap saymıyordu:
- * imleç `scroll-view`un İÇİNDEYKEN bırakma planı sayfa kabına düşüyor, çizgi kabın üst kenarına
- * çiziliyordu (ölçüldü 2026-09-21, `test/mobile app` › `Satislar`). Aynı tipi paletten ekleyen
- * Studio katalog değerini yazdığı için tek şemada iki türlü davranan kap oluyordu.
- *
- * Değer uygulamanın KENDİ sözlüğünden gelir (`listComponents`; mobil uygulamada `type=mobile`
- * satırları), yani kural platformdan bağımsızdır ve kuruluşun kendi komponentlerini de kapsar.
- * Yalnız `true` yazılır: katalog bir tipi kap saymıyorsa düğüme dokunulmaz.
- */
-export function normalizeDroppableStates(nodes, droppable) {
-    const fixed = [];
-    if (droppable.size === 0)
-        return fixed;
-    for (const node of asObjects(nodes)) {
-        const type = typeof node.type === 'string' ? node.type : '';
-        if (droppable.get(type) === true) {
-            // `states` normalde `normalizeComponentDefaults`tan geçmiş olur; gelmediyse burada da
-            // eksiksiz kurulur — yarım `states` platformda NullReference üretir.
-            if (!node.states || typeof node.states !== 'object' || Array.isArray(node.states)) {
-                node.states = { ...DEFAULT_STATES };
-            }
-            const states = node.states;
-            if (states.isDroppable !== true) {
-                states.isDroppable = true;
-                fixed.push(`'${String(node.elementId ?? node.name ?? type)}' (${type})`);
-            }
-        }
-        fixed.push(...normalizeDroppableStates(node.children, droppable));
-    }
-    return fixed;
-}
-export function droppableStatesNote(fixed) {
-    return fixed.length === 0
-        ? []
-        : [`states.isDroppable katalogdan yazıldı (${fixed.join(' · ')}) — kataloğun kap saydığı düğüm Studio kanvasında da kap olmalı; alanı bilerek kapatmak için resize_component/set_states kullanın`];
-}
 export function normalizeComponentDefaults(nodes) {
     const fixed = [];
     for (const node of asObjects(nodes)) {
@@ -925,11 +884,11 @@ export function pageContainerNode() {
  * çekilirlerse sayfa içeriğinin akışına girer ve katman olarak açılmazlar.
  */
 const ROOT_LAYER_TYPES = new Set(['modal', 'drawer']);
-export function ensurePageContainer(schema, rootContainer = pageContainerNode) {
+export function ensurePageContainer(schema) {
     const nodes = asObjects(schema);
     if (nodes.some(node => node.elementId === PAGE_CONTAINER_ELEMENT_ID))
         return { schema: nodes, fixes: [] };
-    const container = rootContainer();
+    const container = pageContainerNode();
     const layers = nodes.filter(node => ROOT_LAYER_TYPES.has(String(node.type ?? '')));
     container.children = nodes.filter(node => !ROOT_LAYER_TYPES.has(String(node.type ?? '')));
     const moved = container.children.length;
@@ -2082,32 +2041,76 @@ export function orphanedFlowPlan(schema, pageEvents, ops) {
         if (op.op !== 'set_event' && op.op !== 'remove_event')
             continue;
         const eventName = String(op.event ?? '');
+        const eventValue = typeof op.eventValue === 'string' ? op.eventValue : undefined;
+        const boundTo = (events) => asObjects(events)
+            .filter(event => String(event.name ?? '') === eventName && typeof event.value === 'string' && event.value !== '');
+        // Bir olaya birden fazla akış bağlı olabilir. Değersiz `remove_event` o durumda platformda
+        // `ambiguous-event` ile düşer ve hiçbir bağ kalkmaz; değerli olan yalnız o akışı çözer.
+        const removedBy = (named) => eventValue === undefined
+            ? (named.length === 1 ? named : [])
+            : named.filter(event => event.value === eventValue);
         // `remove_event target:'page'` düğümü değil barındırıcının düzey olaylarını hedefler
         // (`PageSchemaMicroOpApplier.PageTarget`); düğüm aramasına düşseydi plan boş kalır ve yalnız
         // oraya bağlı akış kapıdan geçip kalıcı silinirdi. Düzey olayı olmayan widget'ta applier da
         // düğüm aramasına düşer.
         if (op.op === 'remove_event' && target === 'page' && Array.isArray(pageEvents)) {
             const hostEvents = asObjects(pageEvents);
-            const removed = hostEvents.find(event => String(event.name ?? '') === eventName);
-            if (typeof removed?.value !== 'string' || removed.value === '')
-                continue;
-            const surviving = new Set(hostEvents.filter(event => event !== removed && typeof event.value === 'string').map(event => String(event.value)));
+            const removed = removedBy(boundTo(hostEvents));
+            const surviving = new Set(hostEvents.filter(event => !removed.includes(event) && typeof event.value === 'string').map(event => String(event.value)));
             collectFlowRefsExcept(nodes, '', surviving);
-            if (!surviving.has(removed.value))
-                plan.push({ target, op: 'remove_event', flowIds: [removed.value] });
+            const flowIds = [...new Set(removed.map(event => String(event.value)))].filter(flowId => !surviving.has(flowId));
+            if (flowIds.length > 0)
+                plan.push({ target, op: 'remove_event', flowIds });
             continue;
         }
         const node = findNodeByElementId(nodes, target);
-        const current = asObjects(node?.events).find(event => String(event.name ?? '') === eventName);
-        const currentValue = typeof current?.value === 'string' ? current.value : '';
-        if (currentValue === '' || currentValue === String(op.eventValue ?? ''))
+        const named = boundTo(node?.events);
+        // `set_event` adın BÜTÜN bağlarını tek kayda indirir; yeni değerden farklı her akış bağını kaybeder.
+        const losing = op.op === 'set_event' ? named.filter(event => event.value !== eventValue) : removedBy(named);
+        if (losing.length === 0)
             continue;
         const surviving = survivingRefs(target, eventName);
-        if (!surviving.has(currentValue))
-            plan.push({ target, op: String(op.op), flowIds: [currentValue] });
+        for (const event of named) {
+            if (!losing.includes(event))
+                surviving.add(String(event.value));
+        }
+        const flowIds = [...new Set(losing.map(event => String(event.value)))].filter(flowId => !surviving.has(flowId));
+        if (flowIds.length > 0)
+            plan.push({ target, op: String(op.op), flowIds });
     }
     return plan;
 }
+/**
+ * PAGE-034 — dolu bir olaya farklı akışla `set_event` gelmesi. `set_event` adın bütün bağlarını
+ * TEK kayda indirir, yani önceki akış bağını sessizce kaybeder; akış başka yerden de
+ * referanslıysa `orphanedFlowPlan` da susar ve kayıp hiç görünmez (maddelerim 4: makale önerisi
+ * akışı, akıllı öneri bağlanınca çalışmaz oldu). Olaya ikinci akış eklemek `add_event`'tir; bilerek
+ * değiştirmek için op'a `replaceBoundFlows: true` verilir. Okunan ağaçta olmayan hedef denetlenmez.
+ */
+export function boundEventOps(schema, ops) {
+    const nodes = asObjects(schema);
+    return asObjects(ops)
+        .filter(op => op.op === 'set_event' && op.replaceBoundFlows !== true)
+        .flatMap(op => {
+        const target = String(op.target ?? '');
+        const event = String(op.event ?? '');
+        const eventValue = typeof op.eventValue === 'string' ? op.eventValue : '';
+        const bound = asObjects(findNodeByElementId(nodes, target)?.events)
+            .filter(entry => String(entry.name ?? '') === event && typeof entry.value === 'string' && entry.value !== '')
+            .map(entry => String(entry.value));
+        const replaced = [...new Set(bound)].filter(flowId => flowId !== eventValue);
+        if (replaced.length === 0)
+            return [];
+        return [`PAGE-034: '${target}' komponentinin '${event}' olayına zaten bağlı akış var (${replaced.join(', ')}). set_event olayın BÜTÜN bağlarını tek akışa indirir ve bu akışlar olay tetiklenince artık çalışmaz. `
+                + `Olaya bir akış daha eklemek için { op: 'add_event', target: '${target}', event: '${event}', eventValue: '${eventValue}' } kullanın — bağlı akışların hepsi paralel koşar. `
+                + `Mevcut bağı bilerek değiştirmek istiyorsanız aynı op'a replaceBoundFlows: true ekleyin.`];
+    });
+}
+/** Gateway'e ait op alanları platforma gitmez. */
+export function stripGatewayEventFields(ops) {
+    for (const op of ops)
+        delete op.replaceBoundFlows;
+}
 export function orphanedFlowMessage(plan) {
     const lines = plan.map(entry => `'${entry.target}' (${entry.op}) → ${entry.flowIds.join(', ')}`);
     return `İstek gönderilmedi: bu yama ${plan.reduce((total, entry) => total + entry.flowIds.length, 0)} akışı sayfada referanssız bırakıyor ve platform referanssız akışı KALICI siler — ${lines.join(' · ')}. `

package/dist/knowledge/rules.js

@@ -170,11 +170,13 @@ const flowLiteralTextFields = new Map([
     ['confirm', ['message', 'title', 'confirmText', 'cancelText']]
 ]);
 const flowExpressionLooking = /\$\{|\b(?:Steps|Page|Row|Widget|LocalStorage|state|self|item|event|error|cookie)\s*(?:\?\.|\.|\[)/;
-// Barındırıcıya özel tipler BURADA kural üretmez. `navigate`i gateway normalizasyonu zaten
-// `redirect`e çeviriyor (normalize.ts `normalizeFlowHostGaps`) — `redirect` iki barındırıcıda da
-// koşar, yani vaka uyarılmaz, ORTADAN KALKAR. Gateway uygulamanın tipini platform profilinden bilir
-// ve barındırıcı sözlüğü `platform/*.ts`'tedir (`profile.steps`); mobil farkları orada `MOB-005`
-// olarak konuşulur (`platform/lint.ts`). Yeni mobil runtime `confirm`/`download`'ı kaydeder.
+// Barındırıcıya özel tipler (`navigate` web'de, `confirm`/`download` mobilde register edilmez)
+// BURADA kural üretmez. `navigate`i gateway normalizasyonu zaten `redirect`e çeviriyor
+// (normalize.ts `normalizeFlowHostGaps`) — `redirect` iki barındırıcıda da koşar, yani vaka
+// uyarılmaz, ORTADAN KALKAR. Geriye kalan `confirm`/`download` tek başına kusur değildir: sayfa
+// tek bir uygulamaya aittir (`Page.ApplicationId`), uygulamanın tipi web ya da mobile'dır
+// (`ApplicationType.cs`) ve gateway hangisi olduğunu bilmez. Mobil ayağı uygulama tarafında
+// kapanır (`ScreenRuntime.tsx`), lint'te değil.
 const flowUnregisteredStepTypes = new Set(['end', 'query']);
 const flowSetterIterateeTypes = new Set(['change', 'fill']);
 function flowStepList(value) {
@@ -420,6 +422,8 @@ export function rawQueryParameterNames(rawQuery) {
 }
 const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 const functionsGuide = 'ngapps://guides/functions';
+/** FN-006: bu kadar dolu satırdan uzun gövde yorumsuz kalmaz; tek satırlık `return` yorum istemez. */
+const FUNCTION_COMMENT_MIN_LINES = 5;
 export const policyRules = [
     {
         id: 'MS-001',
@@ -2030,6 +2034,25 @@ export const policyRules = [
             return [];
         }
     },
+    {
+        id: 'FN-006',
+        module: 'function',
+        appliesTo: ['create', 'update'],
+        sourceRef: "Kullanıcı isteği 2026-09-18: ajan fonksiyon yazarken gövdeye ne yaptığını söyleyen yorum koyar; Studio editörü yorumu yeşil italik çizer. Gövde kendi satırına sarılır (function-source.ts, GlobalFunction.cs AppendLine), '//' kapanış parantezini yutmaz",
+        check: definition => {
+            const name = String(definition.name ?? '?');
+            const body = typeof definition.body === 'string' ? definition.body : '';
+            const lineCount = body.split('\n').filter(line => line.trim() !== '').length;
+            if (lineCount < FUNCTION_COMMENT_MIN_LINES || /(^|\s)\/\/|\/\*/m.test(body))
+                return [];
+            return [{
+                    ruleId: 'FN-006',
+                    severity: 'warn',
+                    message: `'${name}' gövdesi ${lineCount} satır ama hiç yorum yok. Başa ne yaptığını, parametreleri ve dönüşü söyleyen kısa bir '//' yorumu, açık olmayan adımların üstüne de birer satır yorum ekleyin; kodu tekrar eden yorum yazmayın.`,
+                    guide: functionsGuide
+                }];
+        }
+    },
     {
         id: 'FLOW-024',
         module: 'flow',
@@ -2366,7 +2389,7 @@ export const policyRules = [
         id: 'FLOW-023',
         module: 'flow',
         appliesTo: ['create', 'update'],
-        sourceRef: "Adım tipi sözlüğü backend'indir (StepType.cs) ama koşan tipler barındırıcıdan gelir: flow-engine.ts start·setter·code·condition·microservice·validation·flow-trigger register eder, web Runtime.svelte alert·confirm·redirect·download·storage·setcookie ekler, mobil @ng-apps/ui-native runtime-tasks.ts alert·confirm·redirect·navigate·storage·setcookie·download ekler. navigate web'de YOKTUR; end ve query hiçbir barındırıcıda yoktur (Studio kataloğu da bunu visibility ile söyler: navigate 'mobile', End eklenebilir adımlar arasında değil — EventActionsAdd.svelte). Register edilmemiş tipe gelen akış SESSİZCE durur: flow-engine.ts process() callback bulamazsa hiçbir şey yapmaz (next yok, completed/stopped yok, hata yok, log yok), run() Promise'i çözülmez ve flowRunFinished() hiç koşmaz — __ngAppsFlowActivity.running sıfıra inmez, page_screenshot'ın hazır bekleyişi her eylemde bütçesini sonuna kadar yakar",
+        sourceRef: "Adım tipi sözlüğü backend'indir (StepType.cs) ama koşan tipler barındırıcıdan gelir: flow-engine.ts start·setter·code·condition·microservice·validation·flow-trigger register eder, web Runtime.svelte alert·confirm·redirect·download·storage·setcookie ekler, mobil ScreenRuntime.tsx alert·redirect·navigate·storage·setcookie ekler. navigate web'de, confirm/download mobilde YOKTUR; end ve query hiçbir barındırıcıda yoktur (Studio kataloğu da bunu visibility ile söyler: navigate 'mobile', confirm/download 'web'; End eklenebilir adımlar arasında değil — EventActionsAdd.svelte). Register edilmemiş tipe gelen akış SESSİZCE durur: flow-engine.ts process() callback bulamazsa hiçbir şey yapmaz (next yok, completed/stopped yok, hata yok, log yok), run() Promise'i çözülmez ve flowRunFinished() hiç koşmaz — __ngAppsFlowActivity.running sıfıra inmez, page_screenshot'ın hazır bekleyişi her eylemde bütçesini sonuna kadar yakar",
         check: definition => {
             const steps = flowAllSteps(definition);
             // Studio her akış tuvaline dekoratif bir End düğümü koyar ve onu sildirmez; zararlı olan

package/dist/knowledge/styleResolve.js

@@ -539,7 +539,7 @@ const unwrapProp = (value) => {
         result[key] = unwrapProp(item);
     return result;
 };
-export const rawProp = (props, name) => {
+const rawProp = (props, name) => {
     const prop = props?.[name];
     // İfadeye bağlı prop'un değeri çalışma anında oluşur, burada çözülemez.
     return prop && typeof prop === 'object' && 'data' in prop ? unwrapProp(prop.data) : undefined;

package/dist/knowledge/themeResolve.js

@@ -332,8 +332,8 @@ export function buildSpacingScaleVars(scale) {
         .join('\n\t');
 }
 /**
- * Bir seviyenin dar ekran karşılığının masaüstüne oranı — bugünkü breakpoint değerlerinden türer.
- * Kullanıcı tek çarpan ayarlar, dar ekran ona orantılı hareket eder.
+ * Bir seviyenin mobil karşılığının masaüstüne oranı — bugünkü breakpoint değerlerinden türer.
+ * Kullanıcı tek çarpan ayarlar, mobil ona orantılı hareket eder.
  */
 const TYPE_SCALE_MOBILE_RATIO = {
     h1: 1.7 / 2.25,
@@ -363,7 +363,7 @@ export function mergeTypeScale(overrides) {
     }
     return result;
 }
-/** Ölçekten `--ng-font-size-*` değişkenlerini üretir (masaüstü + dar ekran). */
+/** Ölçekten `--ng-font-size-*` değişkenlerini üretir (masaüstü + mobil). */
 export function buildTypeScaleVars(scale) {
     const lines = [];
     for (const [level, factor] of Object.entries(scale)) {

package/dist/platform/diagnostics.js

@@ -0,0 +1,85 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { z } from 'zod';
+const activeMode = new AsyncLocalStorage();
+const MAX_NOTES = 8;
+const MAX_NOTE_CHARS = 240;
+const MAX_DROPS = 5;
+export const diagnosticsParam = z.enum(['compact', 'full']).optional().describe("Yanıttaki gatewayNormalized / silentlyDropped listelerinin boyu. compact (varsayılan): aynı not tekilleşir, uzun not kısalır (en fazla 8); aynı yolun düşmeleri tek satırda sayıyla toplanır (en fazla 5 grup); droppedCount her zaman tam sayıdır. full: listelerin tamamı.");
+export function runWithDiagnostics(mode, run) {
+    return activeMode.run(mode, run);
+}
+/**
+ * Tanılama listeleri her yazma çağrısında yanıta girer ve aynı gerekçe cümlesi çağrı başına tekrar
+ * eder. Kırpma yalnız GÖRÜNÜMÜ küçültür: `silentlyDropped` "kaydedildi mi" sorusunun tek kanıtı olduğu
+ * için liste hiçbir zaman sessizce boşalmaz — toplam sayı ve kalan satır sayısı yanıtta kalır, tam
+ * liste gateway günlüğünde (`sessiz düşme` / `düzeltme` adımları) durur.
+ *
+ * Kip bağlamı olmayan çağrı (okuma ve silme tool'ları, doğrudan `toolResult` kullanan testler) tam
+ * listeyi görür; kısaltma yalnız `diagnostics` parametresini taşıyan yazma tool'larında devreye girer.
+ */
+export function compactDiagnostics(payload) {
+    if (activeMode.getStore() !== 'compact')
+        return payload;
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload))
+        return payload;
+    const record = payload;
+    const notes = Array.isArray(record.gatewayNormalized) ? record.gatewayNormalized.map(String) : undefined;
+    const drops = Array.isArray(record.silentlyDropped) ? record.silentlyDropped.map(String) : undefined;
+    if (notes === undefined && drops === undefined)
+        return payload;
+    const hidden = [];
+    const result = { ...record };
+    if (notes !== undefined) {
+        const counts = new Map();
+        for (const note of notes)
+            counts.set(note, (counts.get(note) ?? 0) + 1);
+        const unique = [...counts.entries()].map(([note, count]) => {
+            const shortened = note.length > MAX_NOTE_CHARS ? `${note.slice(0, MAX_NOTE_CHARS - 1)}…` : note;
+            return count > 1 ? `${shortened} (×${count})` : shortened;
+        });
+        const shortenedCount = notes.filter(note => note.length > MAX_NOTE_CHARS).length;
+        const kept = unique.slice(0, MAX_NOTES);
+        result.gatewayNormalized = unique.length > MAX_NOTES ? [...kept, `… ${unique.length - MAX_NOTES} not daha`] : kept;
+        if (unique.length > MAX_NOTES)
+            hidden.push(`${unique.length - MAX_NOTES} not`);
+        if (shortenedCount > 0)
+            hidden.push(`${shortenedCount} notun gerekçesi kısaltıldı`);
+    }
+    if (drops !== undefined) {
+        const droppedCount = typeof record.droppedCount === 'number' ? record.droppedCount : drops.length;
+        const grouped = groupDrops(drops, record.droppedCountCapped === true || droppedCount > drops.length);
+        const kept = grouped.slice(0, MAX_DROPS);
+        if (grouped.length !== drops.length)
+            hidden.push('benzer düşme satırları toplandı');
+        if (grouped.length > MAX_DROPS)
+            hidden.push(`${grouped.length - MAX_DROPS} düşme grubu`);
+        result.silentlyDropped = grouped.length > MAX_DROPS ? [...kept, `… ${grouped.length - MAX_DROPS} grup daha`] : kept;
+        result.droppedCount = droppedCount;
+    }
+    if (hidden.length === 0)
+        return result;
+    return { ...result, diagnosticsNote: "Kısaltıldı; yazmayı tekrarlamayın. Tam liste: sonraki çağrıda diagnostics:'full'." };
+}
+/**
+ * Aynı yolun farklı öğelerindeki düşmeler (`selectFields[fieldId=a].path`, `selectFields[fieldId=b].path`, …)
+ * aynı sorunu tekrar eder. Seçici ve indeks `[*]`'a indirgenir, grup tek satırda sayıyla ve bir örnekle
+ * döner. Listedeki HER satır kayıptır (sıra uyarısı ve kesme bilgisi `silentlyDroppedNotes`'tadır ve
+ * buraya hiç girmez); micro-op satırları (`add_component 'x': …`) da kendi yolu altında gruplanır.
+ * Liste kesildiyse ya da sayım tavana vurduysa grup sayısı "en az" diye yazılır.
+ */
+function groupDrops(drops, partial) {
+    const groups = new Map();
+    for (const line of drops) {
+        const separator = line.indexOf(': ');
+        const path = separator === -1 ? line : line.slice(0, separator);
+        const outcome = line.includes(' ↔ ') ? (line.endsWith('kaydedilen yok') ? ' · kaydedilmedi' : ' · farklı kaydedildi') : '';
+        const pattern = `${path.replace(/\[[^\]]*\]/g, '[*]')}${outcome}`;
+        groups.set(pattern, [...(groups.get(pattern) ?? []), line]);
+    }
+    return [...groups.entries()].map(([pattern, lines]) => {
+        if (lines.length === 1)
+            return lines[0];
+        const example = lines[0].length > 160 ? `${lines[0].slice(0, 159)}…` : lines[0];
+        return `${pattern}: ${partial ? 'en az ' : ''}${lines.length} öğe — ör. ${example}`;
+    });
+}

package/dist/platform/domSummary.js

@@ -7,7 +7,7 @@
  * (card) · GİZLİ" 200 karakterdir.
  *
  * Katman saftır: tarayıcıdan gelen anlık görüntüyü doğrular ve biçimler. Toplama işi
- * `capture/summary.ts` `domSummaryScript`'te, sunum `pages.ts`'te.
+ * `screenshot.ts` `domSummaryScript`'te, sunum `pages.ts`'te.
  */
 function text(value) {
     return typeof value === 'string' && value.length > 0 ? value : undefined;

package/dist/platform/ifExists.js

@@ -0,0 +1,129 @@
+import { z } from 'zod';
+import { PlatformApiError } from './errors.js';
+/**
+ * `ifExists` parametresi. Aynı ad ya da slug'la ikinci kaydın `"<ad> (1)"` olarak açılması platformun
+ * ürün kararıdır (akış, sayfa, workflow ve microservice servisleri aynı sayaç kuralını uygular) ve
+ * değişmez. MCP ajanı çağrıyı tekrar edebildiği için varsayılan "yazma, mevcut id'yi söyle"dir.
+ */
+export function ifExistsParam(noun, updateNote) {
+    return z.enum(['error', 'update', 'duplicate']).default('error').describe(`Aynı ad ya da slug'da (büyük/küçük harf duyarsız) ${noun} varsa ne olacağı. 'error' (varsayılan): yazmaz, mevcut kaydın id'sini döner. 'update': ${updateNote}. 'duplicate': platformun ürün davranışı — ikinci kayıt açılır, platform ada/slug'a ' (1)' sayacını ekler (Studio'daki 'New … (1)' ile aynı kural).`);
+}
+const upper = (value) => String(value ?? '').toUpperCase();
+const isPresent = (value) => value !== undefined && value !== null && String(value) !== '';
+/**
+ * Var-mı kapısı (FLOW-026 ve kardeşleri). Aday araması platformda harfe duyarlıdır; gateway bilinçli
+ * olarak harf duyarsız karşılaştırır. Var-mı okuması başarısız olursa çağrı düşer — okuyamadığı
+ * listeyi boş sayan kontrol tam da zaman aşımında kopya üretirdi.
+ */
+export async function existingMatch(options) {
+    const { code, noun, where, name, slug, id, idParam, ifExists } = options;
+    const slugCounter = (options.slugSuffix ?? 'dash') === 'dash' ? "'-1'" : "' (1)'";
+    if (ifExists === 'duplicate')
+        return undefined;
+    if (!name && !slug)
+        return undefined;
+    let records;
+    try {
+        records = await options.list();
+    }
+    catch (error) {
+        throw new PlatformApiError(`${code}: mevcut ${noun} kayıtları okunamadı, ${noun} YAZILMADI (${error instanceof Error ? error.message : String(error)}). Liste okunmadan yazmak aynı adla ikinci kayıt açabilir; ${options.listTool} ile tekrar deneyin ya da bilerek ikinci kayıt istiyorsanız ifExists:'duplicate' verin.`);
+    }
+    const matches = records.filter(record => (name !== undefined && name !== '' && upper(record.name) === upper(name)) ||
+        (slug !== undefined && slug !== '' && upper(record.slug) === upper(slug)));
+    const [match] = matches;
+    if (match === undefined)
+        return undefined;
+    const describe = (record) => `${String(record.id)} ('${String(record.name)}', slug '${String(record.slug)}')`;
+    const copyPattern = name
+        ? new RegExp(`^${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')} \\(\\d+\\)$`, 'i')
+        : undefined;
+    const copies = copyPattern ? records.filter(record => copyPattern.test(String(record.name ?? ''))) : [];
+    const copyNote = copies.length > 0
+        ? ` ${where[0].toUpperCase()}${where.slice(1)} bu adın sayaçlı eşleri de var: ${copies.map(describe).join(' · ')} — ${options.copyCheck}.`
+        : '';
+    if (ifExists === 'error') {
+        throw new PlatformApiError(`${code}: ${where} aynı ad ya da slug'da ${noun} zaten var: ${matches.map(describe).join(' · ')}. İstek gönderilmedi — gönderilseydi platform ürün kuralı gereği ikinci bir ${noun} açardı (çakışan ada ' (1)', slug'a ${slugCounter} sayacı eklenerek; yalnız harf farkı varsa sayaçsız). Mevcut kaydı güncellemek için aynı çağrıyı ifExists:'update' ile tekrarlayın; bilerek ikinci kayıt istiyorsanız ifExists:'duplicate'.${copyNote}`, 409);
+    }
+    if (matches.length > 1) {
+        throw new PlatformApiError(`${code}: ad ve slug farklı kayıtlara çıkıyor (${matches.map(describe).join(' · ')}); hangisinin güncelleneceği belirsiz, istek gönderilmedi. ${options.updateTool} kullanın.${copyNote}`, 409);
+    }
+    // Eşleşme tipten bağımsızdır (platform sayacı tipe bakmaz), ama 'update' tipi farklı kaydın üstüne
+    // yazarsa kaydın türü değişir: backend PUT'ta tipi de yazar ve middleware automation'a dönüşür (R-1).
+    const kind = options.kind;
+    if (kind !== undefined && isPresent(kind.value) && isPresent(match[kind.key]) && upper(match[kind.key]) !== upper(kind.value)) {
+        throw new PlatformApiError(`${code}: aynı ad ya da slug'daki mevcut kayıt ${describe(match)} ${kind.key}='${String(match[kind.key])}'; gönderilen gövde ${kind.key}='${String(kind.value)}'. ifExists:'update' kaydın türünü değiştirirdi — istek gönderilmedi. Farklı ad/slug seçin ya da bilerek ikinci kayıt istiyorsanız ifExists:'duplicate'.${copyNote}`, 409);
+    }
+    if (id !== undefined && id.toLowerCase() !== String(match.id).toLowerCase()) {
+        throw new PlatformApiError(`${code}: verilen ${idParam} (${id}) aynı adlı mevcut kayıtla (${describe(match)}) çelişiyor; istek gönderilmedi. Mevcut kaydı güncellemek için ${idParam}'yi vermeyin ya da ${String(match.id)} verin.`, 409);
+    }
+    return match;
+}
+const LIST_PAGE_LENGTH = 200;
+const LIST_PAGE_LIMIT = 50;
+/**
+ * Uygulama düzeyindeki liste uçlarını (`GET /microservices|workflows|pages/{app}`) sonuna kadar okur.
+ * Arama terimi kullanılmaz: platformun `searchTerm`'ü slug'ı kapsamayabilir ve eksik liste kopya açar.
+ *
+ * Platform sayfaları kararlı sırada vermiyor (R-3): bir kayıt iki sayfada gelip başka biri hiç
+ * gelmeyebilir. İlk yanıttaki `meta.totalData` okunan TEKİL id sayısıyla tutmazsa liste tutarsızdır ve
+ * hata atılır — çağıran yazmaz. `meta` taşımayan eski yanıtta denetim yapılamaz.
+ */
+export async function listAll(platform, project, environment, path) {
+    const records = [];
+    let expected;
+    for (let pageIndex = 0; pageIndex < LIST_PAGE_LIMIT; pageIndex++) {
+        const payload = await platform.tenant('GET', project, path, { environment, query: { pageIndex, pageLength: LIST_PAGE_LENGTH } });
+        if (!Array.isArray(payload?.data))
+            throw new PlatformApiError('liste yanıtında data dizisi yok');
+        if (pageIndex === 0 && typeof payload.meta?.totalData === 'number')
+            expected = payload.meta.totalData;
+        records.push(...payload.data);
+        if (payload.data.length < LIST_PAGE_LENGTH || (expected !== undefined && records.length >= expected)) {
+            const unique = new Set(records.map(record => String(record.id).toLowerCase())).size;
+            if (expected !== undefined && unique !== expected) {
+                throw new PlatformApiError(`liste tutarsız okundu: platform ${expected} kayıt dedi, sayfalardan ${unique} tekil kayıt geldi (${records.length - unique} tekrar) — sayfa sırası kararlı değil`);
+            }
+            return records;
+        }
+    }
+    throw new PlatformApiError(`liste ${LIST_PAGE_LENGTH * LIST_PAGE_LIMIT} kaydı aştı, tamamı okunamadı`);
+}
+/**
+ * `ifExists:'duplicate'` yazmasında platform ada ' (n)', slug'a '-n' (akışta ' (n)') ekler. Bu fark kayıp
+ * değildir (Gözlem 1): kalıba uyan alan karşılaştırmadan ÖNCE gönderilen gövdede kaydedilen değerle
+ * değiştirilir ve `renamedByPlatform`'a gider. Kalıba uymayan fark gövdede kalır, yani yine kayıptır.
+ */
+export function platformRename(sent, saved, slugSuffix) {
+    const record = saved && typeof saved === 'object' && !Array.isArray(saved) ? saved : {};
+    const escape = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const renamed = {};
+    const adjusted = { ...sent };
+    for (const key of ['name', 'slug']) {
+        const given = sent[key];
+        const stored = record[key];
+        if (typeof given !== 'string' || typeof stored !== 'string' || given === stored)
+            continue;
+        const pattern = key === 'slug' && slugSuffix === 'dash'
+            ? new RegExp(`^${escape(given)}-\\d+$`)
+            : new RegExp(`^${escape(given)} \\(\\d+\\)$`);
+        if (!pattern.test(stored))
+            continue;
+        renamed[key] = stored;
+        adjusted[key] = stored;
+    }
+    return Object.keys(renamed).length === 0 ? { sent: adjusted } : { sent: adjusted, renamed };
+}
+export function withRename(payload, renamed) {
+    if (renamed === undefined || !payload || typeof payload !== 'object' || Array.isArray(payload))
+        return payload;
+    return { ...payload, renamedByPlatform: renamed };
+}
+/**
+ * Yazma yanıtına `outcome` ekler; ajan kaydın yeni mi açıldığını yoksa güncellendiğini mi tek alandan okur.
+ */
+export function withOutcome(payload, existing) {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload))
+        return payload;
+    return { ...payload, outcome: existing === undefined ? 'created' : 'updated' };
+}

package/dist/platform/responses.js

@@ -1,3 +1,4 @@
+import { compactDiagnostics } from './diagnostics.js';
 import { logError, logStep } from '../observability/trace.js';
 import { PlatformApiError, describeErrorBody } from './errors.js';
 import { PolicyBlockError } from '../knowledge/policy.js';
@@ -139,7 +140,7 @@ function asStructured(payload) {
     return { data: payload };
 }
 export function toolResult(payload, config, expectFailure) {
-    const pruned = prune(payload);
+    const pruned = prune(compactDiagnostics(payload));
     const { payload: safe, masked, tokenRefs } = maskSecrets(pruned);
     const runtimeErrors = runtimeErrorSummary(safe);
     if (runtimeErrors.length > 0) {