@appaflytech/zeyrek-ai-mcp 0.0.8 → 0.0.9

package/dist/tools/pages.js

@@ -1,21 +1,24 @@
 import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive, microOps, isBranchName } from './common.js';
-import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, staleSetterWarnings, lostSetterTargets, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, spacingLayerWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, isFlexContainer, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, flexIndexOrder, flexIndexOrderNote, withNormalization, parseVariableEntries, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
+import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, staleSetterWarnings, lostSetterTargets, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, spacingLayerWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, flexIndexOrder, flexIndexOrderNote, withNormalization, parseVariableEntries, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
 import { functionSignature } from '../knowledge/functionGuards.js';
-import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, outlineAppliedPatch, findNode, flowPath } from './screens.js';
+import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode, flowPath } from './screens.js';
 import { fetchComponentEventNames } from './components.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
+import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, planEventRemovals, resizeServerOps, planResizes, planPropTypes, rejectedOpsMessage } from './schemaOps.js';
 import { formBindingWarnings, formSubmitButtonWarnings } from '../knowledge/coverage.js';
 import { schemaOpDrops, silentlyDropped, unwrapProps, withWriteDiff } from '../platform/writeDiff.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle, toolResult, toolError } from '../platform/responses.js';
 import { StudioScreenshotter } from '../platform/screenshot.js';
+import { diffSummaries, summaryLines, summaryStats } from '../platform/domSummary.js';
+import { captureKey, imageHash, sharedCaptureMemory } from '../platform/screenshotMemory.js';
 import { summarizeLayout } from '../knowledge/layoutSummary.js';
 import { normalizeLanguageCode } from '../knowledge/languageCodes.js';
 import { readProjectLanguages } from '../knowledge/languages.js';
 import { resolveIdentityToken } from '../platform/tokenVault.js';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { dirname, resolve } from 'node:path';
