@appaflytech/zeyrek-ai-mcp 0.0.23 → 0.0.24

package/dist/tools/pages.js

@@ -1,7 +1,7 @@
 import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive, microOps, isBranchName } from './common.js';
 import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, lostSetterTargets, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, spacingLayerWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, flexIndexOrder, flexIndexOrderNote, withNormalization, parseVariableEntries, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
 import { functionSignature } from '../knowledge/functionGuards.js';
-import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode, flowPath } from './screens.js';
+import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode, flowPath, countSchemaNodes, missingElementIds, splitSchemaIntoParts, encodeSchemaCursor, decodeSchemaCursor } from './screens.js';
 import { fetchComponentEventNames } from './components.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
 import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, planEventRemovals, resizeServerOps, planResizes, planPropTypes, rejectedOpsMessage } from './schemaOps.js';
@@ -9,15 +9,16 @@ import { formBindingWarnings, formSubmitButtonWarnings } from '../knowledge/cove
 import { emptyWriteDiff, schemaOpDrops, unwrapProps, withWriteDiff, writeDiff } from '../platform/writeDiff.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { existingMatch, ifExistsParam, listAll, withOutcome } from '../platform/ifExists.js';
-import { handle, toolResult, toolError } from '../platform/responses.js';
+import { handle, toolResult, toolError, prune } from '../platform/responses.js';
 import { StudioScreenshotter } from '../platform/capture/index.js';
 import { captureTargetFor } from '../platform/capture/target.js';
 import { diffSummaries, summaryLines, summaryStats } from '../platform/domSummary.js';
 import { captureKey, imageHash, sharedCaptureMemory } from '../platform/screenshotMemory.js';
+import { pageReadKey, schemaReadKey, sharedSchemaReadMemory } from '../platform/schemaReadMemory.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 { resolveIdentity } from '../platform/tokenVault.js';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { dirname, resolve } from 'node:path';
 import { setPropTypeErrors } from '../knowledge/propTypes.js';
@@ -60,10 +61,6 @@ async function orderByIndex(ops, readPage) {
         return { ops, moved: [], warnings: [] };
     }
 }
