@appaflytech/zeyrek-ai-mcp 0.0.7 → 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, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, isFlexContainer, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, 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,
@@ -36,261 +39,35 @@ function runtimeFunctions(value) {
     }));
 }
 /**
- * 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`).
+ * 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ış.
  */
-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} | 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}} | 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) | 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 gönderilen ham değeri HER ZAMAN static Prop'una sarar ve sarmalanmış Prop nesnesini reddeder — kurulu bir etiketi çeviriye bağlamanın tek yolu düğümü remove_component + add_component ile yeniden kurmaktı ve o yol düğüme yazan setter iteratee'lerini sessizce öldürüyordu. 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.`];
-    });
-}
-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);
+async function orderByIndex(ops, readPage) {
+    if (!ops.some(entry => (entry.op === 'add_component' || entry.op === 'move_component') && typeof entry.index === 'number')) {
+        return { ops, moved: [], warnings: [] };
     }
-}
-function removeNodeFromTree(nodes, target) {
-    for (let index = 0; index < nodes.length; index++) {
-        if (nodes[index].elementId === target)
-            return nodes.splice(index, 1)[0];
-        const found = removeNodeFromTree(nodes[index].children ?? [], target);
-        if (found)
-            return found;
+    try {
+        return flexIndexOrder((await readPage()).schema, ops);
     }
-    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şı ve verilen position'ı desktop block'una yaz) ve analiz
- * yalnız dokunulan kapsayıcılarda koşar.
- */
-function simulateLayoutOps(schema, ops) {
-    const touched = new Set();
-    const attach = (node, requestedParent) => {
-        const parentId = typeof requestedParent === 'string' && requestedParent !== '' && requestedParent !== 'root'
-            ? requestedParent
-            : PAGE_CONTAINER_ELEMENT_ID;
-        const parent = findNode(schema, parentId);
-        if (parent) {
-            parent.children = [...(parent.children ?? []), node];
-            touched.add(String(parent.elementId ?? parentId));
-        }
-        else {
-            schema.push(node);
-            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);
-        }
-        // 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 ?? ''));
-            if (target)
-                target.props = { ...(target.props ?? {}), [String(op.prop)]: { 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, op.position);
-            attach(moved, op.parent);
-        }
+    catch {
+        return { ops, moved: [], warnings: [] };
     }
-    return touched;
 }
 async function fetchPage(platform, project, environment, applicationId, pageId) {
     const response = await platform.tenant('GET', project, `/pages/${applicationId}/${pageId}`, { environment });
     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.
- */
-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.
+ * 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.
  */
-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. */
@@ -401,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',
@@ -429,21 +217,42 @@ 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']),
-                target: z.string().min(1).optional().describe("Hedefin elementId'si (page_schema_get); runtime düğümü data-element-id ile bulunur"),
-                value: z.unknown().optional().describe("'set' için yazılacak değer"),
+                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'. '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'}]. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez). 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'}.`);
+            }
             if (!config.studioBaseUrl) {
                 throw new PlatformApiError("page_screenshot için STUDIO_BASE_URL tanımlı değil. Studio arayüzünün kök adresini .env'e ekleyin (yerel geliştirmede http://localhost:3000, dağıtımda nginx adresi).");
             }
@@ -476,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,
@@ -489,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,
@@ -501,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.` }
@@ -555,13 +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.` }
-                    : {}),
-                // '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
@@ -576,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) {
@@ -584,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
@@ -601,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,
@@ -614,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',
@@ -642,26 +559,33 @@ 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);
+        const validationIssues = [
+            ...schemaOpValidationErrors(opRecords).map(issue => `PAGE-016 — ${issue}`),
+            ...codePropTemplateErrors(opRecords).map(issue => `PAGE-032 — ${issue}`)
+        ];
+        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: opRecords }
+            body: { ops: [...allOps.filter(entry => entry.op === 'resize_component').flatMap(resizeServerOps), ...ordering.ops] }
         })) ?? {});
         if (validationIssues.length > 0)