-import { applyPropTypesToSchema, setPropTypeErrors } from '../knowledge/propTypes.js';
+import { setPropTypeErrors } from '../knowledge/propTypes.js';
 import { z } from 'zod';
 /**
  * Runtime paketindeki `appFunctions`/`pageFunctions` (UiFunctionRuntimeDto: id, name, parameters,
@@ -35,130 +38,6 @@ function runtimeFunctions(value) {
             .map(parameter => ({ name: parameter.name, required: parameter.required === true, defaultValue: parameter.defaultValue ?? null }))
     }));
 }
-/**
- * Yazma yanıtındaki şema gövdesinin biçimi (B-55 · S-9). Varsayılan `outline`: gövde ajanın
- * aynı turda kendi gönderdiği içeriğin yankısıdır, kanıt ise pointer'da ve `silentlyDropped`ta
- * durur. Bayrağı bilmeyen ajan pahalı olanı ödemesin diye kırpma OPT-OUT'tur (aynı karar:
- * `DS-004`, `datasource_configuration_options`).
- */
-const writeViewParam = z.enum(['outline', 'full']).optional().describe("Yanıttaki şema gövdesinin biçimi. outline (VARSAYILAN): komponent ağaçları iskelete iner (id/elementId/name/type/children), appliedPatch her op'un op+path'ini verir — 'yalnız o komponente mi dokunuldu' kanıtı JSON Pointer'dadır, 'kaydedildi mi' kanıtı silentlyDropped'tadır. full: platformun döndürdüğü gövde aynen gelir.");
-/**
- * `appliedPatch` zarfın altında da gelebilir (`{ data: { appliedPatch } }`), düz de.
- */
-function outlineWriteResponse(response) {
-    const inner = response.data;
-    const container = (inner && typeof inner === 'object' && !Array.isArray(inner) ? inner : response);
-    if (Array.isArray(container.appliedPatch))
-        container.appliedPatch = outlineAppliedPatch(container.appliedPatch);
-}
-const opsParam = z.array(z.record(z.unknown())).describe("Micro-op listesi. Op sözlüğü: replace_prop {target, prop, value} (value ham değer, code sarmalı {type: 'code', ref: '{{ … }}'} ya da translation sarmalı {type: 'translation', ref: '<çeviri anahtarı>'} — prop tipini değiştirmek için komponenti silip yeniden EKLEMEYİN, ona yazan setter'ların hedefi silinir (FLOW-018); platform replace_prop'ta expression alanını OKUMAZ — gateway onu code sarmalına çevirir) | set_binding {target, prop, expression: '{{ Page.variables.x }}'} | add_component {parent (üst elementId ya da 'root'), index?, component} | remove_component {target} | move_component {target, parent, index?, position: {x, y}} (index ÇİZİM sırası değildir, runtime çocukları blocks.position'a göre (y, sonra x) çizer: flex kapta gateway index'i görünen sıraya çevirir ve kardeş konumlarını yeniden yazar; ızgara kapta sırayı position.y verir, sona eklemeyen index PAGE-033 uyarısıdır) | set_event {target, event, eventValue} | remove_event {target, event} (gateway emülasyonu: platformun micro-op'u olay SİLEMEZ, eventValue: null yalnız değersiz ölü kayıt bırakır — bu op şemayı okuyup olayı diziden çıkarır ve sayfayı tam gövdeyle geri yazar) | set_validations {target, validations: [{type, message, value, isActive}]} (komponentin validation listesini TAMAMEN değiştirir; boş dizi hepsini siler) | set_appearance {target, appearance: {heightType?, widthType?, tooltip?, background?, …}} (kurulu düğümün appearance'ına YALNIZ verilen alanları yazar, gerisini korur; null alanı temizler; bilinmeyen alan reddedilir. GÖRÜNÜRLÜK appearance'ta DEĞİLDİR: gizlemek için replace_prop {target, prop: 'isHidden', value: true}, koşul için set_binding {prop: 'isHidden'} — add_component gövdesindeki appearance.isHidden'ı gateway props.isHidden'a taşır) | resize_component {target, size?: {w,h}, appearance?: {widthType,widthString,heightType,heightString}, states?: {isWrapper,isScrollable,isSticky,isDroppable,isFloating,isQuickStack}, breakpoint?: 1024} (gateway emülasyonu: platformun micro-op'unda boyut YOKTUR ve move_component'e konan size sessizce düşer — bu op şemayı okuyup hedefin boyutunu değiştirir ve sayfayı tam gövdeyle geri yazar. Izgarada blocks[].size, flex'te appearance geçerlidir; ebeveynin düzeni yazılanı etkisiz kılıyorsa PAGE-019 uyarısı çıkar. states bir PROP DEĞİL düğüm alanıdır ve replace_prop onu yazamaz — kurulmuş bir düğümün isWrapper bayrağını değiştirmenin tek yolu buydu). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (gateway emülasyonu: replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op şemayı okuyup prop'un TİPİNİ yerinde değiştirir ve sayfayı tam gövdeyle geri yazar. Taşıyıcı alan tipe göre: static → data, code ve translation → ref (runtime data'yı her turda ezer, anahtar yalnız ref'te yaşar). Eksik taşıyıcı istek gönderilmeden reddedilir; page_schema_validate aynı kararı verir). target = elementId.");
-/**
- * PAGE-008 — `set_event` uydurma bir olay adıyla 200 döner ve bağ SESSİZCE ölü kalır: motor olayı
- * komponentin yaydığı adla eşleştirir, eşleşme yoksa akış hiç çalışmaz. Kontrol yalnız hedefin
- * tipini ve o tipin katalogdaki olay listesini pozitif olarak çözebildiğinde konuşur (layout/widget
- * içindeki hedefler ve katalogda olay tanımlamayan tipler doğrulanmadan geçer).
- */
-function unknownEventOps(ops, typesByElementId, eventsBySlug) {
-    return ops
-        .map(op => op)
-        .filter(op => op.op === 'set_event')
-        .flatMap(op => {
-        const target = String(op.target ?? '');
-        const event = String(op.event ?? '');
-        const type = typesByElementId.get(target);
-        const declared = type ? eventsBySlug.get(type) : undefined;
-        if (!event || !declared || declared.includes(event))
-            return [];
-        return [`'${target}' (${type}) komponenti '${event}' diye bir olay YAYMAZ. Yaydıkları: ${declared.join(', ')}. Platform bu op'u 200 ile kabul eder ama bağ sessizce ölü kalır — akış hiçbir zaman çalışmaz. Doğru adı component_get(slug:'${type}') çıktısındaki events listesinden alın.`];
-    });
-}
-/**
- * Ön kontroller eskiden İLK hatada fırlatıyordu: dört op'u yanlış olan bir yama dört ayrı turda
- * ancak görülüyordu ve her tur tüm planı yeniden gönderiyordu (S-11, 2026-09-15). Artık op başına
- * toplanır ve tek yanıtta döner. Yama yine ATOMİKTİR — birbirine bağlı op'lar (add_component +
- * set_event) yarım kalmasın diye geçenler de gönderilmez.
- */
-function rejectedOpsMessage(unordered) {
-    const rejected = [...unordered].sort((left, right) => left.index - right.index);
-    const lines = rejected.map(entry => `#${entry.index} ${entry.op}${entry.target ? ` '${entry.target}'` : ''} [${entry.code}]: ${entry.message}`);
-    const validationHint = rejected.some(entry => entry.code === 'PAGE-016')
-        ? " PAGE-016 çalışan biçimi dört alanı da taşır: { type: 'required'|'email'|'regex'|'max-length'|'min-length'|'max-value'|'min-value'|'value-options', message: '<kullanıcıya görünen metin>', value: <eşik/desen/true>, isActive: true }."
-        : '';
-    return `Ön kontrol ${rejected.length} op'u reddetti; yama atomik olduğu için HİÇBİR op gönderilmedi (istek gönderilmedi). Düşen op'ları düzeltip TÜM listeyi tek çağrıda yeniden gönderin.${validationHint}\n${lines.join('\n')}\nrejectedOps: ${JSON.stringify(rejected)}`;
-}
-function collectTypes(nodes, into) {
-    for (const node of nodes ?? []) {
-        if (typeof node.elementId === 'string' && typeof node.type === 'string')
-            into.set(node.elementId, node.type);
-        collectTypes(node.children, into);
-    }
-}
-function removeNodeFromTree(nodes, target, parent) {
-    for (let index = 0; index < nodes.length; index++) {
-        if (nodes[index].elementId === target)
-            return { node: nodes.splice(index, 1)[0], parent };
-        const found = removeNodeFromTree(nodes[index].children ?? [], target, nodes[index]);
-        if (found)
-            return found;
-    }
-    return undefined;
-}
-function setDesktopPosition(node, position) {
-    const blocks = Array.isArray(node.blocks) ? node.blocks : [];
-    const block = blocks.find(entry => Number(entry?.breakpoint) === 1024);
-    if (block)
-        block.position = { x: Number(position.x ?? 0), y: Number(position.y ?? 0) };
-}
-/**
- * PAGE-010 boşluk analizi patch'in SONUCUNU görmek zorunda: tek başına op'lardaki y değerleri,
- * kapsayıcının mevcut çocukları bilinmeden anlamsız. Op'lar okunan şemanın kopyasına uygulanır
- * (add: parent'ın children'ına ekle — kökler retargetRootAdds ile page_container'a gittiği için
- * burada da öyle çözülür; move: düğümü taşı — parent verilmemişse aynı ebeveynde kalır — ve verilen
- * position'ı desktop block'una yaz; ikisinde de index platformdaki gibi diziye yerleşir) ve analiz
- * yalnız dokunulan kapsayıcılarda koşar.
- */
-function simulateLayoutOps(schema, ops) {
-    const touched = new Set();
-    const attach = (node, requestedParent, index) => {
-        const parentId = typeof requestedParent === 'string' && requestedParent !== '' && requestedParent !== 'root'
-            ? requestedParent
-            : PAGE_CONTAINER_ELEMENT_ID;
-        const parent = findNode(schema, parentId);
-        const siblings = parent ? [...(parent.children ?? [])] : schema;
-        const insertAt = typeof index === 'number' && Number.isFinite(index) ? Math.max(0, Math.min(index, siblings.length)) : siblings.length;
-        siblings.splice(insertAt, 0, node);
-        if (parent) {
-            parent.children = siblings;
-            touched.add(String(parent.elementId ?? parentId));
-        }
-        else {
-            touched.add('kök');
-        }
-    };
-    for (const op of ops) {
-        if (op.op === 'add_component' && op.component && typeof op.component === 'object') {
-            attach(JSON.parse(JSON.stringify(op.component)), op.parent, op.index);
-        }
-        // Düzen prop'ları (layout/flex grubu) simülasyona girer: PAGE-010 flex kapsayıcının içini
-        // analiz etmez, PAGE-015 ise op'tan SONRAKİ layout değerine bakar — ikisi de op uygulanmadan
-        // doğru karar veremez.
-        if (op.op === 'replace_prop' && FLEX_LAYOUT_PROP_NAMES.has(String(op.prop ?? ''))) {
-            const target = findNode(schema, String(op.target ?? ''));
-            const codeWrapper = op.value && typeof op.value === 'object' && op.value.type === 'code';
-            if (target)
-                target.props = { ...(target.props ?? {}), [String(op.prop)]: codeWrapper ? op.value : { type: 'static', ref: null, data: op.value } };
-        }
-        if (op.op === 'move_component') {
-            const moved = removeNodeFromTree(schema, String(op.target ?? ''));
-            if (!moved)
-                continue;
-            if (op.position && typeof op.position === 'object')
-                setDesktopPosition(moved.node, op.position);
-            attach(moved.node, op.parent ?? moved.parent?.elementId ?? 'root', op.index);
-        }
-    }
-    return touched;
-}
 /**
  * G-10: `index` taşıyan add/move op'u varsa sayfa okunur ve `flexIndexOrder` flex kapta görünen
  * sırayı konumlara çevirir. Okuma başarısız olursa op'lar olduğu gibi gider — bugünkü davranış.
@@ -179,151 +58,16 @@ async function fetchPage(platform, project, environment, applicationId, pageId)
     return response?.data ?? {};
 }
 /**
- * F-8 — platformun `set_event` micro-op'u olay KALDIRAMAZ: `eventValue: null` verildiğinde
- * PageSchemaMicroOpApplier kaydı `{ name: 'click' }` olarak (değersiz) bırakır, diziden çıkarmaz;
- * ölü bağ şemada artık olarak kalır. Kaldırma yolu tek: şemayı okuyup diziden çıkarmak ve sayfayı
- * tam gövdeyle geri yazmak (page_update'in kullandığı PUT — pageUpdateBody her alanı korur).
- * `target: 'page'` sayfa düzeyi olayları hedefler.
+ * Platformun sayfa micro-op sözlüğü (`PageSchemaMicroOpApplier.KnownOps`). Gateway'in sunucuya
+ * ilettiği op'lar yalnız bunlardır; `test/page-micro-op-parity.test.ts` listeyi backend ve
+ * `@ng-apps/screen-builder` ile karşılaştırır. `resize_component` gateway adıdır ve sunucuya
+ * `set_block` + `set_appearance` + `set_states` olarak çevrilir.
  */