-/** Şema ağacındaki TÜM düğümler (kök + iç içe çocuklar); page_get ve page_create özeti aynı sayımı kullanır. */
-function countSchemaNodes(nodes) {
-    return (nodes ?? []).reduce((total, node) => total + 1 + countSchemaNodes(node.children), 0);
-}
 async function fetchPage(platform, project, environment, applicationId, pageId) {
     const response = await platform.tenant('GET', project, `/pages/${applicationId}/${pageId}`, { environment });
     return response?.data ?? {};
@@ -78,11 +75,41 @@ export const SERVER_PAGE_OPS = [
     'replace_prop', 'set_binding', 'set_prop_type', 'add_component', 'remove_component', 'move_component', 'reorder', 'set_block',
     'set_appearance', 'set_states', 'set_event', 'add_event', 'remove_event', 'set_validations', 'set_state_binding', 'remove_state_binding', 'batch'
 ];
-export function registerPageTools(server, platform, injectedScreenshotter, injectedMemory) {
+export function registerPageTools(server, platform, injectedScreenshotter, injectedMemory, injectedSchemaReadMemory) {
     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;
+    const schemaReadMemory = injectedSchemaReadMemory ?? sharedSchemaReadMemory;
+    const readKey = (project, environment, pageId, version) => schemaReadKey(project ?? config.defaultProject ?? '', environment ?? config.defaultEnvironment, pageId, String(version ?? ''));
+    const pageKey = (project, environment, pageId) => pageReadKey(project ?? config.defaultProject ?? '', environment ?? config.defaultEnvironment, pageId);
+    const rememberVersion = (project, environment, pageId, version) => {
+        if ((typeof version === 'string' && version.length > 0) || typeof version === 'number') {
+            schemaReadMemory.rememberVersion(pageKey(project, environment, pageId), String(version));
+        }
+    };
+    /**
+     * g-05: sayfa sürüm çakışması (409 `PageSchemaVersionConflictException`) ajana "sayfa hangi
+     * sürümde, kim ne zaman değiştirdi" ile döner. Güncel sürüm sayfadan, son yazma revizyon
+     * defterinden (`/revisions/{projectId}`, en yeni tek satır) okunur; ikisi de okunamazsa mesaj
+     * o parçasız gider — çeviri hiçbir zaman çakışmanın kendisini gizlemez. Başka her hata olduğu
+     * gibi döner.
+     */
+    const versionConflict = async (error, project, environment, applicationId, pageId, sentVersion, nextStep) => {
+        if (!(error instanceof PlatformApiError) || error.code !== 'PageSchemaVersionConflictException')
+            return error;
+        const currentVersion = await fetchPage(platform, project, environment, applicationId, pageId).then(page => page.version, () => undefined);
+        const revision = await (async () => {
+            const projectPayload = await platform.org('GET', `/p/${platform.resolveProject(project)}`);
+            const revisions = await platform.org('GET', `/revisions/${projectPayload?.data?.id ?? ''}`, {
+                query: { environment: environment ?? config.defaultEnvironment, module: 'page', recordId: pageId, pageLength: 1 }
+            });
+            return revisions?.data?.[0];
+        })().catch(() => undefined);
+        const actor = (revision?.actor ?? {});
+        const lastWrite = revision
+            ? ` — son yazma ${String(revision.createdAt ?? '?')}, ${String(actor.name ?? actor.id ?? 'bilinmeyen kullanıcı')}, kaynak ${String(revision.source ?? '?')}, revizyon ${String(revision.revisionNo ?? '?')}`
+            : '';
+        return new PlatformApiError(`Sayfa siz okuduktan sonra değişti: gönderilen sürüm ${sentVersion ?? '(yok)'}, güncel sürüm ${String(currentVersion ?? '?')}${lastWrite}. HİÇBİR ŞEY yazılmadı. ${nextStep}`, 409, error.code);
+    };
+    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. ÜÇ ŞEKİL kabul edilir: (1) TERCİH EDİLEN `test:<ad>` — gateway kök .env'deki MCP_TEST_USER_<AD> satırının tarif ettiği giriş ucunu kendisi çağırır ve jetonu kasadan yeniden kullanır (satırı insan yazar; tanımsızsa hata eklenecek değişkeni söyler), (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 (ömür MCP_TOKEN_TTL_MINUTES; MCP_STATE_DIR varsa gateway yeniden başlayınca da çözülür), (3) ham JWT. anonymous ile birlikte verilemez.");
     server.registerTool('page_list', {
         title: 'Sayfaları listele',
         description: 'Uygulamanın sayfalarını (id, name, slug) listeler; hedef sayfayı bulmak için ilk adım.',
@@ -104,13 +131,14 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
     }));
     server.registerTool('page_get', {
         title: 'Sayfa üstbilgisini getir',
-        description: "Sayfanın kimlik ve bağ bilgisi: slug, browserTitle, layoutId, middlewareIds, roleIds, sayfa düzeyi olaylar (events[].value = flow id) ve flow özetleri. ŞEMA DÖNDÜRMEZ — şema için page_schema_get. 'Sayfa middleware'e bağlı mı, hangi roller görüyor, hangi olaya hangi akış bağlı' sorularının cevabı budur (Kural 8 denetimi).",
+        description: "Sayfanın kimlik ve bağ bilgisi: slug, browserTitle, layoutId, middlewareIds, roleIds, sayfa düzeyi olaylar (events[].value = flow id) ve flow özetleri. ŞEMA DÖNDÜRMEZ — şema için page_schema_get. 'Sayfa middleware'e bağlı mı, hangi roller görüyor, hangi olaya hangi akış bağlı' sorularının cevabı budur (Kural 8 denetimi). Yanıttaki version gateway'de hatırlanır: ardından gelen page_update onu baseVersion olarak gönderir (PAGE-039).",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid },
         annotations: readOnly
     }, handle(config, async ({ project, environment, applicationId, pageId }) => {
         const page = await fetchPage(platform, project, environment, applicationId, pageId);
         const resolved = await resolveProfile(platform, applicationId);
         const layout = (page.layout ?? {});
+        rememberVersion(project, environment, pageId, page.version);
         return {
             id: page.id,
             name: page.name,
@@ -128,6 +156,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             flows: (Array.isArray(page.flows) ? page.flows : [])
                 .map(flow => ({ id: flow.id, name: flow.name, slug: flow.slug })),
             schemaNodes: countSchemaNodes(page.schema),
+            version: page.version,
             updatedAt: page.audit?.updatedAt ?? page.audit?.createdAt,
             ...applicationTypeField(resolved)
         };
@@ -153,7 +182,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         }
         // 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)}` } };
+        const identity = asUser === undefined ? {} : { headers: { authorization: `Bearer ${await resolveIdentity(asUser, platform, project, environment)}` } };
         try {
             response = await platform.tenant('GET', project, `/${applicationSlug}/p/${pageSlug}`, { environment, anonymous, mirrorAuthorizationCookie: true, ...identity });
         }
@@ -218,7 +247,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
     const maxInlinePngBytes = 5 * 1024 * 1024;
     server.registerTool('page_screenshot', {
         title: 'Sayfanın ekran görüntüsünü al',
-        description: "ÖNCE KARESİZ DENE: 'kart göründü mü, tablo doldu mu, hata var mı' gibi olgu sorularında image:'none' verin — kare çekilmez, yanıttaki summaryText her kök düğümün görünürlüğünü, metnini, satır sayısını, açık sekmesini ve hata mesajlarını söyler (bir tam sayfa karesinin yüzlerce katı küçük). Kareyi yalnız görsel soru (renk, hizalama, referansa sadakat) için alın ve küçültün: clip ile bölge, scale:0.5 ile yarı çözünürlük; aynı sayfayı yeniden çekerken image:'ifChanged'. 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).",
+        description: "ÖNCE KARESİZ DENE: 'kart göründü mü, tablo doldu mu, hata var mı' gibi olgu sorularında image:'none' verin — kare çekilmez, yanıttaki summaryText her kök düğümün görünürlüğünü, metnini, satır sayısını, açık sekmesini ve hata mesajlarını söyler (bir tam sayfa karesinin yüzlerce katı küçük). Kareyi yalnız görsel soru (renk, hizalama, referansa sadakat) için alın ve küçültün: clip ile bölge, scale:0.5 ile yarı çözünürlük; aynı sayfayı yeniden çekerken image:'ifChanged'. 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. Sayfa ya da bir bileşen ÇİZİLEMEZSE neden yanıttadır: mobilde çöken düğüm renderErrors ({elementId, message}; sayfanın geri kalanı çizilir), yakalanmamış istisna pageErrors, konsol hatası consoleErrors — kare alınamadıysa bütün nedenler hata metninde. 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,
@@ -330,7 +359,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             const dpr = appliedDevice && appliedDevice.dpr !== 1 ? appliedDevice.dpr : undefined;
             const extraCookies = Object.entries(cookies ?? {}).map(([name, value]) => ({ name, value }));
             const identity = anonymous === true ? 'anonymous' : asUser === undefined ? 'gateway' : 'asUser';
-            const identityToken = anonymous ? undefined : resolveIdentity(asUser) ?? await platform.accessToken();
+            const identityToken = anonymous ? undefined : await resolveIdentity(asUser, platform, project, environment) ?? await platform.accessToken();
             const cookieNames = [...new Set([...(identity === 'anonymous' ? [] : ['NG_AccessToken']), ...extraCookies.map(cookie => cookie.name)])];
             const shot = await screenshotter.capture({
                 url,
@@ -520,6 +549,14 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                         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.renderErrors === undefined
+                    ? {}
+                    : {
+                        renderErrors: shot.renderErrors,
+                        renderErrorsNote: `${shot.renderErrors.length} düğüm çizilemedi: sayfanın geri kalanı çizildi, bu düğümlerin yerinde hata yer tutucusu var. message bileşen tipini ve hatayı söyler; genelde prop değeri ya da bileşenin kendisi (ARC kaydı).`
+                    }),
+                ...(shot.pageErrors === undefined ? {} : { pageErrors: shot.pageErrors }),
+                ...(shot.consoleErrors === undefined ? {} : { consoleErrors: shot.consoleErrors }),
                 ...(actionNotes.length === 0 ? {} : { actionsNote: actionNotes.join('\n') }),
                 ...(shot.layout === undefined
                     ? {}
@@ -569,30 +606,71 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
     });
     server.registerTool('page_schema_get', {
         title: 'Sayfa şemasını oku',
-        description: "Sayfanın komponent şemasını okur. Yanıttaki version değerini page_schema_patch'e baseVersion olarak verin: sayfa o okumadan beri değiştiyse yama 409 ile reddedilir ve hiçbir op uygulanmaz.",
+        description: "Sayfanın komponent şemasını okur. Yanıttaki version değerini page_schema_patch'e baseVersion olarak verin: sayfa o okumadan beri değiştiyse yama 409 ile reddedilir ve hiçbir op uygulanmaz. full ve subtree yanıtı nodeCount taşır. full tek yanıta sığmazsa HATA döner (sessiz kırpma yok): cursor:'0' ile parça parça okuyun — her parça items[] ({ parentElementId, index, node }) taşır, kalem parentElementId düğümünün children[index]'inin yerine geçer (parentElementId yoksa kök dizinin [index]'i), alt ağacı sığmayan düğüm kabuk gelir (children: [{ elementId, deferred: true }]) ve sonraki parçalar onu doldurur; nextCursor bitene kadar sürün. allowTruncated:true kırpılmış gövdeyi açıkça verir (truncated: true; hangi düğümlerin düştüğü söylenmez) — o gövdeyi page_update'e geri yazmayın (PAGE-037).",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
             applicationId: guid,
             pageId: guid,
-            mode: modeParam,
-            componentId: z.string().optional().describe("subtree kipinde kök alınacak komponentin elementId'si")
+            mode: modeParam.describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm şema; tek yanıta sığmazsa HATA döner — cursor:'0' ile parça parça okuyun (nextCursor bitene kadar) ya da allowTruncated:true ile kırpılmış gövdeyi açıkça isteyin."),
+            componentId: z.string().optional().describe("subtree kipinde kök alınacak komponentin elementId'si"),
+            cursor: z.string().min(1).optional().describe("Yalnız mode:'full': parçalı okuma. İlk çağrıda '0', sonra yanıttaki nextCursor; nextCursor gelmeyince şema bitmiştir. Sayfa okuma arasında değişirse 409 döner — cursor:'0' ile baştan başlayın."),
+            allowTruncated: z.boolean().optional().describe("Yalnız mode:'full': true verilirse sığmayan şema hata yerine kırpılarak döner (truncated: true, nodeCount toplamı söyler, düşen düğümler söylenmez). Varsayılan false: sığmayan şema hata verir.")
         },
         annotations: readOnly
-    }, handle(config, async ({ project, environment, applicationId, pageId, mode, componentId }) => {
+    }, handle(config, async ({ project, environment, applicationId, pageId, mode, componentId, cursor, allowTruncated }) => {
         const page = await fetchPage(platform, project, environment, applicationId, pageId);
         const typeField = applicationTypeField(await resolveProfile(platform, applicationId));
         const updatedAt = page.audit?.updatedAt ?? page.audit?.createdAt;
         const version = page.version;
-        if (mode === 'full')
-            return { version, updatedAt, ...typeField, schema: page.schema ?? [] };
+        rememberVersion(project, environment, pageId, version);
+        if (cursor !== undefined && mode !== 'full') {
+            throw new PlatformApiError(`cursor yalnız mode:'full' ile çalışır (verilen mode: '${mode ?? 'summary'}'); parçalı okuma tüm şema içindir. mode:'full' ile cursor:'0' verin ya da cursor'ı kaldırın.`, 400);
+        }
+        if (mode === 'full') {
+            const schema = page.schema ?? [];
+            const nodeCount = countSchemaNodes(schema);
+            const versionKey = String(version ?? '');
+            if (cursor !== undefined) {
+                const decoded = decodeSchemaCursor(cursor);
+                if (!decoded)
+                    throw new PlatformApiError(`cursor '${cursor}' çözülemedi; cursor yalnız '0' ya da önceki yanıttaki nextCursor olabilir. cursor:'0' ile baştan başlayın.`, 400);
+                if (decoded.version !== undefined && decoded.version !== versionKey) {
+                    throw new PlatformApiError(`Sayfa bu cursor alındıktan sonra değişti (cursor sürümü '${decoded.version}', güncel sürüm '${versionKey}'); eski parçalarla yenileri birleştirilirse şema tutarsız olur. Toplanan parçaları atın ve cursor:'0' ile baştan okuyun.`, 409);
+                }
+                const parts = splitSchemaIntoParts(schema, Math.floor(config.maxResponseBytes * 0.75));
+                const items = parts[decoded.partIndex];
+                if (!items)
+                    throw new PlatformApiError(`cursor '${cursor}' ${decoded.partIndex}. parçayı istiyor ama şema ${parts.length} parça; son parçadan sonra nextCursor gelmez. cursor:'0' ile baştan başlayın.`, 400);
+                const nextIndex = decoded.partIndex + 1;
+                return {
+                    version,
+                    updatedAt,
+                    ...typeField,
+                    nodeCount,
+                    part: { index: decoded.partIndex, count: parts.length, nodes: countSchemaNodes(items.map(item => item.node)) },
+                    items,
+                    ...(nextIndex < parts.length ? { nextCursor: encodeSchemaCursor(versionKey, nextIndex) } : {})
+                };
+            }
+            const full = { version, updatedAt, ...typeField, nodeCount, schema };
+            const chars = (JSON.stringify(prune(full)) ?? '').length;
+            if (chars > config.maxResponseBytes) {
+                if (allowTruncated !== true) {
+                    const kb = (value) => (value / 1024).toFixed(1);
+                    throw new PlatformApiError(`Şema ${nodeCount} düğüm / ${kb(chars)} KB; tek yanıta sığmaz (bütçe ${kb(config.maxResponseBytes)} KB). Kırpılmış şema hangi düğümlerin düştüğünü söylemez ve geri yazılırsa sayfa eksilir. cursor:'0' ile parça parça okuyun ya da allowTruncated:true verin (kırpılır, hangi düğümlerin düştüğü söylenmez). Hedef bulmak için mode:'summary' yeter.`, 400);
+                }
+                schemaReadMemory.markTruncated(readKey(project, environment, pageId, version));
+            }
+            return full;
+        }
         if (mode === 'subtree') {
             if (!componentId)
                 throw new PlatformApiError("mode='subtree' için componentId zorunludur.");
             const subtree = findNode(page.schema, componentId);
             if (!subtree)
                 throw new PlatformApiError(`Sayfada '${componentId}' id'li bir komponent yok; page_schema_get'i summary kipinde çağırıp hedefi doğrulayın.`);
-            return { version, updatedAt, ...typeField, schema: subtree };
+            return { version, updatedAt, ...typeField, nodeCount: countSchemaNodes([subtree]), schema: subtree };
         }
         return { version, updatedAt, ...typeField, schema: (page.schema ?? []).map(node => summarize(node)) };
     }));
@@ -624,7 +702,12 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         const ordering = resolved.profile.layout.orderBy === 'block-position'
             ? await orderByIndex(opRecords, () => fetchPage(platform, project, environment, applicationId, pageId))
             : { ops: opRecords, moved: [], warnings: [] };
-        const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, { kind: 'page', ops: opRecords });
+        const writesStyle = resolved.profile.platform !== 'web' && opRecords.some(entry => (entry.op === 'replace_prop' || entry.op === 'set_binding') && entry.prop === 'style');
+        const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, {
+            kind: 'page',
+            ops: opRecords,
+            savedNodes: writesStyle ? await fetchPage(platform, project, environment, applicationId, pageId).then(page => page.schema, () => undefined) : undefined
+        });
         const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
             environment,
             body: { ops: [...allOps.filter(entry => entry.op === 'resize_component').flatMap(resizeServerOps), ...ordering.ops] }
@@ -748,7 +831,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         const added = opRecords
             .filter(entry => entry.op === 'add_component')
             .map(entry => entry.component);
-        assertScreenWriteGuards('page', { schema: added });
+        assertScreenWriteGuards('page', { schema: added }, resolved.profile.platform);
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, added);
         const formWarnings = [...formBindingWarnings(opRecords), ...formSubmitButtonWarnings(opRecords)];
         let flowWarnings = [];
@@ -799,14 +882,16 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             }
         }
         if (nestedAfterOps.length > 0)