-            response.validationWarnings = validationIssues.map(issue => `PAGE-016 — ${issue}`);
+            response.validationWarnings = validationIssues;
+        if (ordering.warnings.length > 0)
+            response.layoutWarnings = ordering.warnings;
         return withNormalization(response, [
             ...componentDefaultsNote(normalized.components),
             ...validationNote(normalized.validations),
-            ...replacePropNote(normalized.props)
+            ...replacePropNote(normalized.props),
+            ...flexIndexOrderNote(ordering.moved)
         ]);
     }));
     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.",
+        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,
@@ -669,28 +593,31 @@ 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');
         const propTypeOps = allOps.filter(entry => entry.op === 'set_prop_type');
         const opRecords = allOps.filter(entry => !['remove_event', 'resize_component', 'set_prop_type'].includes(String(entry.op)));
-        const propTypeIssues = setPropTypeErrors(propTypeOps);
-        if (propTypeIssues.length > 0)
-            throw new PlatformApiError(`set_prop_type gövdesi eksik (istek gönderilmedi): ${propTypeIssues.join(' · ')}`, 400);
-        const containerOps = opRecords
-            .filter(entry => (entry.op === 'remove_component' || entry.op === 'move_component') && entry.target === PAGE_CONTAINER_ELEMENT_ID);
-        const sizedMoves = opRecords.filter(entry => entry.op === 'move_component' && entry.size !== undefined);
-        if (sizedMoves.length > 0) {
-            throw new PlatformApiError(`move_component yalnız 'position' uygular; gövdeye konan 'size' platformda SESSİZCE düşer (ölçüldü 2026-09-04, appliedPatch'te yalnız /blocks/0/position görünür). Boyut için resize_component kullanın: { op: 'resize_component', target: '<elementId>', size: { w, h } } — flex kapsayıcı içindeyse 'appearance'. Etkilenen hedefler: ${sizedMoves.map(entry => entry.target).join(' · ')}`, 400);
+        const rejected = [];
+        const reject = (code, entry, messages) => {
+            for (const message of messages) {
+                rejected.push({ index: allOps.indexOf(entry), op: String(entry.op ?? ''), target: typeof entry.target === 'string' ? entry.target : null, code, message });
+            }
+        };
+        for (const entry of propTypeOps)
+            reject('SET-PROP-TYPE', entry, setPropTypeErrors([entry]));
+        for (const entry of opRecords.filter(record => record.op === 'move_component' && record.size !== undefined)) {
+            reject('MOVE-SIZE', entry, ["move_component yalnız 'position' uygular; gövdeye konan 'size' platformda SESSİZCE düşer (ölçüldü 2026-09-04, appliedPatch'te yalnız /blocks/0/position görünür). Boyut için resize_component kullanın: { op: 'resize_component', target: '<elementId>', size: { w, h } } — flex kapsayıcı içindeyse 'appearance'."]);
         }
-        if (containerOps.length > 0) {
-            throw new PlatformApiError(`'${PAGE_CONTAINER_ELEMENT_ID}' sayfanın kök kapsayıcısıdır; silinmez ve taşınmaz (PAGE-006) — silinirse sayfa iskeleti bozulur ve Studio komponentleri kapsayıcı dışında bırakır. Komponent kaldırmak için remove_component'i kapsayıcının İÇİNDEKİ elementId'lerle kullanın (page_schema_get ile listeleyin).`, 400);
+        for (const entry of opRecords.filter(record => (record.op === 'remove_component' || record.op === 'move_component') && record.target === PAGE_CONTAINER_ELEMENT_ID)) {
+            reject('PAGE-006', entry, [`'${PAGE_CONTAINER_ELEMENT_ID}' sayfanın kök kapsayıcısıdır; silinmez ve taşınmaz — silinirse sayfa iskeleti bozulur ve Studio komponentleri kapsayıcı dışında bırakır. Komponent kaldırmak için remove_component'i kapsayıcının İÇİNDEKİ elementId'lerle kullanın (page_schema_get ile listeleyin).`]);
         }
         let cachedPage;
         const readPage = async () => {
@@ -705,19 +632,10 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             }
         }
         const normalized = normalizeSchemaOps(opRecords);
-        const validationIssues = schemaOpValidationErrors(opRecords);
-        if (validationIssues.length > 0) {
-            throw new PlatformApiError(`PAGE-016 — validation gövdesi eksik (istek gönderilmedi): ${validationIssues.join(' · ')}. `
-                + "Çalışan biçim 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 }.", 400);
-        }
-        const wantsRootAdd = opRecords.some(entry => entry.op === 'add_component' && (entry.parent === undefined || entry.parent === null || entry.parent === 'root'));
-        let retargeted = [];
-        if (wantsRootAdd) {
-            const page = await readPage();
-            if ((page.schema ?? []).some(node => node.elementId === PAGE_CONTAINER_ELEMENT_ID)) {
-                retargeted = retargetRootAdds(opRecords, PAGE_CONTAINER_ELEMENT_ID);
-            }
-        }
+        for (const entry of opRecords)
+            reject('PAGE-016', entry, schemaOpValidationErrors([entry]));
+        for (const entry of opRecords)
+            reject('PAGE-032', entry, codePropTemplateErrors([entry]));
         if (opRecords.some(entry => entry.op === 'set_event')) {
             const typesByElementId = new Map();
             try {
@@ -728,14 +646,27 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             }
             collectTypes(opRecords.map(entry => entry.component).filter(Boolean), typesByElementId);
             const eventsBySlug = await fetchComponentEventNames(platform, project, environment, applicationId).catch(() => new Map());
-            const unknown = unknownEventOps(opRecords, typesByElementId, eventsBySlug);
-            if (unknown.length > 0)
-                throw new PlatformApiError(`PAGE-008 — geçersiz olay adı (istek gönderilmedi): ${unknown.join(' · ')}`, 400);
+            for (const entry of opRecords)
+                reject('PAGE-008', entry, unknownEventOps([entry], typesByElementId, eventsBySlug));
+        }
+        if (rejected.length > 0)
+            throw new PlatformApiError(rejectedOpsMessage(rejected), 400);
+        const wantsRootAdd = opRecords.some(entry => entry.op === 'add_component' && (entry.parent === undefined || entry.parent === null || entry.parent === 'root'));
+        let retargeted = [];
+        if (wantsRootAdd) {
+            const page = await readPage();
+            if ((page.schema ?? []).some(node => node.elementId === PAGE_CONTAINER_ELEMENT_ID)) {
+                retargeted = retargetRootAdds(opRecords, PAGE_CONTAINER_ELEMENT_ID);
+            }
         }
+        const ordering = await orderByIndex(opRecords, readPage);
+        const sentOps = ordering.ops;
         // 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]);
@@ -755,6 +686,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
         const formWarnings = [...formBindingWarnings(opRecords), ...formSubmitButtonWarnings(opRecords)];
         let flowWarnings = [];
         let layoutWarnings = [];
+        let flowsBeforePatch;
         if (opRecords.some(entry => entry.op === 'remove_component')) {
             try {
                 const page = await readPage();
@@ -768,7 +700,8 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             try {
                 const hosted = await platform.tenant('GET', project, flowPath('page', applicationId, pageId), { environment });
                 const page = await readPage();
-                flowWarnings = [...flowWarnings, ...staleSetterWarnings(hosted?.data ?? [], opRecords, page.schema)];
+                flowsBeforePatch = hosted?.data ?? [];
+                flowWarnings = [...flowWarnings, ...staleSetterWarnings(flowsBeforePatch, opRecords, page.schema)];
             }
             catch {
                 // akış listesi okunamadı
@@ -781,7 +714,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             try {
                 const page = await readPage();
                 const simulated = JSON.parse(JSON.stringify(page.schema ?? []));
-                const touched = simulateLayoutOps(simulated, opRecords);
+                const touched = simulateLayoutOps(simulated, sentOps);
                 // PAGE-013 op'lar UYGULANDIKTAN SONRAKİ ağaca bakar: tek başına eklenen düğüm masum
                 // görünür, iç içeliği ancak hedef parent zinciri belli olunca anlarsın.
                 nestedAfterOps = nestedRepeaterNodes(simulated);
@@ -790,7 +723,8 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                     ...verticalGapWarnings(simulated, 'PAGE-010 (uyarı)', touched),
                     ...stringStyleWarning(stringStyleNodes(simulated)),
                     ...inertFlexPropWarning(inertFlexPropNodes(simulated)),
-                    ...flexSizeWarnings(simulated, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)')
+                    ...flexSizeWarnings(simulated, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'),
+                    ...spacingLayerWarnings(simulated, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')
                 ];
             }
             catch {
@@ -799,30 +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 response = opRecords.length > 0
-            ? ((await platform.tenant('PATCH', project, `/pages/${applicationId}/${pageId}/schema`, { environment, body: { ops: opRecords } })) ?? {})
-            : { valid: true };
+        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];
+        // 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)
@@ -833,12 +762,25 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             response.formWarnings = formWarnings;
         if (flowWarnings.length > 0)
             response.flowWarnings = flowWarnings;
+        // FLOW-018 yazma sonrası (G-04): uyarı yamadan önce "kopabilir" der; kopup kopmadığını ancak
+        // akışları yeniden okumak söyler. Okuma başarısız olursa yama yine geçerlidir.
+        if (flowsBeforePatch && flowWarnings.length > 0 && opRecords.some(entry => entry.op === 'add_component')) {
+            try {
+                const hosted = await platform.tenant('GET', project, flowPath('page', applicationId, pageId), { environment });
+                const lost = lostSetterTargets(flowsBeforePatch, hosted?.data ?? [], opRecords);
+                if (lost.length > 0)
+                    response.flowTargetsLost = lost;
+            }
+            catch {
+                // akış listesi yeniden okunamadı
+            }
+        }
         if (layoutWarnings.length > 0)
             response.layoutWarnings = layoutWarnings;
         // G-23 micro-op ayağı: yama 200 döner ve `appliedPatch` op'un ŞEMAYA yazıldığını söyler, ama
         // alanın gerçekten KAYDEDİLDİĞİNİ söylemez. Yamadan sonra şemayı bir kez okuyup op'un yazmak
         // istediğiyle kayıtlı olanı karşılaştırıyoruz. Okuma başarısız olursa yama yine geçerlidir.
-        const contentOps = opRecords.filter(entry => entry.op === 'add_component' || entry.op === 'replace_prop');
+        const contentOps = sentOps.filter(entry => entry.op === 'add_component' || entry.op === 'replace_prop');
         let opDrops = [];
         if (contentOps.length > 0) {
             try {
@@ -854,7 +796,8 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             ...componentDefaultsNote(normalized.components),
             ...validationNote(normalized.validations),
             ...catalogNotes,
-            ...replacePropNote(normalized.props)
+            ...replacePropNote(normalized.props),
+            ...flexIndexOrderNote(ordering.moved)
         ]), opDrops);
     }));
     server.registerTool('page_create', {
@@ -914,7 +857,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             saved.schema = saved.schema.map(node => summarize(node));
         }
         const normalized = withWriteDiff(withNormalization(response, [...container.fixes, ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]), drops);
-        const createWarnings = [...gaps, ...stringStyleWarning(stringStyles), ...inertFlexPropWarning(inertFlexPropNodes(container.schema)), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)')];
+        const createWarnings = [...gaps, ...stringStyleWarning(stringStyles), ...inertFlexPropWarning(inertFlexPropNodes(container.schema)), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')];
         if (createWarnings.length === 0 || !normalized || typeof normalized !== 'object')
             return normalized;
         return { ...normalized, layoutWarnings: createWarnings };
@@ -948,7 +891,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
         const moved = overrides.schema === undefined ? [] : reorderSchemaBlocks(overrides.schema);
         const gaps = overrides.schema === undefined
             ? []
-            : [...verticalGapWarnings(overrides.schema, 'PAGE-010 (uyarı)'), ...inertFlexPropWarning(inertFlexPropNodes(overrides.schema)), ...flexSizeWarnings(overrides.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)')];
+            : [...verticalGapWarnings(overrides.schema, 'PAGE-010 (uyarı)'), ...inertFlexPropWarning(inertFlexPropNodes(overrides.schema)), ...flexSizeWarnings(overrides.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(overrides.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')];
         const body = pageUpdateBody(current, overrides);
         await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
         const summary = {