@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.8

package/dist/tools/pages.js

@@ -1,5 +1,6 @@
-import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive, microOps } 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, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
+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 { functionSignature } from '../knowledge/functionGuards.js';
 import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, outlineAppliedPatch, findNode, flowPath } from './screens.js';
 import { fetchComponentEventNames } from './components.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
@@ -9,11 +10,31 @@ import { PlatformApiError } from '../platform/errors.js';
 import { handle, toolResult, toolError } from '../platform/responses.js';
 import { StudioScreenshotter } from '../platform/screenshot.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 { z } from 'zod';
+/**
+ * Runtime paketindeki `appFunctions`/`pageFunctions` (UiFunctionRuntimeDto: id, name, parameters,
+ * body, isAsync) — imza taşınır, GÖVDE TAŞINMAZ (MAX_RESPONSE_BYTES). Ajan Functions.<ad>(…)
+ * yazarken adı ve parametre sırasını buradan alır (G-06).
+ */
+function runtimeFunctions(value) {
+    return (Array.isArray(value) ? value : [])
+        .filter((entry) => Boolean(entry) && typeof entry === 'object')
+        .map(entry => ({
+        id: entry.id,
+        name: entry.name,
+        signature: functionSignature(entry),
+        isAsync: entry.isAsync === true,
+        parameters: (Array.isArray(entry.parameters) ? entry.parameters : [])
+            .filter((parameter) => Boolean(parameter) && typeof parameter === 'object')
+            .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
@@ -30,7 +51,7 @@ function outlineWriteResponse(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.");
+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
@@ -51,6 +72,20 @@ function unknownEventOps(ops, typesByElementId, eventsBySlug) {
         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')
@@ -58,11 +93,11 @@ function collectTypes(nodes, into) {
         collectTypes(node.children, into);
     }
 }
-function removeNodeFromTree(nodes, target) {
+function removeNodeFromTree(nodes, target, parent) {
     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);
+            return { node: nodes.splice(index, 1)[0], parent };
+        const found = removeNodeFromTree(nodes[index].children ?? [], target, nodes[index]);
         if (found)
             return found;
     }
@@ -78,48 +113,67 @@ function setDesktopPosition(node, position) {
  * 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
+ * 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) => {
+    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 = [...(parent.children ?? []), node];
+            parent.children = siblings;
             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);
+            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)]: { type: 'static', ref: null, data: op.value } };
+                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, op.position);
-            attach(moved, op.parent);
+                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ış.
+ */
+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: [] };
+    }
+    try {
+        return flexIndexOrder((await readPage()).schema, ops);
+    }
+    catch {
+        return { ops, moved: [], warnings: [] };
+    }
+}
 async function fetchPage(platform, project, environment, applicationId, pageId) {
     const response = await platform.tenant('GET', project, `/pages/${applicationId}/${pageId}`, { environment });
     return response?.data ?? {};
@@ -324,7 +378,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
     }));
     server.registerTool('page_runtime_get', {
         title: 'Sayfanın runtime çıktısını getir',
-        description: "Çıkan uygulamanın sayfa için aldığı GERÇEK paketi döner (GET /{project}/{application}/p/{slug} — sayfanın ham serve yolu budur; Studio preview ve runtime aynı ucu tüketir): sayfa şeması + layout views'ü + sayfa olayları + flow'lar + değişken anahtarları. Kurduğun sayfanın SON hâlini doğrulamanın yolu budur (layout-slot yerleşimi dahil — Kural 1f). DİKKAT: sayfaya bağlı middleware'ler bu çağrıda GERÇEKTEN koşar; middleware reddederse yanıt middlewareBlocked ile döner — korumalı sayfada bu beklenen davranıştır ve kendisi bir doğrulamadır.",
+        description: "Çıkan uygulamanın sayfa için aldığı GERÇEK paketi döner (GET /{project}/{application}/p/{slug} — sayfanın ham serve yolu budur; Studio preview ve runtime aynı ucu tüketir): sayfa şeması + layout views'ü + sayfa olayları + flow'lar + değişken anahtarları (variableKeys: middleware değişkenleri, pageVariableKeys/appVariableKeys: state.page/state.app anahtarları) + kullanıcı fonksiyonu imzaları (appFunctions/pageFunctions — bir ifadeye Functions.<ad>(…) yazmadan önce adı ve parametre sırasını buradan alın; gövde taşınmaz, function_get ile okunur). Kurduğun sayfanın SON hâlini doğrulamanın yolu budur (layout-slot yerleşimi dahil — Kural 1f). DİKKAT: sayfaya bağlı middleware'ler bu çağrıda GERÇEKTEN koşar; middleware reddederse yanıt middlewareBlocked ile döner — korumalı sayfada bu beklenen davranıştır ve kendisi bir doğrulamadır.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -375,6 +429,10 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             widgets: named(body.widgets),
             flows: named(body.flows),
             variableKeys: Object.keys((body.variables ?? {})),
+            pageVariableKeys: parseVariableEntries(body.pageVariables).map(entry => entry.key),
+            appVariableKeys: parseVariableEntries(body.appVariables).map(entry => entry.key),
+            appFunctions: runtimeFunctions(body.appFunctions),
+            pageFunctions: runtimeFunctions(body.pageFunctions),
             hasTheme: Boolean(body.project?.theme),
             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."
@@ -385,7 +443,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
     const maxInlinePngBytes = 5 * 1024 * 1024;
     server.registerTool('page_screenshot', {
         title: 'Sayfanın ekran görüntüsünü al',
-        description: "Studio arayüzünün runtime render rotasını (/dev ya da /view) headless Chromium'da açar ve sayfanın PNG ekran görüntüsünü inline görüntü olarak döner — kurduğun sayfayı GÖZLE doğrulamanın yolu budur (page_runtime_get paketi verir, bu tool ekranda ne ÇİZİLDİĞİNİ gösterir). Sayfaya bağlı middleware'ler gerçekten koşar; reddedilirse yanıtta middlewareBlocked işaretlenir ve Studio'nun çizdiği hata durumu karesi döner — bu da bir doğrulamadır. YÜKLENMEMİŞ SAYFA ASLA ÇEKİLMEZ: kare, runtime çizilip mount akışları bitince alınır (yanıtta pageState + readyAfterMs); bütçe dolduğunda sayfa hâlâ iskelette ya da akış koşuyorsa çağrı ne görüldüğünü söyleyen bir hatayla döner, boş/yarım kare dönmez. Sayfa akışı bir adımda düşerse (patlayan ifade, hata dönen uç) yanıt runtimeErrors taşır ve hangi komponentin hangi prop'unun YAZILMADIĞINI söyler — kare 'çalışıyor' görünürken sessizce boş kalan komponenti ancak bu yakalar. STUDIO_BASE_URL tanımlı olmalı; ilk kullanım için `npx playwright-core install chromium` gerekir.",
+        description: "Studio arayüzünün runtime render rotasını (/dev ya da /view) headless Chromium'da açar ve sayfanın PNG ekran görüntüsünü inline görüntü olarak döner — kurduğun sayfayı GÖZLE doğrulamanın yolu budur (page_runtime_get paketi verir, bu tool ekranda ne ÇİZİLDİĞİNİ gösterir). Sayfaya bağlı middleware'ler gerçekten koşar; reddedilirse yanıtta middlewareBlocked işaretlenir ve Studio'nun çizdiği hata durumu karesi döner — bu da bir doğrulamadır. YÜKLENMEMİŞ SAYFA ASLA ÇEKİLMEZ: kare, runtime çizilip mount akışları bitince alınır (yanıtta pageState + readyAfterMs); bütçe dolduğunda sayfa hâlâ iskelette ya da akış koşuyorsa çağrı ne görüldüğünü söyleyen bir hatayla döner, boş/yarım kare dönmez. Sayfa akışı bir adımda düşerse (patlayan ifade, hata dönen uç) yanıt runtimeErrors taşır ve hangi komponentin hangi prop'unun YAZILMADIĞINI söyler — kare 'çalışıyor' görünürken sessizce boş kalan komponenti ancak bu yakalar. Kare DİLİ ve TEMASI seçilebilir: 'language' adrese ?lang ekler (çeviriye bağlı prop'lar da çok dilli alanların satır değerleri de o dilde çözülür), 'colorScheme' ziyaretçinin tema tercihini sayfa açılmadan eker — ikisi de sayfaya dil değiştirici ya da theme-toggle koymayı GEREKTİRMEZ, yani referansa sadık bir tasarımın ikinci dili ve koyu teması bozulmadan kanıtlanır. STUDIO_BASE_URL tanımlı olmalı; ilk kullanım için `npx playwright-core install chromium` gerekir. DAL ORTAMI DA GÖRÜNTÜLENİR (2026-09-09'dan beri): 'development' /dev, 'production' /view, dal ise /branch/{dal} şeridinden açılır ve sayfanın BÜTÜN istekleri (şema da akışlar da) o dala gider — dalda kurulan sayfa artık merge'i beklemeden gözle doğrulanır (platform_guide('merge') §Dalda görsel doğrulama).",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -404,28 +462,55 @@ 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']),
+                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')"),
+                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'"),
                 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:'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)."),
+            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."),
             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 }) => {
+    }, async ({ project, environment, applicationSlug, pageSlug, viewport, fullPage, delayMs, captureUnready, anonymous, asUser, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme }) => {
         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.");
             }
+            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).");
             }
             const resolvedEnvironment = platform.resolveEnvironment(environment);