-async function applyEventRemovals(platform, project, environment, applicationId, pageId, page, ops) {
-    const schema = JSON.parse(JSON.stringify(page.schema ?? []));
-    const pageEvents = Array.isArray(page.events) ? [...page.events] : [];
-    const removed = [];
-    let pageEventsTouched = false;
-    for (const op of ops) {
-        const target = String(op.target ?? '');
-        const event = String(op.event ?? '');
-        if (!target || !event)
-            throw new PlatformApiError("remove_event için 'target' ve 'event' zorunludur.", 400);
-        if (target === 'page') {
-            const before = pageEvents.length;
-            const kept = pageEvents.filter(entry => String(entry?.name ?? '') !== event);
-            if (kept.length !== before) {
-                pageEvents.length = 0;
-                pageEvents.push(...kept);
-                pageEventsTouched = true;
-                removed.push(`page.${event}`);
-            }
-            continue;
-        }
-        const node = findNode(schema, target);
-        if (!node)
-            throw new PlatformApiError(`remove_event hedefi bulunamadı: '${target}'. page_schema_get ile elementId'leri listeleyin.`, 400);
-        const events = Array.isArray(node.events) ? node.events : [];
-        const kept = events.filter(entry => String(entry?.name ?? '') !== event);
-        if (kept.length !== events.length)
-            removed.push(`${target}.${event}`);
-        node.events = kept;
-    }
-    if (removed.length === 0)
-        return [];
-    const body = pageUpdateBody(page, pageEventsTouched ? { schema, events: pageEvents } : { schema });
-    await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
-    return removed;
-}
-function findParentNode(nodes, target) {
-    for (const node of nodes) {
-        if ((node.children ?? []).some(child => child.elementId === target))
-            return node;
-        const deeper = findParentNode(node.children ?? [], target);
-        if (deeper)
-            return deeper;
-    }
-    return undefined;
-}
-/**
- * `resize_component` gateway emülasyonudur: platformun micro-op sözlüğünde boyut YOKTUR
- * (`move_component` yalnız `position` uygular, gövdeye konan `size` 200 döner ve sessizce düşer —
- * ölçüldü 09-04). Bu yüzden kurulmuş bir sayfada bir kartın yüksekliğini değiştirmenin tek yolu
- * düğümü `remove_component` + `add_component` ile yeniden kurmaktı; o da ona yazan akış
- * setter'larını sessizce öldürüyordu (FLOW-018). Op şemayı okur, hedefin boyutunu değiştirir ve
- * sayfayı tam gövdeyle geri yazar — `remove_event` ile aynı desen.
- *
- * Izgarada boyut `blocks[].size`, flex'te `appearance` alanlarındadır; ikisi de kabul edilir ve
- * ebeveynin düzeni okunanı etkisiz kılıyorsa uyarı üretilir (PAGE-015 ile aynı yaklaşım: reddetme,
- * ama sessiz de kalma).
- */
-/**
- * G-25 — `states` bir prop değil düğüm alanı: `replace_prop` yazamıyor, `move_component` yalnız
- * konum uyguluyor ve `resize_component` (G-14) boyutla sınırlıydı. Kurulmuş bir düğümün
- * `isWrapper` bayrağını değiştirmenin tek yolu düğümü silip yeniden kurmaktı; 09-05 koşusunda
- * bunun bedeli 20 setter'ın sessizce kopmasıydı (G-21). Anahtar kümesi beyaz listeyle sınırlı:
- * `states` açık uçlu bir sözlük ve uydurma bayrak sessizce kaydedilirdi.
- */
-const WRITABLE_STATES = new Set(['isWrapper', 'isScrollable', 'isSticky', 'isDroppable', 'isFloating', 'isQuickStack']);
-async function applyResizes(platform, project, environment, applicationId, pageId, page, ops) {
-    const schema = JSON.parse(JSON.stringify(page.schema ?? []));
-    const applied = [];
-    const warnings = [];
-    for (const op of ops) {
-        const target = String(op.target ?? '');
-        const size = op.size && typeof op.size === 'object' ? op.size : undefined;
-        const appearance = op.appearance && typeof op.appearance === 'object' ? op.appearance : undefined;
-        const states = op.states && typeof op.states === 'object' ? op.states : undefined;
-        const breakpoint = Number(op.breakpoint ?? 1024);
-        if (!target)
-            throw new PlatformApiError("resize_component için 'target' zorunludur.", 400);
-        if (!size && !appearance && !states) {
-            throw new PlatformApiError(`resize_component '${target}' için 'size' ({ w, h } — ızgara), 'appearance' ({ widthType, widthString, heightType, heightString } — flex) ya da 'states' ({ isWrapper, isScrollable, isSticky, isDroppable, isFloating, isQuickStack }) verilmelidir; üçü de boş.`, 400);
-        }
-        if (states) {
-            const unknownStates = Object.keys(states).filter(key => !WRITABLE_STATES.has(key));
-            if (unknownStates.length > 0) {
-                throw new PlatformApiError(`resize_component '${target}': bilinmeyen states anahtarı (${unknownStates.join(', ')}). Yazılabilir bayraklar: ${[...WRITABLE_STATES].join(', ')}.`, 400);
-            }
-        }
-        const node = findNode(schema, target);
-        if (!node)
-            throw new PlatformApiError(`resize_component hedefi bulunamadı: '${target}'. page_schema_get ile elementId'leri listeleyin.`, 400);
-        const parent = findParentNode(schema, target);
-        const inFlex = parent !== undefined && isFlexContainer(parent);
-        if (size) {
-            const blocks = Array.isArray(node.blocks) ? node.blocks : [];
-            const block = blocks.find(entry => Number(entry?.breakpoint) === breakpoint);
-            if (!block) {
-                throw new PlatformApiError(`resize_component '${target}' düğümünde ${breakpoint} breakpoint'li blok yok (var olanlar: ${blocks.map(entry => entry?.breakpoint).join(', ') || 'hiç'}). Farklı bir breakpoint verin ya da düğümü add_component ile blokları kurulu olarak ekleyin.`, 400);
-            }
-            const current = (block.size ?? {});
-            block.size = { w: Number(size.w ?? current.w ?? 0), h: Number(size.h ?? current.h ?? 0) };
-            applied.push(`${target}.size=${JSON.stringify(block.size)}`);
-            if (inFlex) {
-                warnings.push(`PAGE-019 (uyarı): '${target}' düğümünün ebeveyni flex kapsayıcı; orada yerleşimi 'blocks[].size' DEĞİL appearance (widthType/widthString/heightType/heightString) belirler. Boyut yazıldı ama ekranda etkisi olmayabilir — flex'te ölçü vermek için aynı op'a 'appearance' koyun.`);
-            }
-        }
-        if (states) {
-            node.states = { ...(node.states ?? {}), ...states };
-            applied.push(`${target}.states=${JSON.stringify(states)}`);
-            if (states.isWrapper === true) {
-                warnings.push(`PAGE-020 (uyarı): '${target}' düğümüne isWrapper:true yazıldı — runtime sarmalayıcı düğüme 'min-height: 80vh' veriyor ve bu, sayfanın altına yüzlerce piksel ölü boşluk ekleyebilir (ölçüldü 09-05: dokuz düğüm ~1600px). style ile ezilemez; gerekmiyorsa isWrapper:false bırakın.`);
-            }
-        }
-        if (appearance) {
-            node.appearance = { ...(node.appearance ?? {}), ...appearance };
-            applied.push(`${target}.appearance=${JSON.stringify(appearance)}`);
-            if (!inFlex && parent !== undefined) {
-                warnings.push(`PAGE-019 (uyarı): '${target}' düğümünün ebeveyni flex DEĞİL; ızgarada yerleşimi 'blocks[].size' belirler ve appearance genişlik/yükseklik alanları etkisiz kalabilir. Izgarada ölçü vermek için aynı op'a 'size' koyun.`);
-            }
-        }
-    }
-    if (applied.length === 0)
-        return { applied, warnings };
-    const body = pageUpdateBody(page, { schema });
-    await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
-    return { applied, warnings };
-}
-async function applyPropTypes(platform, project, environment, applicationId, pageId, page, ops) {
-    const schema = JSON.parse(JSON.stringify(page.schema ?? []));
-    const { applied, missingTargets } = applyPropTypesToSchema(schema, ops);
-    if (missingTargets.length > 0) {
-        throw new PlatformApiError(`set_prop_type hedefi bulunamadı: '${missingTargets[0]}'. page_schema_get ile elementId'leri listeleyin.`, 400);
-    }
-    if (applied.length === 0)
-        return [];
-    const body = pageUpdateBody(page, { schema });
-    await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
-    return applied;
-}
-export function registerPageTools(server, platform, injectedScreenshotter) {
+export const SERVER_PAGE_OPS = [
+    'replace_prop', 'set_binding', 'set_prop_type', 'add_component', 'remove_component', 'move_component', 'reorder', 'set_block',
+    'set_appearance', 'set_states', 'set_event', 'remove_event', 'set_validations', 'set_state_binding', 'remove_state_binding', 'batch'
+];
+export function registerPageTools(server, platform, injectedScreenshotter, injectedMemory) {
     const config = platform.config;
     const asUserParam = z.string().min(1).optional().describe("Uygulama üyesinin kimliği: istek gateway'in servis jetonu yerine bu kimlikle gider. Jeton HEM Authorization başlığında HEM NG_AccessToken çerezinde taşınır, böylece çerez okuyan middleware de geçer. İKİ ŞEKİL kabul edilir: (1) ham JWT, (2) `tok_…` referansı — uygulamanın giriş ucunu microservice_execute ile çağırdığınızda jeton maskelenir ama yanıtın `tokenRefs` alanında referansı döner; jetonu hiç görmeden onu buraya verin (15 dk geçerli). anonymous ile birlikte verilemez.");
     /** Sayfa ve uç araçları aynı kimlik sözleşmesini paylaşır (G-20); çözüm tokenVault'ta yaşar. */
@@ -434,12 +178,23 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             appFunctions: runtimeFunctions(body.appFunctions),
             pageFunctions: runtimeFunctions(body.pageFunctions),
             hasTheme: Boolean(body.project?.theme),
+            // Tema ADLARI burada durur: bir düğüme $preset yazmadan önce hangi adların geçerli olduğunu
+            // bilmek gerekir ve bunun için ayrı bir çağrı atmak gereksiz (tam kayıt için theme_get).
+            ...(theme
+                ? {
+                    theme: {
+                        presets: Object.keys(theme.presets ?? {}),
+                        componentStyles: Object.keys(theme.componentStyles ?? {})
+                    }
+                }
+                : {}),
             note: resolveStyles
-                ? "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f). resolvedStyle = componentStyles → preset → düğüm stili kaskadı (aibox'ta tipli grupların derlemesi TABAN katmandır); styleLayers hangi katmanların konuştuğunu söyler."
+                ? "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f). resolvedStyle = componentStyles → preset → düğüm stili kaskadı (aibox'ta tipli grupların derlemesi TABAN katmandır); styleLayers hangi katmanların konuştuğunu söyler — styleLayers.componentPreset ise CSS DEĞİL, düğümün hangi bileşen preseti versiyonundan kurulduğunun işaretidir."
                 : "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f); tam gövde gerekirse view:'full'. Bir düğümün ekranda GERÇEKTEN aldığı stili görmek için resolveStyles:true."
         };
     }));
     const screenshotter = injectedScreenshotter ?? new StudioScreenshotter(config);