-            throw new PlatformApiError(nestedRepeaterMessage(nestedAfterOps), 400);
+            throw new PlatformApiError(nestedRepeaterMessage(nestedAfterOps, resolved.profile.platform), 400);
         const removedEvents = planEventRemovals(removeEventOps);
         const resized = resizeOps.length > 0 ? planResizes((await readPage()).schema ?? [], resizeOps) : { serverOps: [], applied: [], warnings: [] };
         const propTypes = propTypeOps.length > 0 ? planPropTypes((await readPage()).schema ?? [], propTypeOps) : { serverOps: [], applied: [] };
         const serverOps = [...removeEventOps, ...resized.serverOps, ...propTypes.serverOps, ...sentOps];
+        const writesStyle = resolved.profile.platform !== 'web' && opRecords.some(entry => (entry.op === 'replace_prop' || entry.op === 'set_binding') && entry.prop === 'style');
         const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, {
             kind: 'page',
             ops: [...opRecords, ...propTypeOps],
+            savedNodes: writesStyle ? await readPage().then(page => page.schema, () => undefined) : undefined,
             steps: await boundFlowSteps(platform, resolved, project, environment, 'page', applicationId, pageId, opRecords)
         });
         layoutWarnings = [...ordering.warnings, ...layoutWarnings, ...profileWarnings];