-            const lane = resolvedEnvironment === 'development' ? 'dev' : resolvedEnvironment === 'production' ? 'view' : undefined;
+            // U-04 (2026-09-09): kısıt önce gateway'de DEĞİL Studio'da olduğu için reddediliyordu —
+            // runtime rotası dal adı taşımıyor, ortamı modül içi bir store belirliyordu ve dal adıyla
+            // istenen kare development'ı gösterirdi. Studio artık `/branch/{env}/…` şeridini tanıyor ve
+            // ortamı URL'den okuyor (f-02); dal karesi bu yüzden GERÇEKTEN o dalın karesi. Geriye yalnız
+            // platformun dal diye kabul etmeyeceği adlar kalıyor — onlar için şerit kurulmaz.
+            const lane = resolvedEnvironment === 'development'
+                ? 'dev'
+                : resolvedEnvironment === 'production'
+                    ? 'view'
+                    : isBranchName(resolvedEnvironment) ? `branch/${resolvedEnvironment}` : undefined;
             if (!lane) {
-                throw new PlatformApiError(`page_screenshot yalnız 'development' (/dev) ve 'production' (/view) ortamlarını görüntüleyebilir; '${resolvedEnvironment}' için Studio'da karşılık gelen bir rota yok.`);
+                throw new PlatformApiError(`page_screenshot '${resolvedEnvironment}' ortamını görüntüleyemez: bu ad ne sabit bir ortam ne de geçerli bir dal adı. Sabitler 'development' (/dev) ve 'production' (/view); dal adı bir harfle başlar, yalnız küçük harf/rakam/alt çizgi taşır (3-31 karakter) ve rezerve olamaz ('public', 'api', 'pg_*' gibi). Projedeki dalları environment_list ile görün.`);
             }