+    const captureMemory = injectedMemory ?? sharedCaptureMemory;
     const maxInlinePngBytes = 5 * 1024 * 1024;
     server.registerTool('page_screenshot', {
         title: 'Sayfanın ekran görüntüsünü al',
@@ -462,22 +217,38 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             layoutReport: z.boolean().optional().describe("true: kareyle birlikte her runtime düğümünün efektif piksel kutusunu ve özetini (taşan / viewport dışı / sıfır boyutlu elementId'ler) döner — taşma ve çakışmayı görüntüsüz, sayısal yakalar. Düğümler data-element-id taşımıyorsa layoutReportUnavailable döner."),
             cookies: z.record(z.string()).optional().describe("Tarayıcıya enjekte edilecek EK çerezler (ad → değer): uygulamanın kendi oturum çerezi buraya verilir. Aynı ada sahip çerez gateway jetonunun yerine geçer. anonymous ile birlikte verilemez."),
             actions: z.array(z.object({
-                action: z.enum(['set', 'click', 'wait', 'drag']),
-                target: z.string().min(1).optional().describe("Hedefin elementId'si (page_schema_get); runtime düğümü data-element-id ile bulunur. 'drag' için sürüklenen öğe (ör. 'kb_board__card-42', 'cal_plan__event-7')"),
+                action: z.enum(['set', 'click', 'wait', 'drag', 'tab', 'select', 'submit']),
+                target: z.string().min(1).optional().describe("Hedefin elementId'si (page_schema_get); runtime düğümü data-element-id ile bulunur. 'drag' için sürüklenen öğe (ör. 'kb_board__card-42', 'cal_plan__event-7'); 'tab' için sekme GRUBUNUN kendisi ('tabs_settings'), 'select' için açılır kutu, 'submit' için form komponenti"),
                 to: z.string().min(1).optional().describe("Yalnız 'drag': bırakma hedefinin elementId'si — kanban kolonu '<elementId>__col-<value>', takvim günü '<elementId>__day-<yyyy-MM-dd>', tüm gün hücresi '<elementId>__allday-<yyyy-MM-dd>', saat dilimi '<elementId>__slot-<yyyy-MM-dd>T<HH>'"),
-                value: z.unknown().optional().describe("'set' için yazılacak değer. Tarih kutularına ISO yazın ('2026-08-01'); çok alanlı tarih aralığında kök DEĞİL kutu hedeflenir: '<elementId>__start' / '<elementId>__end'"),
+                value: z.unknown().optional().describe("'set' için yazılacak değer. Tarih kutularına ISO yazın ('2026-08-01'); çok alanlı tarih aralığında kök DEĞİL kutu hedeflenir: '<elementId>__start' / '<elementId>__end'. 'tab' için sekmenin ANAHTARI ('iot') ya da görünen metni; 'select' için seçeneğin value'su ya da görünen metni"),
                 ms: z.number().int().min(0).max(15000).optional().describe("'wait' için bekleme süresi")
-            })).max(20).optional().describe("Kare ALINMADAN ÖNCE sayfada koşturulacak etkileşim adımları: [{action:'set', target:'flt_month', value:'2022-10'}, {action:'click', target:'btn_sign_in'}, {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}]. 'drag' HTML5 sürükle-bırak olaylarını (dragstart→dragover→drop→dragend) hedefin merkezinde atar; kanban cardMove ve takvim eventMove bununla tetiklenir. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez); ardından kök düğümün runtime prop'larını yeniden okur: actionsReport.propWritten değerin prop'a ULAŞIP ulaşmadığıdır ve false ise applied da false döner — DOM'a yazılmış ama bileşenin duymadığı değer 'uygulandı' sayılmaz (G-14). Her adımdan sonra yerleşme beklenir ve yanıttaki actionsReport hedefin bulunup bulunmadığını ve adımdan sonra KAÇ AĞ İSTEĞİ çıktığını söyler — 'bağ kuruldu' ile 'çalışıyor' arasındaki farkı ancak bu ayırır (G-24)."),
+            })).max(20).optional().describe("Kare ALINMADAN ÖNCE sayfada koşturulacak etkileşim adımları: [{action:'set', target:'flt_month', value:'2022-10'}, {action:'click', target:'btn_sign_in'}, {action:'tab', target:'tabs_settings', value:'iot'}, {action:'select', target:'dd_city', value:'34'}, {action:'submit', target:'frm_note'}, {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}]. 'tab' SEKME SEÇER: sekme grubunun köküne 'click' göndermek DOM sırasındaki İLK sekmeye gider ve ikinci sekme hiç açılamıyordu — tablist köküne click artık reddedilir ve bu fiile yönlendirir. Eşleme önce '<elementId>__tab-<sekme anahtarı>' kimliğiyle, o yoksa görünen metinle yapılır; actionsReport.matchedBy hangisi olduğunu, actionsReport.activeTab adımdan SONRA hangi sekmenin açık olduğunu söyler. Etkin olmayan sekmenin içeriği DOM'da YOKTUR: o sekmedeki bir düğüme yazmadan önce 'tab' adımı gerekir. 'select' açılır kutudan seçer — kutu native alan değildir, değeri yazmak hiçbir şey yapmaz, seçeneğe tıklanması gerekir; liste 3 sn'ye kadar YOKLANIR (sorgudan beslenen kutuda seçenekler geç basılır) ve actionsReport.optionsSeen + waitedMs neyin görüldüğünü söyler. 'submit' formu gönder butonu OLMADAN gönderir (form.requestSubmit); actionsReport.submitVia hangi yolun kullanıldığını yazar. 'drag' HTML5 sürükle-bırak olaylarını (dragstart→dragover→drop→dragend) hedefin merkezinde atar; kanban cardMove ve takvim eventMove bununla tetiklenir. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez); ardından kök düğümün runtime prop'larını yeniden okur: actionsReport.propWritten değerin prop'a ULAŞIP ulaşmadığıdır ve false ise applied da false döner — DOM'a yazılmış ama bileşenin duymadığı değer 'uygulandı' sayılmaz (G-14). Her adımdan sonra yerleşme beklenir ve yanıttaki actionsReport hedefin bulunup bulunmadığını ve adımdan sonra KAÇ AĞ İSTEĞİ çıktığını söyler — 'bağ kuruldu' ile 'çalışıyor' arasındaki farkı ancak bu ayırır (G-24)."),
             language: z.string().min(1).optional().describe("Kareyi BU DİLDE çeker: adrese '?lang=<kod>' eklenir ve runtime dili oradan seçer (öncelik: ?lang → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı). Seçim hem çeviriye bağlı prop'ları hem çok dilli alanların satır değerlerini kapsar, yani ikinci dilin karesi için sayfaya dil değiştirici KOYMAK GEREKMEZ — referans tasarımı bozulmadan ikinci dil kanıtlanır. ISO 639-1 iki harfli kod ('tr', 'en'); bölgeli kod ('tr-TR') indirgenir ve indirgeme yanıtta bildirilir. Kod projenin languages listesinde yoksa çağrı REDDEDİLİR: runtime tanımadığı kodu yok sayıp kareyi varsayılan dilde çizerdi ve 'çevrildi' sanılan yanlış bir kare raporlanırdı."),
             colorScheme: z.enum(['light', 'dark']).optional().describe("Kareyi açık ya da koyu temada çeker. Ziyaretçi tema tercihi çerezde değil localStorage'da yaşar ve tema store'u onu sayfa açılırken bir kez okur; gateway tercihi sayfa script'lerinden ÖNCE eker, bu yüzden sayfada 'theme-toggle' komponenti OLMASA DA koyu tema karesi alınabilir. Verilmezse projenin kendi modu çizilir."),