@@ -814,12 +899,34 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         // yamadan ÖNCE yazılıyordu — PATCH reddedilse bile kalıcıydılar. Artık hepsi aynı atomik PATCH'te.
         // baseVersion yalnız biliniyorsa gider (ajanın verdiği ya da bu çağrıda zaten okunan sayfanınki):
         // sürümü öğrenmek için ayrı GET atılmaz, platform satırı her yamada kilitler.
+        const sentVersion = baseVersion ?? (typeof cachedPage?.version === 'string' ? cachedPage.version : undefined);
         const response = ((await platform.tenant('PATCH', project, `/pages/${applicationId}/${pageId}/schema`, {
             environment,
-            body: { ops: serverOps, baseVersion: baseVersion ?? (typeof cachedPage?.version === 'string' ? cachedPage.version : undefined) }
+            body: { ops: serverOps, baseVersion: sentVersion }
+        }).catch(async (error) => {
+            throw await versionConflict(error, project, environment, applicationId, pageId, sentVersion, "page_schema_get ile yeniden okuyup planı tazeleyin ve yeni version'ı baseVersion olarak gönderin; aynı op'ları eski sürümle tekrar göndermek yine 409 alır.");
         })) ?? {});
+        const patched = (response.data && typeof response.data === 'object' && !Array.isArray(response.data) ? response.data : response);
+        const unchanged = Array.isArray(patched.unchanged) ? patched.unchanged.map(String) : [];
+        rememberVersion(project, environment, pageId, patched.newVersion);
+        // g-05: platform (b-05) aynı yere aynı içerikle zaten duran add_component'i etkisiz sayar; bütün
+        // op'lar etkisizse yazmaz ve eski baseVersion'a 409 demez. Ajan bunu "hata yok ama bir şey de
+        // olmadı" diye okumasın: yanıtı kaybolan çağrının tekrarı olduğu açıkça söylenir.
+        if (unchanged.length > 0) {
+            response.alreadyApplied = patched.noop !== true
+                ? `Şu op'lar sayfada zaten duruyordu, yeniden yazılmadı (tekrar zararsız): ${unchanged.join(', ')}. Diğer op'lar uygulandı.`
+                : patched.stale === true
+                    ? `Bu yamanın bütün op'ları sayfada zaten duruyor (${unchanged.join(', ')}) — hiçbir şey yazılmadı. AMA sayfa gönderdiğiniz baseVersion'dan beri başka bir yazımla da değişti: newVersion sizin gönderdiğiniz sürümdür, güncel sürüm değil. Devam etmeden önce page_schema_get ile güncel hâli okuyun; eski sürümle gelen sonraki yazma 409 alır.`
+                    : `Bu yamanın bütün op'ları sayfada zaten duruyor (${unchanged.join(', ')}): büyük olasılıkla önceki çağrı uygulandı ama yanıtı size ulaşmadı. Tekrar zararsızdır — hiçbir şey yazılmadı, sürüm artmadı; newVersion sayfanın güncel sürümüdür.`;
+        }
         if (view !== 'full')
             outlineWriteResponse(response);