-            const url = `${config.studioBaseUrl}/${lane}/${platform.resolveProject(project)}/${applicationSlug}/${pageSlug}`;
+            const projectSlug = platform.resolveProject(project);
+            const languageChoice = language === undefined ? undefined : normalizeLanguageCode(language, 'language');
+            if (languageChoice) {
+                // Bağ burada kurulmazsa sessiz yanlış kare doğar: runtime tanımadığı kodu yok sayar ve
+                // sayfayı varsayılan dilde çizer (resolveRuntimeLanguage yalnız projenin taşıdığı kodu
+                // seçer), kare de 'ikinci dil' diye rapora girerdi.
+                const state = readProjectLanguages(await platform.org('GET', `/p/${projectSlug}`).catch(() => undefined));
+                if (state && state.languages.length > 0 && !state.languages.includes(languageChoice.code)) {
+                    throw new PlatformApiError(`page_screenshot: '${languageChoice.code}' projenin dilleri arasında değil (${state.languages.join(', ')}). Runtime bilmediği kodu yok sayıp kareyi varsayılan dilde çizer — dili project_update(languages) ile ekleyin ya da listedeki bir kodu verin.`);
+                }
+            }
+            const url = `${config.studioBaseUrl}/${lane}/${projectSlug}/${applicationSlug}/${pageSlug}${languageChoice ? `?lang=${languageChoice.code}` : ''}`;
             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';