+            format: z.enum(['png', 'jpeg']).optional().describe("Kare biçimi; varsayılan 'png'. Doğrulama karesi için 'jpeg' + quality 60 bağlamı küçültür (ölçüldü 2026-09-16, aynı sayfa: scale 1'de png 8639 B / jpeg60 8691 B — kazanç yok; scale 0.5'te png 3603 B / jpeg60 3035 B). Asıl kaldıraç ÖLÇEKTİR; renk ve kenar keskinliğinin kendisi inceleniyorsa png'de kalın."),
+            quality: z.number().int().min(1).max(100).optional().describe("Yalnız format:'jpeg' ile: 1-100, doğrulama için 60 yeter. format 'png' iken verilirse çağrı reddedilir — PNG kayıpsızdır, kalite ayarı yoktur."),
+            scale: z.number().min(0.25).max(1).optional().describe("Karenin RASTER ölçeği (deviceScaleFactor); varsayılan 1. 0.5 verildiğinde sayfa yine 1280 CSS pikseli genişliğinde ÇİZİLİR ama kare 640 piksel çıkar: yerleşim, kırılım noktaları ve hideOn davranışı değişmez, yalnız görüntü küçülür. Dar ekran denemek için scale değil viewport kullanın. Yanıttaki imageSize ölçeğin gerçekten uygulandığını sayıyla gösterir."),
+            clip: z.union([
+                z.object({ element: z.string().min(1) }),
+                z.object({ x: z.number(), y: z.number(), width: z.number().positive(), height: z.number().positive() })
+            ]).optional().describe("Kareyi bir bölgeyle sınırlar: { element: '<elementId>' } o düğümün kutusunu, { x, y, width, height } elle verilen dikdörtgeni (CSS pikseli) kırpar — yan sütunu ya da tek kartı görmek için tüm sayfayı çekip elle kırpmaya gerek yok. Kutu katlanmış alanın altındaysa viewport onu kapsayana kadar BÜYÜTÜLÜR ve kutu yeniden okunur; düğüm yoksa ya da 0x0 çizildiyse çağrı boş kare yerine HATA döner."),
+            summary: z.union([z.enum(['compact', 'full']), z.literal(false)]).optional().describe("Sayfada NE GÖRÜNDÜĞÜNÜN metin özeti; varsayılan 'compact'. Her KÖK runtime düğümü için tek satır: kimlik (tip) · görünür|GİZLİ|ekran dışı · metnin ilk 80 karakteri · rows=<satır> · tab=<açık sekme> · value=<kutudaki değer> · BOŞ · errors=<sayı>; sonda toast ve hata sayfası mesajları. 'full' bunun yanına yapısal domSummary dizisini ve messages'ı koyar; false hiç toplamaz. 'Kart göründü mü, tablo doldu mu, hata var mı' sorularının cevabı buradadır — o sorular için KAREYE GEREK YOKTUR (image:'none' ile birlikte kullanın). Tip alanı runtime'ın data-component-type basmasına bağlıdır; basmıyorsa tipler yazılmaz ve summaryNote bunu söyler."),
+            diff: z.boolean().optional().describe("true: aynı sayfanın ÖNCEKİ çekimine göre ne değiştiğini döner (changes.added / removed / changed / messages) ve karenin bayt bayt aynı olup olmadığını söyler (imageUnchanged). Bellek gateway SÜRECİ içindedir: yeniden başlatılınca silinir ve ilk çağrı changes.firstCapture: true döner; sonraki çağrılar baselineAt taşır. Anahtar adres, kimlik, dil, tema, viewport, fullPage, actions, clip, scale ve biçimdir — asUser karesi gateway karesiyle karşılaştırılmaz."),
+            image: z.enum(['inline', 'none', 'ifChanged']).optional().describe("'none': kare HİÇ ÇEKİLMEZ, yanıt yalnız özet ve ölçümlerden oluşur — olgu doğrulamasının (kart göründü mü, tablo kaç satır) maliyeti bir kareden iki-üç kat küçüktür ve model bağlamına görüntü girmez. Varsayılan 'inline'. 'ifChanged': kare çekilir ama ÖNCEKİ çekimle bayt bayt aynıysa yanıta KONULMAZ (imageSkipped: true) — aynı sayfayı yeniden koştururken değişmemiş kareyi ikinci kez okumak bağlamın boşa gitmesidir; diff:true ima edilir. outPath ile 'none' birlikte verilemez (yazılacak kare üretilmiyor). Renk, hizalama, referansa sadakat gibi GÖRSEL sorular için kareyi açık bırakın."),
             outPath: z.string().min(1).optional().describe('Verilirse PNG bu yerel yola yazılır ve inline görüntü DÖNMEZ; yalnız özet (yol, boyut) döner — büyük fullPage kareleri için')
         },
         annotations: readOnly