+        if (baseVersion && schemaReadMemory.wasTruncated(readKey(project, environment, pageId, baseVersion))) {
+            response.warnings = [
+                ...(Array.isArray(response.warnings) ? response.warnings : []),
+                `PAGE-038 (uyarı) — baseVersion '${baseVersion}' bu gateway'de page_schema_get allowTruncated:true ile KIRPIK okundu; plan düşen düğümleri görmeden yapılmış olabilir. Micro-op veri düşürmez ve yama uygulandı, ama hedef ve konumları page_schema_get mode:'summary' ya da cursor:'0' ile tam okuyup doğrulayın.`
+            ];
+        }
         if (removedEvents.length > 0)
             response.removedEvents = removedEvents;
         if (propTypes.applied.length > 0)
@@ -904,14 +1011,14 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             events: eventsParam.optional(),
             schema: schemaParam.optional(),
             view: writeViewParam,
-            ifExists: ifExistsParam('sayfa', "mevcut sayfayı page_update gibi günceller — yalnız bu çağrıda VERİLEN alanlar yazılır, verilmeyen şema/olaylar/roller korunur (page_schema_patch ile kurulmuş şema betik tekrar koşunca silinmez); id'si ve flow'ları korunur")
+            ifExists: ifExistsParam('sayfa', "mevcut sayfayı page_update gibi günceller — yalnız bu çağrıda VERİLEN alanlar yazılır, verilmeyen şema/olaylar/roller korunur (page_schema_patch ile kurulmuş şema betik tekrar koşunca silinmez); id'si ve flow'ları korunur. Şema verilirse sayfanın şeması BİLEREK tam yazılır (page_update force:true gibi — gateway sayfayı okuduğu anın sürümüyle yazar, aradaki Studio değişikliği ezilir); hedefli değişiklik için page_schema_patch")
         },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, name, slug, browserTitle, browserTitleKey, layoutId, roleIds, middlewareIds, events, schema, view, ifExists }) => {
         const resolved = await resolveProfile(platform, applicationId);
         const blocksMeaningful = resolved.profile.layout.blocksMeaningful;
         const container = ensurePageContainer(schema ?? [], resolved.profile.layout.rootContainer);
-        assertScreenWriteGuards('page', { schema: container.schema, events });
+        assertScreenWriteGuards('page', { schema: container.schema, events }, resolved.profile.platform);
         const stringStyles = stringStyleNodes(container.schema);
         const fixed = normalizeComponentDefaults(container.schema);
         // Mobil çizer blokları okumaz (D3): kök konumu sıfırlama, blok sıralama ve dikey boşluk
@@ -947,7 +1054,8 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             const before = pageUpdateBody(current);
             // Aynı ad/slug ile tekrar koşan betik o alanları "değişti" diye görmemeli (Gözlem 2).
             const changed = Object.keys(overrides).filter(key => JSON.stringify(before[key]) !== JSON.stringify(overrides[key]));
-            await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
+            const written = await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
+            rememberVersion(project, environment, pageId, written?.data?.version);
             const updateWarnings = schema === undefined
                 ? []
                 : [...gaps, ...stringStyleWarning(stringStyles), ...(resolved.profile.layout.modes.has('grid') ? inertFlexPropWarning(inertFlexPropNodes(container.schema)) : []), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)'), ...profileWarnings];
@@ -979,6 +1087,8 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         const saved = (response && typeof response === 'object' && !Array.isArray(response)
             ? (response.data ?? response)
             : {});
+        if (typeof saved.id === 'string')
+            rememberVersion(project, environment, saved.id, saved.version);
         // 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).
@@ -999,7 +1109,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
     }));
     server.registerTool('page_update', {
         title: 'Sayfa üstbilgisini güncelle',
-        description: "Sayfanın adını/slug'ını/layout'unu/rollerini değiştirir. Platformun PUT'u REPLACE'tir; gateway sayfayı önce okur, yalnız verdiğiniz alanları değiştirip tam gövdeyi geri yazar — bu yüzden şema ve olaylar kaybolmaz. ŞEMA değişikliği için bu tool'u değil page_schema_patch'i kullanın (doğrulama duvarı + canlı canvas orada).",
+        description: "Sayfanın adını/slug'ını/layout'unu/rollerini değiştirir. Platformun PUT'u REPLACE'tir; gateway sayfayı önce okur, yalnız verdiğiniz alanları değiştirip tam gövdeyi geri yazar — bu yüzden şema ve olaylar kaybolmaz. ŞEMA değişikliği için bu tool'u değil page_schema_patch'i kullanın (doğrulama duvarı + canlı canvas orada). SÜRÜMSÜZ YAZMAZ (PAGE-039): baseVersion verilmezse bu gateway'in o sayfada en son gördüğü sürüm gider (page_get, page_schema_get, page_schema_patch'in newVersion'ı ya da önceki page_update); hiçbiri yoksa istek gönderilmez — önce okuyun. Sayfa o sürümden beri değiştiyse (Studio'da açık sekme, başka ajan) 409 döner, kim ve ne zaman değiştirdiği söylenir ve hiçbir şey yazılmaz. force:true son sürümü okuyup onun üstüne bilerek yazar (yanıt forced: true).",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -1013,14 +1123,33 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             roleIds: z.array(guid).optional(),
             middlewareIds: z.array(guid).optional(),
             events: eventsParam.optional(),
-            schema: schemaParam.optional().describe('Nadiren gerekir; verilmezse mevcut şema korunur')
+            schema: schemaParam.optional().describe('Nadiren gerekir; verilmezse mevcut şema korunur. Tam REPLACE: kayıtlı sayfadan daha az düğüm taşıyan şema allowNodeLoss olmadan reddedilir (PAGE-037)'),
+            allowNodeLoss: z.boolean().optional().describe('true: gönderilen schema kayıtlı sayfadan daha az düğüm taşısa da yazılır — eksik düğümler geri dönüşsüz silinir. Varsayılan false: PAGE-037 ile reddedilir (kırpık okumanın geri yazılması)'),
+            baseVersion: z.string().optional().describe("Değişikliği planladığınız sayfa sürümü (page_get / page_schema_get yanıtındaki version). Verilmezse bu gateway'in o sayfada en son gördüğü sürüm gider; sayfa o sürümden beri değiştiyse 409 döner ve hiçbir şey yazılmaz"),
+            force: z.boolean().optional().describe("true: sürüm kontrolünü bilerek geçer — gateway sayfanın son sürümünü okuyup onun üstüne yazar, aradaki değişiklik (Studio sekmesi, başka ajan) ezilir. Yanıt forced: true taşır. Varsayılan false")
         },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, pageId, ...changes }) => {
+    }, handle(config, async ({ project, environment, applicationId, pageId, allowNodeLoss, baseVersion, force, ...changes }) => {
+        const knownVersion = baseVersion ?? schemaReadMemory.lastVersion(pageKey(project, environment, pageId));
+        if (knownVersion === undefined && force !== true) {
+            throw new PlatformApiError("PAGE-039 — page_update hangi sürümün üstüne yazdığını bilmiyor: baseVersion verilmedi ve bu gateway sayfayı henüz okumadı. Platformun PUT'u REPLACE'tir; sürümsüz tam gövde Studio'da açık bir sekmenin ya da başka bir ajanın değişikliğini sessizce ezer (Bitki Bakım koşusu, 14:02). Önce page_get ya da page_schema_get ile okuyun — yanıttaki version gateway'de hatırlanır — ya da onu baseVersion olarak verin. Son sürümün üstüne bilerek yazmak için force:true. İstek gönderilmedi.", 400);
+        }
         const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
-        assertScreenWriteGuards('page', { schema: overrides.schema, events: overrides.events });
-        const current = await fetchHost(platform, 'page', project, environment, applicationId, pageId);
         const resolved = overrides.schema === undefined ? undefined : await resolveProfile(platform, applicationId);
+        assertScreenWriteGuards('page', { schema: overrides.schema, events: overrides.events }, resolved?.profile.platform);
+        const current = await fetchHost(platform, 'page', project, environment, applicationId, pageId);
+        if (overrides.schema !== undefined && allowNodeLoss !== true) {
+            const storedSchema = current.schema;
+            const sentSchema = overrides.schema;
+            const stored = countSchemaNodes(storedSchema);
+            const sent = countSchemaNodes(sentSchema);
+            if (sent < stored) {
+                const missing = missingElementIds(storedSchema, sentSchema);
+                const listed = missing.slice(0, 10).join(', ');
+                const more = missing.length > 10 ? ` (+${missing.length - 10} daha)` : '';
+                throw new PlatformApiError(`PAGE-037 — gönderilen şema ${sent} düğüm, kayıtlı sayfa ${stored} düğüm; eksilen elementId'ler: ${listed}${more}. Platformun PUT'u REPLACE'tir: eksik düğümler geri dönüşsüz silinir — kırpık (allowTruncated) ya da yarım bir okuma geri yazılıyor olabilir, istek gönderilmedi. Şema değişikliğini page_schema_patch micro-op'larıyla yapın (silmek için remove_component); düğümleri bilerek siliyorsanız allowNodeLoss:true verin.`, 400);
+            }
+        }
         const blocksMeaningful = resolved?.profile.layout.blocksMeaningful ?? true;
         const fixed = normalizeComponentDefaults(overrides.schema);
         const reset = overrides.schema === undefined || !blocksMeaningful ? [] : resetPageContainerPosition(overrides.schema);
@@ -1036,12 +1165,19 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 ...(resolved ? await screenProfileWarnings(platform, resolved, project, environment, applicationId, { kind: 'page', nodes: overrides.schema }) : [])
             ];
         const body = pageUpdateBody(current, overrides);
-        await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
+        if (force !== true)
+            body.baseVersion = knownVersion;
+        const written = await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body }).catch(async (error) => {
+            throw await versionConflict(error, project, environment, applicationId, pageId, String(body.baseVersion ?? ''), "page_schema_get ile yeniden okuyun ve şema değişikliğini page_schema_patch ile uygulayın — yalnız dokunduğunuz yer yazılır, aradaki değişiklik korunur. Üstbilgi (ad, slug, layout, roller) için okuduktan sonra page_update'i yeniden çağırın; aradaki değişikliği bilerek ezmek için force:true.");
+        });
+        rememberVersion(project, environment, pageId, written?.data?.version);
         const summary = {
             id: pageId,
             changed: Object.keys(overrides),
-            preserved: { schemaNodes: body.schema.length, events: body.events.length }
+            preserved: { schemaNodes: countSchemaNodes(body.schema), events: body.events.length }
         };
