@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.7

package/dist/tools/pages.js

@@ -1,15 +1,57 @@
-import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive } from './common.js';
-import { orphanedFlowWarnings, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, blockSizeNote, heightTypeNote, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, invalidScreenEventNames, invalidWidgetTypeNodes, withNormalization, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
-import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode } from './screens.js';
-import { applyCatalogLayoutRules, fetchComponentEventNames } from './components.js';
-import { formBindingWarnings } from '../knowledge/coverage.js';
+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 { 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';
+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 { writeFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
+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';
-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). target = elementId.");
+/**
+ * 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
+ * durur. Bayrağı bilmeyen ajan pahalı olanı ödemesin diye kırpma OPT-OUT'tur (aynı karar:
+ * `DS-004`, `datasource_configuration_options`).
+ */
+const writeViewParam = z.enum(['outline', 'full']).optional().describe("Yanıttaki şema gövdesinin biçimi. outline (VARSAYILAN): komponent ağaçları iskelete iner (id/elementId/name/type/children), appliedPatch her op'un op+path'ini verir — 'yalnız o komponente mi dokunuldu' kanıtı JSON Pointer'dadır, 'kaydedildi mi' kanıtı silentlyDropped'tadır. full: platformun döndürdüğü gövde aynen gelir.");
+/**
+ * `appliedPatch` zarfın altında da gelebilir (`{ data: { appliedPatch } }`), düz de.
+ */
+function outlineWriteResponse(response) {
+    const inner = response.data;
+    const container = (inner && typeof inner === 'object' && !Array.isArray(inner) ? inner : response);
+    if (Array.isArray(container.appliedPatch))
+        container.appliedPatch = outlineAppliedPatch(container.appliedPatch);
+}
+const opsParam = z.array(z.record(z.unknown())).describe("Micro-op listesi. Op sözlüğü: replace_prop {target, prop, value} | 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
@@ -37,17 +79,6 @@ function collectTypes(nodes, into) {
         collectTypes(node.children, into);
     }
 }
-function invalidComponentNames(nodes) {
-    const found = [];
-    for (const node of nodes ?? []) {
-        const name = node.name;
-        if (typeof name === 'string' && name.length > 0 && !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name.replace(/-/g, ''))) {
-            found.push(`'${name}' (${node.elementId ?? '?'})`);
-        }
-        found.push(...invalidComponentNames(node.children));
-    }
-    return found;
-}
 function removeNodeFromTree(nodes, target) {
     for (let index = 0; index < nodes.length; index++) {
         if (nodes[index].elementId === target)
@@ -157,8 +188,113 @@ async function applyEventRemovals(platform, project, environment, applicationId,
     await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
     return removed;
 }
-export function registerPageTools(server, platform) {
+function findParentNode(nodes, target) {
+    for (const node of nodes) {
+        if ((node.children ?? []).some(child => child.elementId === target))
+            return node;
+        const deeper = findParentNode(node.children ?? [], target);
+        if (deeper)
+            return deeper;
+    }
+    return undefined;
+}
+/**
+ * `resize_component` gateway emülasyonudur: platformun micro-op sözlüğünde boyut YOKTUR
+ * (`move_component` yalnız `position` uygular, gövdeye konan `size` 200 döner ve sessizce düşer —
+ * ölçüldü 09-04). Bu yüzden kurulmuş bir sayfada bir kartın yüksekliğini değiştirmenin tek yolu
+ * düğümü `remove_component` + `add_component` ile yeniden kurmaktı; o da ona yazan akış
+ * setter'larını sessizce öldürüyordu (FLOW-018). Op şemayı okur, hedefin boyutunu değiştirir ve
+ * sayfayı tam gövdeyle geri yazar — `remove_event` ile aynı desen.
+ *
+ * Izgarada boyut `blocks[].size`, flex'te `appearance` alanlarındadır; ikisi de kabul edilir ve
+ * ebeveynin düzeni okunanı etkisiz kılıyorsa uyarı üretilir (PAGE-015 ile aynı yaklaşım: reddetme,
+ * ama sessiz de kalma).
+ */
+/**
+ * G-25 — `states` bir prop değil düğüm alanı: `replace_prop` yazamıyor, `move_component` yalnız
+ * konum uyguluyor ve `resize_component` (G-14) boyutla sınırlıydı. Kurulmuş bir düğümün
+ * `isWrapper` bayrağını değiştirmenin tek yolu düğümü silip yeniden kurmaktı; 09-05 koşusunda
+ * bunun bedeli 20 setter'ın sessizce kopmasıydı (G-21). Anahtar kümesi beyaz listeyle sınırlı:
+ * `states` açık uçlu bir sözlük ve uydurma bayrak sessizce kaydedilirdi.
+ */
+const WRITABLE_STATES = new Set(['isWrapper', 'isScrollable', 'isSticky', 'isDroppable', 'isFloating', 'isQuickStack']);
+async function applyResizes(platform, project, environment, applicationId, pageId, page, ops) {
+    const schema = JSON.parse(JSON.stringify(page.schema ?? []));
+    const applied = [];
+    const warnings = [];
+    for (const op of ops) {
+        const target = String(op.target ?? '');
+        const size = op.size && typeof op.size === 'object' ? op.size : undefined;
+        const appearance = op.appearance && typeof op.appearance === 'object' ? op.appearance : undefined;
+        const states = op.states && typeof op.states === 'object' ? op.states : undefined;
+        const breakpoint = Number(op.breakpoint ?? 1024);
+        if (!target)
+            throw new PlatformApiError("resize_component için 'target' zorunludur.", 400);
+        if (!size && !appearance && !states) {
+            throw new PlatformApiError(`resize_component '${target}' için 'size' ({ w, h } — ızgara), 'appearance' ({ widthType, widthString, heightType, heightString } — flex) ya da 'states' ({ isWrapper, isScrollable, isSticky, isDroppable, isFloating, isQuickStack }) verilmelidir; üçü de boş.`, 400);
+        }
+        if (states) {
+            const unknownStates = Object.keys(states).filter(key => !WRITABLE_STATES.has(key));
+            if (unknownStates.length > 0) {
+                throw new PlatformApiError(`resize_component '${target}': bilinmeyen states anahtarı (${unknownStates.join(', ')}). Yazılabilir bayraklar: ${[...WRITABLE_STATES].join(', ')}.`, 400);
+            }
+        }
+        const node = findNode(schema, target);
+        if (!node)
+            throw new PlatformApiError(`resize_component hedefi bulunamadı: '${target}'. page_schema_get ile elementId'leri listeleyin.`, 400);
+        const parent = findParentNode(schema, target);
+        const inFlex = parent !== undefined && isFlexContainer(parent);
+        if (size) {
+            const blocks = Array.isArray(node.blocks) ? node.blocks : [];
+            const block = blocks.find(entry => Number(entry?.breakpoint) === breakpoint);
+            if (!block) {
+                throw new PlatformApiError(`resize_component '${target}' düğümünde ${breakpoint} breakpoint'li blok yok (var olanlar: ${blocks.map(entry => entry?.breakpoint).join(', ') || 'hiç'}). Farklı bir breakpoint verin ya da düğümü add_component ile blokları kurulu olarak ekleyin.`, 400);
+            }
+            const current = (block.size ?? {});
+            block.size = { w: Number(size.w ?? current.w ?? 0), h: Number(size.h ?? current.h ?? 0) };
+            applied.push(`${target}.size=${JSON.stringify(block.size)}`);
+            if (inFlex) {
+                warnings.push(`PAGE-019 (uyarı): '${target}' düğümünün ebeveyni flex kapsayıcı; orada yerleşimi 'blocks[].size' DEĞİL appearance (widthType/widthString/heightType/heightString) belirler. Boyut yazıldı ama ekranda etkisi olmayabilir — flex'te ölçü vermek için aynı op'a 'appearance' koyun.`);
+            }
+        }
+        if (states) {
+            node.states = { ...(node.states ?? {}), ...states };
+            applied.push(`${target}.states=${JSON.stringify(states)}`);
+            if (states.isWrapper === true) {
+                warnings.push(`PAGE-020 (uyarı): '${target}' düğümüne isWrapper:true yazıldı — runtime sarmalayıcı düğüme 'min-height: 80vh' veriyor ve bu, sayfanın altına yüzlerce piksel ölü boşluk ekleyebilir (ölçüldü 09-05: dokuz düğüm ~1600px). style ile ezilemez; gerekmiyorsa isWrapper:false bırakın.`);
+            }
+        }
+        if (appearance) {
+            node.appearance = { ...(node.appearance ?? {}), ...appearance };
+            applied.push(`${target}.appearance=${JSON.stringify(appearance)}`);
+            if (!inFlex && parent !== undefined) {
+                warnings.push(`PAGE-019 (uyarı): '${target}' düğümünün ebeveyni flex DEĞİL; ızgarada yerleşimi 'blocks[].size' belirler ve appearance genişlik/yükseklik alanları etkisiz kalabilir. Izgarada ölçü vermek için aynı op'a 'size' koyun.`);
+            }
+        }
+    }
+    if (applied.length === 0)
+        return { applied, warnings };
+    const body = pageUpdateBody(page, { schema });
+    await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
+    return { applied, warnings };
+}
+async function applyPropTypes(platform, project, environment, applicationId, pageId, page, ops) {
+    const schema = JSON.parse(JSON.stringify(page.schema ?? []));
+    const { applied, missingTargets } = applyPropTypesToSchema(schema, ops);
+    if (missingTargets.length > 0) {
+        throw new PlatformApiError(`set_prop_type hedefi bulunamadı: '${missingTargets[0]}'. page_schema_get ile elementId'leri listeleyin.`, 400);
+    }
+    if (applied.length === 0)
+        return [];
+    const body = pageUpdateBody(page, { schema });
+    await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
+    return applied;
+}
+export function registerPageTools(server, platform, injectedScreenshotter) {
     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. */
+    const resolveIdentity = resolveIdentityToken;
     server.registerTool('page_list', {
         title: 'Sayfaları listele',
         description: 'Uygulamanın sayfalarını (id, name, slug) listeler; hedef sayfayı bulmak için ilk adım.',
@@ -192,6 +328,7 @@ export function registerPageTools(server, platform) {
             name: page.name,
             slug: page.slug,
             browserTitle: page.browserTitle ?? '',
+            browserTitleKey: page.browserTitleKey ?? '',
             isHomepage: page.isHomepage === true,
             layoutId: page.layoutId ?? layout.id ?? null,
             layoutName: layout.name,
@@ -208,7 +345,7 @@ export function registerPageTools(server, platform) {
     }));
     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,
@@ -216,13 +353,20 @@ export function registerPageTools(server, platform) {
             pageSlug: z.string().min(1).describe("Sayfanın slug'ı (page_list)"),
             view: z.enum(['summary', 'full']).optional().describe('summary (varsayılan): şema/layout ağaçları id/name/type özetine indirgenir. full: ham gövde — büyük olabilir'),
             resolveStyles: z.boolean().optional().describe("summary görünümünde her düğüme EFEKTİF stilini ekler: tema componentStyles → preset → düğümün kendi stili kaskadı çözülür (aibox'ta tipli stil grupları da derlenir ve TABAN katman olur). styleLayers hangi katmanın konuştuğunu söyler — 'bu kutu neden böyle görünüyor' sorusunun cevabı budur."),
-            anonymous: z.boolean().optional().describe("true: istek HİÇBİR Authorization header'ı olmadan gider — 'korumalı sayfa tokensız ne döner, şema sızıyor mu?' sorusunun cevabı budur. Korumalı sayfada middlewareBlocked bekleyin.")
+            anonymous: z.boolean().optional().describe("true: istek HİÇBİR Authorization header'ı ve çerezi olmadan gider — 'korumalı sayfa tokensız ne döner, şema sızıyor mu?' sorusunun cevabı budur. Korumalı sayfada middlewareBlocked bekleyin."),
+            asUser: asUserParam
         },
         annotations: readOnly
-    }, handle(config, async ({ project, environment, applicationSlug, pageSlug, view, resolveStyles, anonymous }) => {
+    }, handle(config, async ({ project, environment, applicationSlug, pageSlug, view, resolveStyles, anonymous, asUser }) => {
         let response;
+        if (anonymous === true && asUser !== undefined) {
+            throw new PlatformApiError('page_runtime_get: anonymous:true ile asUser birlikte verilemez — biri kimliksiz isteği, diğeri belirli bir üyenin kimliğiyle atılan isteği ister.');
+        }
+        // page_screenshot çerez, bu tool başlık taşıyordu; çerez okuyan middleware ikincisinden
+        // yapısal olarak geçemiyordu. Kimlik artık iki kanalda birden gider (Y-02).
+        const identity = asUser === undefined ? {} : { headers: { authorization: `Bearer ${resolveIdentity(asUser)}` } };
         try {
-            response = await platform.tenant('GET', project, `/${applicationSlug}/p/${pageSlug}`, { environment, anonymous });
+            response = await platform.tenant('GET', project, `/${applicationSlug}/p/${pageSlug}`, { environment, anonymous, mirrorAuthorizationCookie: true, ...identity });
         }
         catch (error) {
             if (error instanceof PlatformApiError && typeof error.status === 'number' && error.status >= 300) {
@@ -245,24 +389,28 @@ export function registerPageTools(server, platform) {
         const asNodes = (value) => (Array.isArray(value) ? value : []);
         const named = (value) => (Array.isArray(value) ? value : []).map(entry => ({ id: entry.id, name: entry.name, slug: entry.slug }));
         return {
-            page: { id: body.id, name: body.name, slug: body.slug, browserTitle: body.browserTitle, isHomepage: body.isHomepage },
+            page: { id: body.id, name: body.name, slug: body.slug, browserTitle: body.browserTitle, browserTitleKey: body.browserTitleKey, isHomepage: body.isHomepage },
             events: body.events ?? [],
             layout: layout ? { id: layout.id, name: layout.name, views: asNodes(layout.views).map(node => summarize(node, styleSource)) } : null,
             schema: asNodes(body.schema).map(node => summarize(node, styleSource)),
             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."
                 : "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 = new StudioScreenshotter(config);
+    const screenshotter = injectedScreenshotter ?? new StudioScreenshotter(config);
     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 hata/boş durum karesi yine döner — bu da bir doğrulamadır. 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,
@@ -273,50 +421,161 @@ export function registerPageTools(server, platform) {
                 height: z.number().int().min(240).max(2160)
             }).optional().describe('Varsayılan 1280x800 (deviceScaleFactor 1)'),
             fullPage: z.boolean().optional().describe('true: kaydırılan kısım dahil tüm sayfa; varsayılan yalnız viewport karesi'),
-            delayMs: z.number().int().min(0).max(10000).optional().describe('Animasyon/geç gelen veri için EK bekleme; 600 ms yerleşme beklemesi her zaman uygulanır'),
-            anonymous: z.boolean().optional().describe("true: NG_AccessToken çerezi enjekte edilmez — anonim ziyaretçinin gördüğü kare. Korumalı sayfada middlewareBlocked bekleyin."),
+            delayMs: z.number().int().min(0).max(60000).optional().describe("Hazırlık bütçesine EK süre (ms). Varsayılan bütçe 15 sn'dir ve kare sayfa hazır olur olmaz alınır (akışsız giriş ekranı ~1 sn, dashboard mount akışları bitince) — normalde vermeye gerek yok. Yalnız sayfa gerçekten uzun sürüyorsa (soğuk Vite derlemesi, ağır mount akışı) büyütün: bütçe dolduğunda sayfa hâlâ hazır değilse çağrı hatayla döner, kare alınmaz. Sayfanın AÇILMASI için beklenen 20 sn'lik navigasyon süresi de bu kadar uzar — soğuk Studio'da tek düğme budur (09-08 S-8)."),
+            captureUnready: z.boolean().optional().describe("true: TEŞHİS kipi — bütçe dolduğunda sayfa hazır olmasa da kare alınır ve yanıt pageState: 'not-ready' taşır (iskelet/yarım kare görülebilir). Varsayılan false: yüklenmemiş sayfa çekilmez, hata döner."),
+            anonymous: z.boolean().optional().describe("true: hiçbir çerez enjekte edilmez — anonim ziyaretçinin gördüğü kare. Korumalı sayfada middlewareBlocked bekleyin."),
+            asUser: asUserParam,
+            expectFailure: z.boolean().optional().describe("true: bu çekimde bir akış adımının düşmesi BEKLENİYOR (kasıtlı negatif test — yanlış parola, yetkisiz kullanıcı, geçersiz gövde). Kare yine alınır ve runtimeErrors yine dolar, ama yanıt expectedFailure:true taşır ve benchmark raporu bu satırı plansız hata saymaz: 2026-09-06 koşusunda on başarısız çağrının ALTISI kasıtlı negatif testti ve ayıklama elle yapıldı (S-4)."),
+            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"),
+                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)."),
+            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, anonymous, outPath }) => {
+    }, 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.");
+            }
             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 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}/${platform.resolveProject(project)}/${applicationSlug}/${pageSlug}`;
+            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';
+            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 : await platform.accessToken(),
+                token: anonymous ? undefined : resolveIdentity(asUser) ?? await platform.accessToken(),
+                ...(extraCookies.length > 0 ? { cookies: extraCookies } : {}),
                 cookieUrl: config.studioBaseUrl,
                 viewport: size,
                 fullPage: fullPage === true,
-                delayMs: delayMs ?? 0
+                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,
+                cookieNames,
                 sizeBytes: shot.png.byteLength,
                 elapsedMs: shot.elapsedMs,
+                ...(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.` }
+                    : {}),
                 ...(shot.apiStatus === undefined ? {} : { apiStatus: shot.apiStatus }),
                 ...(shot.apiStatus !== undefined && shot.apiStatus >= 300
-                    ? { middlewareBlocked: true, note: 'Sayfanın veri isteği reddedildi — karede hata/boş durum görünüyor olabilir. Korumalı sayfada kimliksiz/yetkisiz isteğin reddedilmesi BEKLENEN davranıştır (page_runtime_get ile karşılaştırın).' }
+                    ? { middlewareBlocked: true, note: `Sayfanın veri isteği reddedildi — karede hata/boş durum görünüyor olabilir. Korumalı sayfada kimliksiz/yetkisiz isteğin reddedilmesi BEKLENEN davranıştır (page_runtime_get ile karşılaştırın).${identity === 'gateway' ? " Gateway'in servis jetonu uygulamanın kendi kullanıcı tablosuna çözülmeyebilir; üye kimliğiyle çekmek için asUser (ve gerekiyorsa cookies) verin. Uygulamanın 'users' tablosu boşsa hiçbir kimlik çözülmez; yeni projede o tablo BOŞ gelir — row_list('users') ile bakın, ilk kullanıcıyı açma yolu platform_guide('getting-started') §'İlk kullanıcıyı kim açar?'." : ''}` }
+                    : {}),
+                // P1-1 (S-3): eşzamanlı çekimler gateway içinde SERİ koşar; ajan yavaşlığın kuyruktan mı
+                // yoksa sayfadan mı geldiğini bilsin.
+                ...(shot.queuedMs === undefined ? {} : { queuedMs: shot.queuedMs }),
+                ...(shot.contextRecycled === true
+                    ? { contextRecycled: true, contextRecycledNote: 'Önceki çekim tarayıcı bağlamını bozdu; bu kare TEMİZ bir tarayıcıyla alındı — oturum çerezleri yeniden enjekte edildi.' }
+                    : {}),
+                // S-8 (09-08): soğuk Studio'da navigasyon zaman aşımı ajanın çağrıyı tekrarlamasını
+                // gerektiriyordu; artık gateway bir kez kendi deniyor ve karenin neden geciktiğini söylüyor.
+                ...(shot.navigationRetried === true
+                    ? { navigationRetried: true, navigationRetriedNote: 'İlk navigasyon zaman aşımına düştü ve kare ikinci denemede alındı — Studio soğuktu (ilk istek Vite derlemesini ısıtır). Sonraki çekimler hızlı olmalı; olmuyorsa delayMs verin, o değer navigasyon bütçesini de uzatır.' }
+                    : {}),
+                // B-6 (2026-09-07): kare yalnız sayfa hazırken alınır; hangi kanıtla hazır sayıldığı yazılır.
+                pageState: shot.pageState,
+                readyAfterMs: shot.readyAfterMs,
+                ...(shot.finalUrl === undefined ? {} : { finalUrl: shot.finalUrl }),
+                ...(shot.pageState === 'ready-no-flows'
+                    ? { pageStateNote: 'Runtime çizildi ama hiç mount akışı koşmadı. Sayfa akışsızsa (giriş ekranı) normaldir; veri bekliyorsanız page_schema_get ile mount olayına bağlı akış olup olmadığına bakın.' }
+                    : shot.pageState === 'ready-no-counter'
+                        ? { pageStateNote: 'Runtime koşan akış sayacı yayınlamıyor (eski runtime); hazırlık DOM durulmasından çıkarıldı, akışların bittiği kanıtlanamadı.' }
+                        : shot.pageState === 'error'
+                            ? { pageStateNote: 'Studio sayfa için hata/bulunamadı durumunu çizdi; kare o durumu gösterir. apiStatus ve slug\'ları doğrulayın.' }
+                            : shot.pageState === 'redirected'
+                                ? { pageStateNote: `İstenen adres runtime dışına yönlendi (finalUrl). Route guard ya da Studio giriş ekranı olabilir; kare yönlendirilen sayfayı gösterir.` }
+                                : shot.pageState === 'not-ready'
+                                    ? { pageStateNote: 'TEŞHİS KARESİ (captureUnready): bütçe dolduğunda sayfa hazır değildi; kare iskelet ya da yarım durumu gösterebilir, doğrulama için kullanmayın.' }
+                                    : {}),
+                ...(shot.renderWaitTimedOut && shot.pageState === 'not-ready'
+                    ? { renderWaitTimedOut: true, note: "Sayfanın veri isteği gözlenmedi — STUDIO_BASE_URL ve slug'ları doğrulayın." }
                     : {}),
-                ...(shot.renderWaitTimedOut
-                    ? { renderWaitTimedOut: true, note: "Sayfanın veri isteği gözlenmedi — kare hata/boş durumu gösteriyor olabilir; STUDIO_BASE_URL ve slug'ları doğrulayın." }
-                    : {})
+                ...(shot.flowsSettled === undefined
+                    ? {}
+                    : shot.flowsSettled
+                        ? { flowsSettled: true }
+                        : { flowsSettled: false, flowsSettledNote: 'Sayfanın akışları bütçe içinde bitmedi; kare akış koşarken alındı (captureUnready). Akış gerçekten uzunsa delayMs ile bütçeyi büyütün.' }),
+                ...(shot.actions === undefined ? {} : { actionsReport: shot.actions }),
+                // S-4: kasıtlı negatif test de akış hatası bırakır ve ölçüm aracı onu plansız hata
+                // sayıyordu. Çağıran beklediğini söylediğinde satır ayrı sayılır.
+                ...(expectFailure === true ? { expectedFailure: true } : {}),
+                ...(shot.runtimeErrors === undefined
+                    ? {}
+                    : {
+                        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.` }
+                    : {}),
+                ...(shot.layout === undefined
+                    ? {}
+                    : shot.layout.length === 0
+                        ? { layoutReportUnavailable: true, note: "Sayfada data-element-id taşıyan düğüm yok — runtime bu attribute'u henüz basmıyor olabilir (F-04) ya da sayfa boş render edildi." }
+                        : {
+                            layoutSummary: summarizeLayout(shot.layout, size),
+                            ...(shot.layout.length <= 100 ? { layout: shot.layout } : { layoutTruncatedTo: 'summary' })
+                        })
             };
             if (outPath) {
                 const absolute = resolve(outPath);
                 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 });
                     await writeFile(absolute, shot.png);
                 }
                 catch (error) {
@@ -376,10 +635,16 @@ export function registerPageTools(server, platform) {
     server.registerTool('page_schema_validate', {
         title: 'Sayfa şemasını doğrula (kuru çalıştırma)',
         description: "Micro-op'ları kaydetmeden şemaya uygular ve doğrulama hatalarını (suggestions ile) döndürür; page_schema_patch öncesi planı test etmek için. Gövdeye page_schema_patch ile AYNI normalizasyonu uygular (Prop sarmalı, validation biçimi) — kuru koşu ile yazma aynı gövdeyi görür.",
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid, ops: opsParam.optional() },
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, 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") },
         annotations: readOnly
-    }, handle(config, async ({ project, environment, applicationId, pageId, ops }) => {
-        const opRecords = (ops ?? []).map(op => op);
+    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations }) => {
+        const allOps = microOps('page_schema_validate', ops, operations).map(op => op);
+        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)));
         const normalized = normalizeSchemaOps(opRecords);
         const validationIssues = schemaOpValidationErrors(opRecords);
         const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
@@ -396,22 +661,34 @@ export function registerPageTools(server, platform) {
     }));
     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.",
+        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.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
             applicationId: guid,
             pageId: guid,
-            ops: opsParam,
-            expectedUpdatedAt: z.string().optional().describe("page_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz")
+            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"),
+            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, expectedUpdatedAt }) => {
-        const allOps = ops.map(op => op);
+    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion, view }) => {
+        const allOps = microOps('page_schema_patch', ops, operations).map(op => op);
         const removeEventOps = allOps.filter(entry => entry.op === 'remove_event');
-        const opRecords = 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);
+        }
         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);
         }
@@ -455,23 +732,27 @@ export function registerPageTools(server, platform) {
             if (unknown.length > 0)
                 throw new PlatformApiError(`PAGE-008 — geçersiz olay adı (istek gönderilmedi): ${unknown.join(' · ')}`, 400);
         }
+        // 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)))) {
+            try {
+                const page = await readPage();
+                deletedFlows = orphanedFlowPlan(page.schema, page.events, [...opRecords, ...removeEventOps]);
+            }
+            catch {
+                deletedFlows = [];
+            }
+            if (deletedFlows.length > 0 && allowFlowDeletion !== true) {
+                throw new PlatformApiError(orphanedFlowMessage(deletedFlows), 400);
+            }
+        }
         const added = opRecords
             .filter(entry => entry.op === 'add_component')
             .map(entry => entry.component);
-        const badWidgets = invalidWidgetTypeNodes(added, 'PAGE-012');
-        if (badWidgets.length > 0)
-            throw new PlatformApiError(`Geçersiz widget düğümü (istek gönderilmedi): ${badWidgets.join(' · ')}`, 400);
-        const badNames = invalidComponentNames(added);
-        if (badNames.length > 0) {
-            throw new PlatformApiError(`PAGE-009 — komponent adı JS tanımlayıcısı değil (istek gönderilmedi): ${badNames.join(' · ')}. `
-                + 'Runtime her komponent için `const <ad> = Components["<ad>"]` üretir; boşluklu ya da geçersiz bir ad '
-                + 'SAYFADAKİ TÜM ifadeleri "Missing initializer in const declaration" ile öldürür (layout adları her sayfaya sızar). '
-                + 'name alanını elementId ile aynı yaz; okunabilir Türkçe başlık için props.title / props.text / props.label kullan.', 400);
-        }
-        const catalog = added.length > 0
-            ? await applyCatalogLayoutRules(platform, project, environment, applicationId, added)
-            : { clamped: [], heights: [] };
-        const formWarnings = formBindingWarnings(opRecords);
+        assertScreenWriteGuards('page', { schema: added });
+        const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, added);
+        const formWarnings = [...formBindingWarnings(opRecords), ...formSubmitButtonWarnings(opRecords)];
         let flowWarnings = [];
         let layoutWarnings = [];
         if (opRecords.some(entry => entry.op === 'remove_component')) {
@@ -482,6 +763,16 @@ export function registerPageTools(server, platform) {
             catch {
                 flowWarnings = [];
             }
+            // Ters yön (FLOW-018): silinen düğüme YAZAN setter'lar. Akış gövdeleri şemada değil, ayrı
+            // uçta; okunamazsa uyarı üretmeyiz ama yama yine geçer.
+            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)];
+            }
+            catch {
+                // akış listesi okunamadı
+            }
         }
         let nestedAfterOps = [];
         const simulatable = opRecords.some(entry => ['add_component', 'move_component'].includes(String(entry.op))
@@ -498,7 +789,8 @@ export function registerPageTools(server, platform) {
                     ...pageContainerPositionWarning(page.schema),
                     ...verticalGapWarnings(simulated, 'PAGE-010 (uyarı)', touched),
                     ...stringStyleWarning(stringStyleNodes(simulated)),
-                    ...inertFlexPropWarning(inertFlexPropNodes(simulated))
+                    ...inertFlexPropWarning(inertFlexPropNodes(simulated)),
+                    ...flexSizeWarnings(simulated, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)')
                 ];
             }
             catch {
@@ -512,29 +804,62 @@ export function registerPageTools(server, platform) {
             : [];
         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 };
+        if (view !== 'full')
+            outlineWriteResponse(response);
         if (removedEvents.length > 0)
             response.removedEvents = removedEvents;
+        if (propTypes.length > 0)
+            response.propTypes = propTypes;
+        if (resized.applied.length > 0)
+            response.resized = resized.applied;
+        if (resized.warnings.length > 0)
+            response.resizeWarnings = resized.warnings;
+        if (deletedFlows.length > 0)
+            response.deletedFlows = deletedFlows;
         if (formWarnings.length > 0)
             response.formWarnings = formWarnings;
         if (flowWarnings.length > 0)
             response.flowWarnings = flowWarnings;
         if (layoutWarnings.length > 0)
             response.layoutWarnings = layoutWarnings;
-        return withNormalization(response, [
+        // 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');
+        let opDrops = [];
+        if (contentOps.length > 0) {
+            try {
+                const saved = await fetchPage(platform, project, environment, applicationId, pageId);
+                opDrops = schemaOpDrops(saved.schema, contentOps);
+            }
+            catch {
+                opDrops = [];
+            }
+        }
+        return withWriteDiff(withNormalization(response, [
             ...rootAddsNote(retargeted, PAGE_CONTAINER_ELEMENT_ID),
             ...componentDefaultsNote(normalized.components),
             ...validationNote(normalized.validations),
-            ...blockSizeNote(catalog.clamped),
-            ...heightTypeNote(catalog.heights),
+            ...catalogNotes,
             ...replacePropNote(normalized.props)
-        ]);
+        ]), opDrops);
     }));
     server.registerTool('page_create', {
         title: 'Sayfa oluştur',
-        description: "Yeni sayfa açar. Şemayı burada göndermek yerine boş bırakıp page_schema_patch micro-op'larıyla kurmak daha doğrudur (doğrulama duvarı + canlı canvas orada). roleIds için role_list, layoutId için layout_list kullanın.",
+        description: "Yeni sayfa açar. Şemayı burada göndermek yerine boş bırakıp page_schema_patch micro-op'larıyla kurmak daha doğrudur (canlı canvas ve hedefli düzeltme orada). Şemayı burada gönderirseniz 2026-09-08'den beri AYNI doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile reddedilir ve sayfa HİÇ açılmaz. roleIds için role_list, layoutId için layout_list kullanın. Yanıttaki schema VARSAYILAN OLARAK iskelettir (çözülmüş layout düğümleri dâhil id/type/children'a iner) — tam gövde için view:'full'; gönderdiğiniz bir alan kaydedilmediyse silentlyDropped söyler.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -542,30 +867,24 @@ export function registerPageTools(server, platform) {
             name: z.string().min(1),
             slug: z.string().min(1).describe("URL yolu, örn. 'orders' ya da 'orders/detail'"),
             browserTitle: z.string().optional(),
+            browserTitleKey: z.string().optional().describe("Sekme başlığının çeviri anahtarı. Verilirse başlık çeviri sözlüğünden çözülür ve language-selector ile dil değişince sayfa yenilenmeden güncellenir; boşsa browserTitle olduğu gibi kullanılır. Anahtarlar için translation_list."),
             layoutId: guid.optional(),
             roleIds: z.array(guid).optional().describe('Sayfayı görebilecek roller; boş = herkese açık'),
             middlewareIds: z.array(guid).optional(),
             events: eventsParam.optional(),
-            schema: schemaParam.optional()
+            schema: schemaParam.optional(),
+            view: writeViewParam
         },
         annotations: writes
-    }, handle(config, async ({ project, environment, applicationId, name, slug, browserTitle, layoutId, roleIds, middlewareIds, events, schema }) => {
-        const badEvents = invalidScreenEventNames(events, 'PAGE-011');
-        if (badEvents.length > 0)
-            throw new PlatformApiError(`Geçersiz sayfa olayı (istek gönderilmedi): ${badEvents.join(' · ')}`, 400);
+    }, handle(config, async ({ project, environment, applicationId, name, slug, browserTitle, browserTitleKey, layoutId, roleIds, middlewareIds, events, schema, view }) => {
         const container = ensurePageContainer(schema ?? []);
-        const badWidgets = invalidWidgetTypeNodes(container.schema, 'PAGE-012');
-        if (badWidgets.length > 0)
-            throw new PlatformApiError(`Geçersiz widget düğümü (istek gönderilmedi): ${badWidgets.join(' · ')}`, 400);
-        const nested = nestedRepeaterNodes(container.schema);
-        if (nested.length > 0)
-            throw new PlatformApiError(nestedRepeaterMessage(nested), 400);
+        assertScreenWriteGuards('page', { schema: container.schema, events });
         const stringStyles = stringStyleNodes(container.schema);
         const fixed = normalizeComponentDefaults(container.schema);
         const reset = resetPageContainerPosition(container.schema);
-        const catalog = (schema ?? []).length > 0
-            ? await applyCatalogLayoutRules(platform, project, environment, applicationId, container.schema)
-            : { clamped: [], heights: [] };
+        const catalogNotes = (schema ?? []).length > 0
+            ? await screenCatalogNotes(platform, project, environment, applicationId, container.schema)
+            : [];
         const moved = reorderSchemaBlocks(container.schema);
         const gaps = (schema ?? []).length > 0 ? verticalGapWarnings(container.schema, 'PAGE-010 (uyarı)') : [];
         const response = await platform.tenant('POST', project, `/pages/${applicationId}`, {
@@ -574,6 +893,7 @@ export function registerPageTools(server, platform) {
                 name,
                 slug,
                 browserTitle: browserTitle ?? '',
+                browserTitleKey: browserTitleKey ?? '',
                 layoutId: layoutId ?? null,
                 roleIds: roleIds ?? [],
                 middlewareIds: middlewareIds ?? [],
@@ -581,8 +901,20 @@ export function registerPageTools(server, platform) {
                 schema: container.schema
             }
         });
-        const normalized = withNormalization(response, [...container.fixes, ...reset, ...componentDefaultsNote(fixed), ...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...reorderNote(moved)]);
-        const createWarnings = [...gaps, ...stringStyleWarning(stringStyles), ...inertFlexPropWarning(inertFlexPropNodes(container.schema))];
+        const saved = (response && typeof response === 'object' && !Array.isArray(response)
+            ? (response.data ?? response)
+            : {});
+        // Kırpmadan ÖNCE doğrulama yolu (B-55): yanıt gövdesi iskelete inince "gönderdiğim prop
+        // kaydedildi mi" sorusunu gövde değil bu diff cevaplar. `layout_create`'in yaptığının sayfa
+        // ikizi; Prop sarmalı açılmazsa doğru kaydedilmiş her prop düşmüş görünür (G-28).
+        const drops = (schema ?? []).length > 0
+            ? silentlyDropped({ schema: unwrapProps(container.schema) }, { schema: unwrapProps(saved.schema) })
+            : [];
+        if (view !== 'full' && Array.isArray(saved.schema)) {
+            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ı)')];
         if (createWarnings.length === 0 || !normalized || typeof normalized !== 'object')
             return normalized;
         return { ...normalized, layoutWarnings: createWarnings };
@@ -598,6 +930,7 @@ export function registerPageTools(server, platform) {
             name: z.string().min(1).optional(),
             slug: z.string().min(1).optional(),
             browserTitle: z.string().optional(),
+            browserTitleKey: z.string().optional().describe("Sekme başlığının çeviri anahtarı. Verilirse başlık çeviri sözlüğünden çözülür ve language-selector ile dil değişince sayfa yenilenmeden güncellenir; boşsa browserTitle olduğu gibi kullanılır. Anahtarlar için translation_list."),
             layoutId: guid.nullable().optional().describe('null: layout bağını kaldırır'),
             roleIds: z.array(guid).optional(),
             middlewareIds: z.array(guid).optional(),
@@ -607,31 +940,15 @@ export function registerPageTools(server, platform) {
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, pageId, ...changes }) => {
         const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
-        const badEvents = invalidScreenEventNames(overrides.events, 'PAGE-011');
-        if (badEvents.length > 0)
-            throw new PlatformApiError(`Geçersiz sayfa olayı (istek gönderilmedi): ${badEvents.join(' · ')}`, 400);
-        const badWidgets = invalidWidgetTypeNodes(overrides.schema, 'PAGE-012');
-        if (badWidgets.length > 0)
-            throw new PlatformApiError(`Geçersiz widget düğümü (istek gönderilmedi): ${badWidgets.join(' · ')}`, 400);
-        const nestedUpdate = nestedRepeaterNodes(overrides.schema);
-        if (nestedUpdate.length > 0)
-            throw new PlatformApiError(nestedRepeaterMessage(nestedUpdate), 400);
+        assertScreenWriteGuards('page', { schema: overrides.schema, events: overrides.events });
         const current = await fetchHost(platform, 'page', project, environment, applicationId, pageId);
-        const badSchemaNames = invalidComponentNames(overrides.schema);
-        if (badSchemaNames.length > 0) {
-            throw new PlatformApiError(`PAGE-009 — komponent adı JS tanımlayıcısı değil (istek gönderilmedi): ${badSchemaNames.join(' · ')}. `
-                + 'Runtime her komponent için `const <ad> = Components["<ad>"]` üretir; geçersiz bir ad sayfadaki TÜM ifadeleri öldürür. '
-                + 'name = elementId yazın.', 400);
-        }
         const fixed = normalizeComponentDefaults(overrides.schema);
         const reset = overrides.schema === undefined ? [] : resetPageContainerPosition(overrides.schema);
-        const catalog = overrides.schema === undefined
-            ? { clamped: [], heights: [] }
-            : await applyCatalogLayoutRules(platform, project, environment, applicationId, overrides.schema);
+        const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, overrides.schema);
         const moved = overrides.schema === undefined ? [] : reorderSchemaBlocks(overrides.schema);
         const gaps = overrides.schema === undefined
             ? []
-            : [...verticalGapWarnings(overrides.schema, 'PAGE-010 (uyarı)'), ...inertFlexPropWarning(inertFlexPropNodes(overrides.schema))];
+            : [...verticalGapWarnings(overrides.schema, 'PAGE-010 (uyarı)'), ...inertFlexPropWarning(inertFlexPropNodes(overrides.schema)), ...flexSizeWarnings(overrides.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)')];
         const body = pageUpdateBody(current, overrides);
         await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
         const summary = {
@@ -641,7 +958,7 @@ export function registerPageTools(server, platform) {
         };
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
-        return withNormalization(summary, [...reset, ...componentDefaultsNote(fixed), ...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...reorderNote(moved)]);
+        return withNormalization(summary, [...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]);
     }));
     server.registerTool('page_clone', {
         title: 'Sayfa klonla',