-    }, async ({ project, environment, applicationSlug, pageSlug, viewport, fullPage, delayMs, captureUnready, anonymous, asUser, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme }) => {
+    }, async ({ project, environment, applicationSlug, pageSlug, viewport, fullPage, delayMs, captureUnready, anonymous, asUser, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme, summary, image, format, quality, scale, clip, diff }) => {
         try {
             if (anonymous === true && (asUser !== undefined || cookies !== undefined)) {
                 throw new PlatformApiError("page_screenshot: anonymous:true ile asUser/cookies birlikte verilemez — biri kimliksiz kareyi, diğeri belirli bir kimlikle çekilen kareyi ister. Anonim kare için yalnız anonymous:true, üye kimliğiyle kare için yalnız asUser (ve gerekiyorsa cookies) gönderin.");
             }
+            if (quality !== undefined && (format ?? 'png') === 'png') {
+                throw new PlatformApiError("page_screenshot: quality yalnız format:'jpeg' ile verilir — PNG kayıpsızdır ve kalite ayarı yoktur. Küçültmek için scale (yarı çözünürlük) ya da clip (bölge) kullanın.");
+            }
+            if (image === 'none' && outPath !== undefined) {
+                throw new PlatformApiError("page_screenshot: image:'none' ile outPath birlikte verilemez — biri kareyi hiç üretmemeyi, diğeri onu dosyaya yazmayı ister. Olgu doğrulaması için yalnız image:'none', kareyi diske almak için yalnız outPath gönderin.");
+            }
             const incompleteDrag = actions?.findIndex(step => step.action === 'drag' && (step.target === undefined || step.to === undefined)) ?? -1;
             if (incompleteDrag >= 0) {
                 throw new PlatformApiError(`page_screenshot: actions[${incompleteDrag}] 'drag' adımı hem target (sürüklenen öğe) hem to (bırakma hedefi) ister — ör. {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}.`);
@@ -514,11 +285,12 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             const size = viewport ?? { width: 1280, height: 800 };
             const extraCookies = Object.entries(cookies ?? {}).map(([name, value]) => ({ name, value }));
             const identity = anonymous === true ? 'anonymous' : asUser === undefined ? 'gateway' : 'asUser';
+            const identityToken = anonymous ? undefined : resolveIdentity(asUser) ?? await platform.accessToken();
             const cookieNames = [...new Set([...(identity === 'anonymous' ? [] : ['NG_AccessToken']), ...extraCookies.map(cookie => cookie.name)])];
             const shot = await screenshotter.capture({
                 url,
                 apiPathMarker: `/${applicationSlug}/p/${pageSlug}`,
-                token: anonymous ? undefined : resolveIdentity(asUser) ?? await platform.accessToken(),
+                token: identityToken,
                 ...(extraCookies.length > 0 ? { cookies: extraCookies } : {}),
                 cookieUrl: config.studioBaseUrl,
                 viewport: size,
@@ -527,8 +299,78 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 ...(captureUnready === true ? { captureUnready: true } : {}),
                 ...(layoutReport === true ? { layoutReport: true } : {}),
                 ...(colorScheme === undefined ? {} : { colorScheme }),
+                // B-2: `summary:false` + `diff` verildiğinde özet yine toplanır — fark ona dayanır ve
+                // toplanmazsa bellek hiç yazılmaz, `ifChanged` sessizce ölü bir özellik olurdu.
+                ...(summary === false && !(diff === true || image === 'ifChanged') ? { summary: false } : {}),
+                ...(image === 'none' ? { image: 'none' } : {}),
+                ...(format === undefined ? {} : { format }),
+                ...(quality === undefined ? {} : { quality }),
+                ...(scale === undefined ? {} : { scale }),
+                ...(clip === undefined ? {} : { clip: clip }),
                 ...(actions === undefined ? {} : { actions: actions })
             });
+            // Fark ÖZETTEN çıkar; `summary:false` verilse de fark için toplanmıştır (yanıta girmez).
+            // Anahtar KİMLİĞİ ayırır (K8): 'asUser' etiketi yetmez — iki farklı üyenin jetonu aynı
+            // etikete düşüyor ve A'nın sayfasıyla B'ninki karşılaştırılıyordu (B-3). Jeton ve çerez
+            // DEĞERLERİ anahtara girer; captureKey sha256'lar, ham değer dışarı sızmaz.
+            const wantsDiff = diff === true || image === 'ifChanged';
+            const memoryKey = captureKey({
+                url,
+                identity,
+                principal: identityToken,
+                cookieValues: extraCookies.map(cookie => `${cookie.name}=${cookie.value}`),
+                language: languageChoice?.code,
+                colorScheme,
+                viewport: size,
+                fullPage: fullPage === true,
+                actions,
+                clip,
+                scale,
+                format,
+                quality
+            });
+            const previous = wantsDiff ? captureMemory.recall(memoryKey) : undefined;
+            const currentHash = shot.png === undefined ? undefined : imageHash(shot.png);
+            const changes = !wantsDiff
+                ? undefined
+                : previous === undefined
+                    // `baselineAt: null` yanıt budamasında (responses.ts `prune`) düşüyordu: alan yok
+                    // oluyor, geriye yalnız not kalıyordu ve "ilk kare mi, alan mı eksik" ayırt edilemiyordu.
+                    ? { firstCapture: true }
+                    : {
+                        baselineAt: previous.at,
+                        ...(currentHash === undefined || previous.imageHash === undefined ? {} : { imageUnchanged: currentHash === previous.imageHash }),
+                        ...(shot.summary === undefined ? {} : diffSummaries(previous.summary, shot.summary))
+                    };
+            const imageUnchanged = changes !== undefined && 'imageUnchanged' in changes ? changes.imageUnchanged === true : false;
+            if (wantsDiff && shot.summary !== undefined) {
+                // `image:'none'` çağrısı hash üretmez; DOM hiç değişmediyse öncekini KORU, yoksa bir
+                // 'none' çağrısı aradaki taban çizgisini siliyor ve sonraki 'ifChanged' atlayamıyordu.
+                const unchangedDom = changes !== undefined && 'changed' in changes && changes.changed?.length === 0 && changes.added?.length === 0 && changes.removed?.length === 0;
+                const carried = currentHash ?? (unchangedDom ? previous?.imageHash : undefined);
+                captureMemory.remember(memoryKey, { at: new Date().toISOString(), ...(carried === undefined ? {} : { imageHash: carried }), summary: shot.summary });
+            }
+            // Notlar DİZİDE toplanır: hepsi aynı nesnede `actionsNote` anahtarını yazdığı için
+            // sonuncusu öncekileri eziyordu ve en sık durumda (sekme değişimi ağ isteği çıkarmaz)
+            // "sekme metinle eşlendi" uyarısı sessizce kayboluyordu (B-1).
+            const actionsOf = (match) => (shot.actions ?? []).filter(match);
+            const actionNotes = [];
+            const missing = actionsOf(outcome => !outcome.found);
+            const textMatchedTabs = actionsOf(outcome => outcome.action === 'tab' && outcome.matchedBy === 'text');
+            const emptyOptions = actionsOf(outcome => outcome.action === 'select' && outcome.optionsSeen === 0);
+            const unwritten = actionsOf(outcome => outcome.propWritten === false);
+            // 'wait' bir eylem değil bekleyiştir: akış sayacı ona bağlanmaz, notu tetiklemez (33/S-1).
+            const silent = actionsOf(outcome => outcome.action !== 'wait' && outcome.applied && outcome.requests === 0 && (outcome.flowRuns ?? 0) === 0);
+            if (missing.length > 0)
+                actionNotes.push(`Bulunamayan hedef var: ${missing.map(outcome => outcome.target ?? '?').join(' · ')}. elementId'leri page_schema_get ile doğrulayın; runtime düğümü data-element-id ile bulunuyor.`);
+            if (textMatchedTabs.length > 0)
+                actionNotes.push(`Sekme METİNLE eşlendi (runtime '<elementId>__tab-<sekme anahtarı>' kimliğini basmıyor): ${textMatchedTabs.map(outcome => `'${outcome.target ?? '?'}' → ${outcome.activeTab ?? '?'}`).join(' · ')}. Metin çeviriye bağlıdır; language verilen bir çekimde aynı adım kırılır.`);
+            if (emptyOptions.length > 0)
+                actionNotes.push(`Açılır kutuda hiç seçenek görülmedi: ${emptyOptions.map(outcome => `'${outcome.target ?? '?'}' (${outcome.waitedMs ?? '?'} ms beklendi)`).join(' · ')}. Adımın note alanı kutunun açılıp açılmadığını söyler: açıldıysa seçenekler bir sorgudan geliyor olabilir (query_preview), açılmadıysa kutu devre dışı ya da salt okunur olabilir.`);
+            if (unwritten.length > 0)
+                actionNotes.push(`Değer DOM'a yazıldı ama runtime prop'una ULAŞMADI: ${unwritten.map(outcome => `${outcome.action} '${outcome.target ?? '?'}'`).join(' · ')}. Kare dolu kutu gösterse de akış bu değeri okumaz — sonucu doğrulanmış saymayın; adımın note alanına bakın.`);
+            if (silent.length > 0)
+                actionNotes.push(`Uygulandı ama HİÇ AĞ İSTEĞİ çıkmadı ve HİÇBİR AKIŞ KOŞMADI: ${silent.map(outcome => `${outcome.action} '${outcome.target ?? '?'}'`).join(' · ')}. Sekme değiştirmek gibi saf istemci tarafı adımlarda bu BEKLENENDİR; veri bekleyen bir adımda olay bağı şemada görünse de akış koşmamış olabilir — bağı page_runtime_get, akış gövdesini flow_get ile doğrulayın.`);
             const meta = {
                 url,
                 environment: resolvedEnvironment,
@@ -539,8 +381,41 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 fullPage: fullPage === true,
                 identity,
                 cookieNames,
-                sizeBytes: shot.png.byteLength,
+                ...(shot.png === undefined
+                    ? { image: 'none' }
+                    : {
+                        sizeBytes: shot.png.byteLength,
+                        format: format ?? 'png',
+                        ...(scale === undefined ? {} : { scale }),
+                        ...(shot.imageSize === undefined ? {} : { imageSize: shot.imageSize }),
+                        ...(shot.clip === undefined ? {} : { clip: shot.clip })
+                    }),
+                ...(shot.clip !== undefined && (layoutReport === true || fullPage === true)
+                    ? { clipNote: 'clip yalnız GÖRÜNTÜYÜ keser: layoutSummary kutuları, summaryText satırları ve contentHeight sayfanın TAMAMI için ölçülür.' }
+                    : {}),
                 elapsedMs: shot.elapsedMs,
+                // S-5: yanıtın olgu katmanı. Kare açılmadan okunabilsin diye METİN olarak da döner.
+                ...(shot.summary === undefined || summary === false
+                    ? {}
+                    : {
+                        summaryText: summaryLines(shot.summary).join('\n'),
+                        summaryStats: summaryStats(shot.summary),
+                        ...(summary === 'full' ? { domSummary: shot.summary.nodes, messages: shot.summary.messages } : {}),
+                        ...(shot.summary.truncated ? { summaryTruncated: true, summaryTruncatedNote: 'Sayfada 300 kök düğümden fazlası var; özet ilk 300 düğümde kesildi. Daha dar bakmak için sayfayı bölerek doğrulayın.' } : {}),
+                        ...(shot.summary.typed ? {} : { summaryNote: "Runtime data-component-type basmıyor (eski runtime ya da frontend ayağı dağıtılmadı) — satırlarda komponent TİPİ yazılmadı; kimlik ve görünürlük yine doğrudur." })
+                    }),
+                ...(shot.summaryUnavailable === undefined ? {} : { summaryUnavailable: shot.summaryUnavailable }),
+                ...(changes === undefined
+                    ? {}
+                    : {
+                        changes,
+                        ...('firstCapture' in changes
+                            ? { changesNote: 'Bu adresin ilk karesi — karşılaştırılacak önceki çekim yok. Bellek gateway süreci içindedir ve yeniden başlatılınca silinir.' }
+                            : {}),
+                        ...('imageUnchanged' in changes && changes.imageUnchanged === false && 'changed' in changes && changes.changed?.length === 0 && changes.added?.length === 0 && changes.removed?.length === 0
+                            ? { changesNote: 'Kare bayt bayt değişti ama DOM özeti aynı: fark piksel düzeyinde (yazı tipi yerleşmesi, animasyon, imleç). Yapısal bir değişiklik yok.' }
+                            : {})
+                    }),
                 ...(shot.contentHeight === undefined ? {} : { contentHeight: shot.contentHeight }),
                 ...(shot.fullPageTruncated
                     ? { fullPageTruncated: true, note: `Sayfa içeriği ${shot.contentHeight} px — kare 16384 px'de kırpıldı. Alt kısmı görmek için viewport'u kaydırılmış bir bölüme odaklayın ya da sayfayı bölerek doğrulayın.` }
@@ -593,16 +468,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                         runtimeErrors: shot.runtimeErrors,
                         runtimeErrorsNote: `Sayfa akışı ${shot.runtimeErrors.length} yapısal hata bıraktı; kare 'çalışıyor' görünse bile bu adımlar işini YAPMADI. element/property alanı hangi komponentin hangi prop'unun yazılamadığını söyler — o komponent eski/boş değerindedir. Adımı flow_get ile açıp ifadeyi düzeltin.`
                     }),
-                ...(shot.actions?.some(outcome => !outcome.found)
-                    ? { actionsNote: `Bulunamayan hedef var: ${shot.actions.filter(outcome => !outcome.found).map(outcome => outcome.target ?? '?').join(' · ')}. elementId'leri page_schema_get ile doğrulayın; runtime düğümü data-element-id ile bulunuyor.` }
-                    : {}),
-                ...(shot.actions?.some(outcome => outcome.propWritten === false)
-                    ? { actionsNote: `Değer DOM'a yazıldı ama runtime prop'una ULAŞMADI: ${shot.actions.filter(outcome => outcome.propWritten === false).map(outcome => `${outcome.action} '${outcome.target ?? '?'}'`).join(' · ')}. Kare dolu kutu gösterse de akış bu değeri okumaz — sonucu doğrulanmış saymayın; adımın note alanına bakın.` }
-                    : {}),
-                // 'wait' bir eylem değil bekleyiştir: akış sayacı ona bağlanmaz, notu tetiklemez (33/S-1).
-                ...(shot.actions?.some(outcome => outcome.action !== 'wait' && outcome.applied && outcome.requests === 0 && (outcome.flowRuns ?? 0) === 0)
-                    ? { actionsNote: `Uygulandı ama HİÇ AĞ İSTEĞİ çıkmadı ve HİÇBİR AKIŞ KOŞMADI: ${shot.actions.filter(outcome => outcome.action !== 'wait' && outcome.applied && outcome.requests === 0 && (outcome.flowRuns ?? 0) === 0).map(outcome => `${outcome.action} '${outcome.target ?? '?'}'`).join(' · ')}. Olay bağı şemada görünse bile akış koşmamış olabilir — bağın gerçekten kurulu olduğunu page_runtime_get ile, akışın gövdesini flow_get ile doğrulayın.` }
-                    : {}),
+                ...(actionNotes.length === 0 ? {} : { actionsNote: actionNotes.join('\n') }),
                 ...(shot.layout === undefined
                     ? {}
                     : shot.layout.length === 0
@@ -617,6 +483,8 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 try {
                     // B-6: klasör yoksa ENOENT ile düşüyordu; koşu ajanı her seferinde klasörü elle açıyordu.
                     await mkdir(dirname(absolute), { recursive: true });
+                    if (shot.png === undefined)
+                        throw new PlatformApiError('page_screenshot: yazılacak kare üretilmedi (image kipi kareyi atladı) — outPath ile birlikte kare üreten bir kip kullanın.');
                     await writeFile(absolute, shot.png);
                 }
                 catch (error) {
@@ -625,12 +493,19 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 }
                 return toolResult({ path: absolute, ...meta }, config);
             }
+            // image:'none' — kare hiç üretilmedi; yanıt yalnız olgu katmanıdır.
+            if (shot.png === undefined)
+                return toolResult(meta, config);
+            // 'ifChanged' — kare çekildi ama öncekiyle AYNI: bağlama ikinci kez girmesin.
+            if (image === 'ifChanged' && imageUnchanged) {
+                return toolResult({ ...meta, imageSkipped: true, imageSkippedNote: 'Kare öncekiyle bayt bayt aynı olduğu için yanıta konulmadı (image: ifChanged). Yine de görmek için image varsayılanına dönün.' }, config);
+            }
             if (shot.png.byteLength > maxInlinePngBytes) {
-                throw new PlatformApiError(`Görüntü ${shot.png.byteLength} B — inline sınırı (${maxInlinePngBytes} B) aşıyor. outPath verin (dosyaya yazılır, model bağlamına girmez) ya da fullPage'i kapatıp viewport'u küçültün.`);
+                throw new PlatformApiError(`Görüntü ${shot.png.byteLength} B — inline sınırı (${maxInlinePngBytes} B) aşıyor. outPath verin (dosyaya yazılır, model bağlamına girmez), image:'none' ile yalnız özet alın ya da fullPage'i kapatıp viewport'u küçültün.`);
             }
             return {
                 content: [
-                    { type: 'image', data: shot.png.toString('base64'), mimeType: 'image/png' },
+                    { type: 'image', data: shot.png.toString('base64'), mimeType: shot.mimeType ?? 'image/png' },
                     { type: 'text', text: JSON.stringify(meta) }
                 ],
                 structuredContent: meta
@@ -642,7 +517,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
     });
     server.registerTool('page_schema_get', {
         title: 'Sayfa şemasını oku',
-        description: "Sayfanın komponent şemasını okur; yanıttaki updatedAt değeri page_schema_patch'in expectedUpdatedAt kontrolünde kullanılır.",
+        description: "Sayfanın komponent şemasını okur. Yanıttaki version değerini page_schema_patch'e baseVersion olarak verin: sayfa o okumadan beri değiştiyse yama 409 ile reddedilir ve hiçbir op uygulanmaz.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -655,17 +530,18 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
     }, handle(config, async ({ project, environment, applicationId, pageId, mode, componentId }) => {
         const page = await fetchPage(platform, project, environment, applicationId, pageId);
         const updatedAt = page.audit?.updatedAt ?? page.audit?.createdAt;
+        const version = page.version;
         if (mode === 'full')
-            return { updatedAt, schema: page.schema ?? [] };
+            return { version, updatedAt, schema: page.schema ?? [] };
         if (mode === 'subtree') {
             if (!componentId)
                 throw new PlatformApiError("mode='subtree' için componentId zorunludur.");
             const subtree = findNode(page.schema, componentId);
             if (!subtree)
                 throw new PlatformApiError(`Sayfada '${componentId}' id'li bir komponent yok; page_schema_get'i summary kipinde çağırıp hedefi doğrulayın.`);
-            return { updatedAt, schema: subtree };
+            return { version, updatedAt, schema: subtree };
         }
-        return { updatedAt, schema: (page.schema ?? []).map(node => summarize(node)) };
+        return { version, updatedAt, schema: (page.schema ?? []).map(node => summarize(node)) };
     }));
     server.registerTool('page_state', {
         title: 'Sayfa durumunu getir',
@@ -683,9 +559,9 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
         const propTypeIssues = setPropTypeErrors(allOps.filter(entry => entry.op === 'set_prop_type'));
         if (propTypeIssues.length > 0)
             throw new PlatformApiError(`set_prop_type gövdesi eksik (istek gönderilmedi): ${propTypeIssues.join(' · ')}`, 400);
-        // Gateway emülasyonu olan op'lar platformun doğrulama ucunu tanımadığı için gövdeden ayrılır;
-        // kuru koşu ile yazma AYNI kararı vermeli (P0-2 Step 3).
-        const opRecords = allOps.filter(entry => !['remove_event', 'resize_component', 'set_prop_type'].includes(String(entry.op)));
+        // Kuru koşu ile yazma AYNI gövdeyi görür (P0-2 Step 3): resize_component burada da sunucu
+        // op'larına çevrilir, platform dokunulan düğümleri aynı kapsamla doğrular.
+        const opRecords = allOps.filter(entry => entry.op !== 'resize_component');
         const normalized = normalizeSchemaOps(opRecords);
         const validationIssues = [
             ...schemaOpValidationErrors(opRecords).map(issue => `PAGE-016 — ${issue}`),
@@ -694,7 +570,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
         const ordering = await orderByIndex(opRecords, () => fetchPage(platform, project, environment, applicationId, pageId));
         const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
             environment,
-            body: { ops: ordering.ops }
+            body: { ops: [...allOps.filter(entry => entry.op === 'resize_component').flatMap(resizeServerOps), ...ordering.ops] }
         })) ?? {});
         if (validationIssues.length > 0)
             response.validationWarnings = validationIssues;
@@ -709,7 +585,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
     }));
     server.registerTool('page_schema_patch', {
         title: 'Sayfa şemasına patch uygula',
-        description: "Micro-op'ları doğrulama duvarından geçirip kaydeder; açık studio canvas'ları SignalR ile canlı güncellenir. expectedUpdatedAt verilirse sayfa o okumadan beri değişmişse istek reddedilir (stale plan koruması). Yanıttaki appliedPatch, her op'un şemada tam olarak hangi JSON Pointer'a dokunduğunu söyler; gövdesi VARSAYILAN OLARAK iskelettir (eklenen düğüm id/type/children'a iner) — tam gövde için view:'full'. Op'un gerçekten kaydedilip kaydedilmediğini gövde değil silentlyDropped söyler. Gateway ön kontrolleri (PAGE-006/008/016/032, set_prop_type gövdesi, move_component size) op başına toplanır: düşen HER op tek hata yanıtında rejectedOps[] ({ index, op, target, code, message }) ile listelenir ve yama atomik olduğu için hiçbir op gönderilmez — hepsini düzeltip listeyi bir kez yeniden gönderin.",
+        description: "Micro-op'ları doğrulama duvarından geçirip TEK PATCH ile kaydeder; açık studio canvas'ları SignalR ile canlı güncellenir. İstek atomiktir: bir op reddedilirse hiçbiri yazılmaz. baseVersion (page_schema_get çıktısındaki version ya da önceki yamanın newVersion'ı) verilirse sayfa o sürümden beri değişmişse 409 döner ve hiçbir op uygulanmaz (stale plan koruması); verilmezse gateway yalnız bu çağrıda zaten okuduğu sayfanın sürümünü gönderir. Yanıttaki appliedPatch, her op'un şemada tam olarak hangi JSON Pointer'a dokunduğunu söyler; gövdesi VARSAYILAN OLARAK iskelettir (eklenen düğüm id/type/children'a iner) — tam gövde için view:'full'. Op'un gerçekten kaydedilip kaydedilmediğini gövde değil silentlyDropped söyler. Gateway ön kontrolleri (PAGE-006/008/016/032, set_prop_type gövdesi, move_component size) op başına toplanır: düşen HER op tek hata yanıtında rejectedOps[] ({ index, op, target, code, message }) ile listelenir ve hiçbir op gönderilmez — hepsini düzeltip listeyi bir kez yeniden gönderin.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -717,12 +593,13 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             pageId: guid,
             ops: opsParam.optional(),
             operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı) — entity/microservice/workflow patch'leriyle aynı adı kullanabilmeniz için"),
-            expectedUpdatedAt: z.string().optional().describe("page_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz"),
+            baseVersion: z.string().optional().describe("page_schema_get çıktısındaki version ya da önceki page_schema_patch yanıtındaki newVersion; sayfa o sürümden beri değiştiyse 409 döner ve hiçbir op uygulanmaz"),
+            expectedUpdatedAt: z.string().optional().describe("Eski koruma: page_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz. baseVersion tercih edilir"),
             allowFlowDeletion: z.boolean().optional().describe("true: bu yama bir akışı referanssız bırakacaksa yine de uygulanır. Varsayılan false — platform referanssız akışı KALICI siler ve gateway isteği önden reddeder (G-21). Silinen akışlar yanıtta deletedFlows ile listelenir."),
             view: writeViewParam
         },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion, view }) => {
+    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, baseVersion, expectedUpdatedAt, allowFlowDeletion, view }) => {
         const allOps = microOps('page_schema_patch', ops, operations).map(op => op);
         const removeEventOps = allOps.filter(entry => entry.op === 'remove_event');
         const resizeOps = allOps.filter(entry => entry.op === 'resize_component');
@@ -787,7 +664,9 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
         // Akış silen op'lar yamadan ÖNCE hesaplanır: uyarı sonradan geldiğinde akış zaten kalıcı
         // silinmiş oluyordu ve "önce yedekle" tavsiyesi uygulanamıyordu (09-05 koşusu, G-21).
         let deletedFlows = [];
-        if (opRecords.some(entry => ['remove_component', 'set_event', 'remove_event'].includes(String(entry.op)))) {
+        // remove_event opRecords'ta değil, ayrı listede durur; koşul yalnız opRecords'a baktığı sürece
+        // yalnız olay kaldıran bir yama bu korumayı hiç tetiklemiyordu (2026-09-14).
+        if ([...opRecords, ...removeEventOps].some(entry => ['remove_component', 'set_event', 'remove_event'].includes(String(entry.op)))) {
             try {
                 const page = await readPage();
                 deletedFlows = orphanedFlowPlan(page.schema, page.events, [...opRecords, ...removeEventOps]);
@@ -854,31 +733,25 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
         }
         if (nestedAfterOps.length > 0)
             throw new PlatformApiError(nestedRepeaterMessage(nestedAfterOps), 400);
-        const removedEvents = removeEventOps.length > 0
-            ? await applyEventRemovals(platform, project, environment, applicationId, pageId, await readPage(), removeEventOps)
-            : [];
-        if (removeEventOps.length > 0)
-            cachedPage = undefined;
-        const resized = resizeOps.length > 0
-            ? await applyResizes(platform, project, environment, applicationId, pageId, await readPage(), resizeOps)
-            : { applied: [], warnings: [] };
-        if (resizeOps.length > 0)
-            cachedPage = undefined;
-        const propTypes = propTypeOps.length > 0
-            ? await applyPropTypes(platform, project, environment, applicationId, pageId, await readPage(), propTypeOps)
-            : [];
-        if (propTypeOps.length > 0)
-            cachedPage = undefined;
+        const removedEvents = planEventRemovals(removeEventOps);
+        const resized = resizeOps.length > 0 ? planResizes((await readPage()).schema ?? [], resizeOps) : { serverOps: [], applied: [], warnings: [] };
+        const propTypes = propTypeOps.length > 0 ? planPropTypes((await readPage()).schema ?? [], propTypeOps) : { serverOps: [], applied: [] };
+        const serverOps = [...removeEventOps, ...resized.serverOps, ...propTypes.serverOps, ...sentOps];
         layoutWarnings = [...ordering.warnings, ...layoutWarnings];
-        const response = sentOps.length > 0
-            ? ((await platform.tenant('PATCH', project, `/pages/${applicationId}/${pageId}/schema`, { environment, body: { ops: sentOps } })) ?? {})
-            : { valid: true };
+        // Tek istek, tek sürüm: öykünülen op'lar 2026-09-14'e kadar ayrı GET + tam PUT çiftleriydi ve
+        // yamadan ÖNCE yazılıyordu — PATCH reddedilse bile kalıcıydılar. Artık hepsi aynı atomik PATCH'te.
+        // baseVersion yalnız biliniyorsa gider (ajanın verdiği ya da bu çağrıda zaten okunan sayfanınki):
+        // sürümü öğrenmek için ayrı GET atılmaz, platform satırı her yamada kilitler.
+        const response = ((await platform.tenant('PATCH', project, `/pages/${applicationId}/${pageId}/schema`, {
+            environment,
+            body: { ops: serverOps, baseVersion: baseVersion ?? (typeof cachedPage?.version === 'string' ? cachedPage.version : undefined) }
+        })) ?? {});
         if (view !== 'full')
             outlineWriteResponse(response);
         if (removedEvents.length > 0)
             response.removedEvents = removedEvents;
-        if (propTypes.length > 0)
-            response.propTypes = propTypes;
+        if (propTypes.applied.length > 0)
+            response.propTypes = propTypes.applied;
         if (resized.applied.length > 0)
             response.resized = resized.applied;
         if (resized.warnings.length > 0)