@@ -441,11 +526,15 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 delayMs: delayMs ?? 0,
                 ...(captureUnready === true ? { captureUnready: true } : {}),
                 ...(layoutReport === true ? { layoutReport: true } : {}),
+                ...(colorScheme === undefined ? {} : { colorScheme }),
                 ...(actions === undefined ? {} : { actions: actions })
             });
             const meta = {
                 url,
                 environment: resolvedEnvironment,
+                ...(languageChoice ? { language: languageChoice.code } : {}),
+                ...(languageChoice?.note ? { languageNote: languageChoice.note } : {}),
+                ...(colorScheme === undefined ? {} : { colorScheme }),
                 viewport: size,
                 fullPage: fullPage === true,
                 identity,
@@ -507,8 +596,12 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 ...(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.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.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.` }
+                ...(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.` }
                     : {}),
                 ...(shot.layout === undefined
                     ? {}
@@ -594,22 +687,29 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
         // 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)));
         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: 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 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.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -628,17 +728,19 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
         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 () => {
@@ -653,19 +755,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 {
@@ -676,10 +769,21 @@ 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 = [];
@@ -703,6 +807,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();
@@ -716,7 +821,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ı
@@ -729,7 +835,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);
@@ -738,7 +844,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 {
@@ -762,8 +869,9 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             : [];
         if (propTypeOps.length > 0)
             cachedPage = undefined;
-        const response = opRecords.length > 0
-            ? ((await platform.tenant('PATCH', project, `/pages/${applicationId}/${pageId}/schema`, { environment, body: { ops: opRecords } })) ?? {})
+        layoutWarnings = [...ordering.warnings, ...layoutWarnings];
+        const response = sentOps.length > 0
+            ? ((await platform.tenant('PATCH', project, `/pages/${applicationId}/${pageId}/schema`, { environment, body: { ops: sentOps } })) ?? {})
             : { valid: true };
         if (view !== 'full')
             outlineWriteResponse(response);
@@ -781,12 +889,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 {
@@ -802,7 +923,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', {
@@ -862,7 +984,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 };
@@ -896,7 +1018,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 = {

package/dist/tools/platformInfo.js

@@ -61,6 +61,7 @@ const guideRouting = {
     'modify-existing': 'mevcut yapıyı bozmadan değiştirme disiplini',
     workflow: 'DTO-önce akışı, branch bağlama, tip×step matrisi',
     microservice: 'kaynak seçimi (table > query), selectFields disiplini',
+    microfunction: 'kendi runtime\'ında koşan Node/Python fonksiyonu: protokol, yayın döngüsü, step kullanımı',
     entity: "alan tipleri, ilişkiler, hazır entity'ler",
     page: 'sayfa/flow işleri; flex düzen prop grubu ve boyut modları (Kural 1f-2)',
     layout: 'yerleşim kabuğu: tek slot, views, mobil yığılma, widthType fill/fixed/auto',
@@ -70,7 +71,9 @@ const guideRouting = {
     middleware: 'auth/oturum/yetki',
     view: 'tam metin arama indeksi',
     expressions: 'ifade fonksiyon/bağlam sözlüğü (system.*, file.*, Page.*, state.*, Steps…)',
-    translation: 'sayfa/içerik çevirileri (çoklu dil)'
+    functions: "fonksiyonlar, iki kaynak tek biçim: source:'studio' tarayıcıda Functions.<ad>() (kapsam uygulama/sayfa, UI flow 'function' adımı), source:'workflow' sunucuda çıplak ad; parametre/varsayılan/required, tuzaklar",
+    translation: 'sayfa/içerik çevirileri (çoklu dil)',
+    merge: "dal aç, dalda çalış, development'a merge et; çakışma çözümü ve apply kapıları"
 };
 // page.md 123 KB; section'sız dönerse yanıt tool çıktı sınırını aşıyor ve rehber MCP kanalından
 // HİÇ okunamıyor (27/05 E-1, 09-04 koşusu). Eşik ÖLÇÜLEN kopma noktasından türetilir, "bugün