+        if (force === true)
+            summary.forced = true;
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
         return withNormalization(summary, [...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]);
@@ -1052,6 +1188,26 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid },
         annotations: writes
     }, handle(config, ({ project, environment, applicationId, pageId }) => platform.tenant('POST', project, `/pages/${applicationId}/clone/${pageId}`, { environment })));
+    server.registerTool('page_restore', {
+        title: 'Sayfayı bir revizyona döndür',
+        description: "Sayfayı revizyon defterindeki N. sürümüne döndürür: şema (komponentler eski id'leriyle), sayfa olayları, roller, middleware'ler ve layout o sürümdeki gibi yazılır; o sürümün bağladığı ama bugün silinmiş akışlar da kendi son revizyonlarından AYNI id ile geri kurulur (önce adımsız akış, sonra şema, sonra adımlar — tek transaction). Boşalan ya da bayat bir kaydın ezdiği sayfayı (ZM-27) böyle geri alın; tek akış için flow_restore. N'yi revision_list(module: 'page', recordId: <pageId>) ile bulun, içeriğini revision_get/revision_diff ile doğrulayın. N'den SONRA bağlanan akışlar yetim kalır ve silinir — yanıt deletedFlows ile listeler, flow_restore ile geri gelir. baseVersion (page_schema_get version) verilirse sayfa o sürümden beri değiştiyse 409. N'nin bağladığı bir akışın revizyonu kalmamışsa 409 ve hiçbir şey yazılmaz (hata akış id'lerini söyler). DİKKAT: şemayı yüklemeyen komutların (UpdateProjectCommand, UpdateApplicationCommand…) yazdığı sayfa revizyonları komponent TAŞIMAZ; komponenti olan bir sayfayı böyle bir revizyona döndürmek platformca 409 ile reddedilir — correlationId'si sayfa kaydı olan (PatchPageSchemaCommand, UpdatePageCommand) revizyonu seçin. Sayfayı bilerek boşaltmak için allowEmpty: true.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            pageId: guid,
+            revisionNo: z.number().int().min(0).describe("Dönülecek sayfa revizyonunun numarası (revision_list revisionNo)"),
+            baseVersion: z.string().min(1).optional().describe('page_schema_get çıktısındaki version; sayfa o sürümden beri değiştiyse 409 döner ve hiçbir şey yazılmaz'),
+            allowEmpty: z.boolean().optional().describe('true: komponentsiz bir revizyona dönüp sayfayı bilerek boşalt. Varsayılan false — platform komponenti olan sayfayı boş revizyona döndürmeyi 409 ile reddeder')
+        },
+        annotations: destructive
+    }, handle(config, async ({ project, environment, applicationId, pageId, revisionNo, baseVersion, allowEmpty }) => {
+        const restored = unwrap(await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/restore`, {
+            environment,
+            body: { revisionNo, ...(baseVersion ? { baseVersion } : {}), ...(allowEmpty ? { allowEmpty: true } : {}) }
+        }));
+        return { pageId, ...restored };
+    }));
     server.registerTool('page_delete', {
         title: 'Sayfa sil',
         description: 'Sayfayı siler. Ana sayfa (isHomepage) silinemez; önce başka bir sayfayı ana sayfa yapın. Silmeden önce dependency_graph module:\'page\' ile bağımlılıkları kontrol edin.',

package/dist/tools/platformInfo.js

@@ -93,6 +93,7 @@ export function registerPlatformTools(server, platform) {
         'Modülün iş kuralları rehberini döner. Bir modülde İLK yazma işleminden önce ilgili rehberi okuyun:',
         ...guides.map(name => `- ${name}${guideRouting[name] ? `: ${guideRouting[name]}` : ''}`),
         "Büyük rehberler (page ~120 KB) section'sız çağrıda TAM METİN DÖNMEZ: giriş + bölüm listesi (outline) döner, truncated: true olur. Gövdeyi section ile bölüm bölüm alın.",
+        "Büyük gövdeyi (sayfa şeması, akış adımları, uç/workflow tanımı, patch op'ları) dosyaya yazıp bodyFile ile verin: gövde bağlamınızdan geçmez, satır içiyle aynı doğrulamadan geçer (page_*/flow_*/microservice_*/workflow_* create/update/patch). microservice_execute yanıt başlıkları varsayılan kısadır; ucun kendi başlığı için includeHeaders:'all'.",
         'Örnek gövdeler için ngapps://examples kaynaklarına bakın.'
     ].join('\n');
     server.registerTool('platform_whoami', {
@@ -155,6 +156,7 @@ export function registerPlatformTools(server, platform) {
         title: 'Kabiliyet boşluğu bildir',
         description: "Yapmak İSTEDİĞİNİZ ama platform desteklemediği için yapamadığınız her noktada BUNU ÇAĞIRIN — tasarımı sessizce küçültmeyin. Bu çağrı platforma gitmez, yalnızca günlüğe 'KABİLİYET BOŞLUĞU' bloğu yazar; hata günlüğünde görünmeyen bu kayıtlar ürün yol haritasının girdisidir. Önce rehbere bakıp (platform_guide; hazır komponent yetmiyorsa tek seferlik için 'html' kaçış kapısı, kalıcı bir ihtiyaç içinse 'external-component' — kendi komponentinizi yazıp yayınlayabilirsiniz) gerçekten desteklenmediğinden emin olun: desteklenen bir şeyi 'yok' diye bildirmek yanlış yol haritası üretir.",
         inputSchema: {
+            project: z.string().min(1).optional().describe("Boşluğun görüldüğü proje (ad ya da slug); kayda yazılır. Bu çağrı platforma gitmez, proje yalnız bağlamdır"),
             goal: z.string().min(1).optional().describe('Ne yapmak istediniz — kullanıcıya görünen sonuç olarak yazın ("randevu listesini hasta adına göre süzmek"). Eşanlamlı kabul edilir: title · summary · what.'),
             blocker: z.string().min(1).optional().describe('Neden yapamadınız — hangi kabiliyetin eksik olduğu ("uçta X yok", "komponentte Y prop\'u yok"). Eşanlamlı kabul edilir: reason · problem · missing · description.'),
             severity: z.string().optional().describe("YOL HARİTASINDAKİ SIRAYI BU ALAN BELİRLER, doldurun. blocker: özellik hiç yapılamadı · workaround: daha kötü bir yolla yapıldı · cosmetic: yalnız görsel/ergonomik kayıp. Eşanlamlılar çevrilir (critical/high/blocking→blocker, medium/major→workaround, low/minor/nit→cosmetic). TANINMAYAN değer reddedilir; verilmezse kayıt düşer ama yanıt 'incomplete' ile uyarır ve bildirim orta kovaya yazılır."),
@@ -172,9 +174,10 @@ export function registerPlatformTools(server, platform) {
         annotations: readOnly
     }, handle(config, async (input) => {
         const gap = normalizeGapReport(input);
-        logCapabilityGap({ goal: gap.goal, blocker: gap.blocker, severity: gap.severity, module: gap.module, attempted: gap.attempted, workaround: gap.workaround });
+        logCapabilityGap({ goal: gap.goal, blocker: gap.blocker, severity: gap.severity, module: gap.module, attempted: gap.attempted, workaround: gap.workaround, project: input.project });
         return {
             recorded: true,
+            ...(input.project ? { project: input.project } : {}),
             severity: gap.severity,
             module: gap.module ?? null,
             ...(Object.keys(gap.normalizedFrom).length > 0 ? { normalizedFrom: gap.normalizedFrom } : {}),

package/dist/tools/rows.js

@@ -4,7 +4,7 @@ import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.j
 import { withNormalization } from '../knowledge/normalize.js';
 import { RefResolver } from '../platform/refs.js';
 import { attachFindings, evaluatePolicy, enforcePolicy } from '../knowledge/policy.js';
-import { policyRules } from '../knowledge/rules.js';
+import { filterOperatorError, policyRules } from '../knowledge/rules.js';
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import { uploadFile } from './files.js';
@@ -224,6 +224,9 @@ export function registerRowTools(server, platform) {
         },
         annotations: readOnly
     }, handle(config, async ({ project, environment, entityId, language, ...body }) => {
+        const operatorError = filterOperatorError('row_list', body.filters);
+        if (operatorError)
+            throw new PlatformApiError(operatorError, 400);
         const notes = [];
         const headers = languageHeader(language, notes);
         const resolver = new RefResolver(platform, project, environment);
@@ -400,6 +403,9 @@ export function registerRowTools(server, platform) {
         if ((scope?.rowIds?.length ?? 0) > maxSelectedRowIds) {
             throw new PlatformApiError(`row_export: ${scope?.rowIds?.length} satır id'si, ${maxSelectedRowIds} sınırının üstünde. Bu kadar satırı seçerek değil filtreyle verin: scope { kind: 'view', filters: [...] }.`);
         }
+        const operatorError = filterOperatorError('row_export', scope?.filters);
+        if (operatorError)
+            throw new PlatformApiError(operatorError, 400);
         const resolvedFormat = format ?? 'xlsx';
         const notes = [];
         const resolver = new RefResolver(platform, project, environment);

package/dist/tools/schemaOps.js

@@ -24,7 +24,7 @@ export function outlineWriteResponse(response) {
     if (Array.isArray(container.appliedPatch))
         container.appliedPatch = outlineAppliedPatch(container.appliedPatch);
 }
-export 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. page_schema_patch'te 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. layout_schema_patch ve component_schema_patch bu çeviriyi YAPMAZ: orada sırayı position.y ile verin) | set_event {target, event, eventValue, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akış iki kez 422 duplicate-event. Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. set_event ile eventValue: null olay SİLMEZ, değersiz ölü kayıt bırakır. Olmayan olay 422 missing-event) | 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 unknown-appearance-field ile 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 adı: platforma set_block {target, breakpoint, size} + set_appearance {target, appearance} + set_states {target, states} olarak gider — o üç op'u doğrudan da gönderebilirsiniz. move_component'e konan size reddedilir. 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 — düğümü silmeden isWrapper bayrağını değiştirmenin yolu budur). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op prop'un TİPİNİ yerinde değiştirir. 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) | reorder {parent ('root' ya da elementId), order: [çocuk elementId'lerinin TAMAMI, yeni sırada]} (yalnız DİZİ sırasını değiştirir; çizim sırası blocks.position'dır — görünen sırayı değiştirmek için konumları set_block/move_component ile de yazın) | set_state_binding {target, binding: {name, expression, targets}} (ada göre ekler/değiştirir) | remove_state_binding {target, name} | batch {gestureId?, label?, ops: [...]} (iç içe batch yok). target = elementId. İstek atomiktir: tek op reddedilirse hiçbiri yazılmaz.");
+export 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. page_schema_patch'te 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. layout_schema_patch ve component_schema_patch bu çeviriyi YAPMAZ: orada sırayı position.y ile verin) | set_event {target, event, eventValue, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akışı ikinci kez bağlamak etkisizdir (unchanged; tekrar güvenli). Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. set_event ile eventValue: null olay SİLMEZ, değersiz ölü kayıt bırakır. Olmayan olay 422 missing-event) | 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 unknown-appearance-field ile 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 adı: platforma set_block {target, breakpoint, size} + set_appearance {target, appearance} + set_states {target, states} olarak gider — o üç op'u doğrudan da gönderebilirsiniz. move_component'e konan size reddedilir. 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 — düğümü silmeden isWrapper bayrağını değiştirmenin yolu budur). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op prop'un TİPİNİ yerinde değiştirir. 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) | reorder {parent ('root' ya da elementId), order: [çocuk elementId'lerinin TAMAMI, yeni sırada]} (yalnız DİZİ sırasını değiştirir; çizim sırası blocks.position'dır — görünen sırayı değiştirmek için konumları set_block/move_component ile de yazın) | set_state_binding {target, binding: {name, expression, targets}} (ada göre ekler/değiştirir) | remove_state_binding {target, name} | batch {gestureId?, label?, ops: [...]} (iç içe batch yok). target = elementId. İstek atomiktir: tek op reddedilirse hiçbiri yazılmaz.");
 /**
  * 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

package/dist/tools/screenWrite.js

@@ -35,9 +35,10 @@ export function invalidComponentNames(nodes) {
  * PAGE-009 ve PAGE-013'ün layout ayağı 2026-09-09'da eklendi: ikisi de yalnız sayfa yollarında
  * koşuyordu, oysa layout `views`'ü aynı runtime'dan geçer — bozuk ad o layout'a bağlı HER
  * sayfanın ifadelerini öldürür, iç içe repeater'ın geri yazma kırılması ise yapısaldır ve
- * barındıranın sayfa mı layout mu olduğuna bakmaz.
+ * barındıranın sayfa mı layout mu olduğuna bakmaz. `platform` yalnız PAGE-013 mesajının önerisini seçer
+ * (mobilde `grouped-list`); denetimlerin kendisi iki platformda aynıdır.
  */
-export function assertScreenWriteGuards(kind, screen) {
+export function assertScreenWriteGuards(kind, screen, platform) {
     const codes = GUARD_CODES[kind];
     const badEvents = invalidScreenEventNames(screen.events, codes.events);
     if (badEvents.length > 0)
@@ -54,7 +55,7 @@ export function assertScreenWriteGuards(kind, screen) {
     }
     const nested = nestedRepeaterNodes(screen.schema);
     if (nested.length > 0)
-        throw new PlatformApiError(nestedRepeaterMessage(nested), 400);
+        throw new PlatformApiError(nestedRepeaterMessage(nested, platform), 400);
 }
 /**
  * Katalog kurallarını (blok sınırı · auto-height · boyut string'i) ağaca uygular ve