@appaflytech/zeyrek-ai-mcp 0.0.22 → 0.0.24

package/dist/tools/layouts.js

@@ -99,8 +99,8 @@ export function registerLayoutTools(server, platform) {
         },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, name, views, events, parameters }) => {
-        assertScreenWriteGuards('layout', { schema: views, events });
         const resolved = await resolveProfile(platform, applicationId);
+        assertScreenWriteGuards('layout', { schema: views, events }, resolved.profile.platform);
         const fixed = normalizeComponentDefaults(views);
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, views);
         const gaps = [
@@ -138,13 +138,13 @@ export function registerLayoutTools(server, platform) {
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, ...changes }) => {
         const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
-        assertScreenWriteGuards('layout', { schema: overrides.views, events: overrides.events });
+        const resolved = overrides.views === undefined ? undefined : await resolveProfile(platform, applicationId);
+        assertScreenWriteGuards('layout', { schema: overrides.views, events: overrides.events }, resolved?.profile.platform);
         const current = await fetchHost(platform, 'layout', project, environment, applicationId, id);
         const fixed = normalizeComponentDefaults(overrides.views);
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, overrides.views);
         const body = layoutUpdateBody({ ...current, applicationId }, overrides);
         await platform.tenant('PUT', project, `/layouts/${applicationId}/${id}`, { environment, body });
-        const resolved = overrides.views === undefined ? undefined : await resolveProfile(platform, applicationId);
         const gaps = overrides.views === undefined || !resolved
             ? []
             : [
@@ -206,7 +206,8 @@ export function registerLayoutTools(server, platform) {
         const overrides = Object.fromEntries(['name', 'views', 'events', 'parameters']
             .filter(key => patched[key] !== undefined)
             .map(key => [key, patched[key]]));
-        assertScreenWriteGuards('layout', { schema: overrides.views, events: overrides.events });
+        const profile = await resolveProfile(platform, applicationId);
+        assertScreenWriteGuards('layout', { schema: overrides.views, events: overrides.events }, profile.profile.platform);
         const fixed = normalizeComponentDefaults(overrides.views);
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, overrides.views);
         const body = layoutUpdateBody({ ...current, applicationId }, overrides);
@@ -219,7 +220,6 @@ export function registerLayoutTools(server, platform) {
             body: { baseVersion: baseVersionOf(document, 'layout_get'), ops: netOps }
         });
         const written = patchResult(saved, finalDocument);
-        const profile = await resolveProfile(platform, applicationId);
         const gaps = [
             ...(profile.profile.layout.blocksMeaningful ? verticalGapWarnings(body.views, 'LAY-003 (uyarı)') : []),
             ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'),

package/dist/tools/microservices.js

@@ -6,13 +6,14 @@ import { normalizeMicroserviceDefinition, normalizeMicroservicePatchOps, withNor
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
 import { microserviceOutline, workflowOutline, resolvePart, resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
-import { policyRules } from '../knowledge/rules.js';
+import { filterOperatorError, policyRules } from '../knowledge/rules.js';
 import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
-import { identityHeaders } from '../platform/tokenVault.js';
+import { identityHeaders, resolveIdentity } from '../platform/tokenVault.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { existingMatch, ifExistsParam, listAll, platformRename, withOutcome, withRename } from '../platform/ifExists.js';
 import { outlineWrite, recordWriteViewParam } from '../platform/writeView.js';
 import { handle } from '../platform/responses.js';
+import { headersForMode } from '../platform/http.js';
 import fastJsonPatch from 'fast-json-patch';
 import { z } from 'zod';
 import { constraintSummary } from '../knowledge/backendConstraints.js';
@@ -68,7 +69,7 @@ async function queryScopeFindings(platform, project, environment, definition) {
 }
 const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
     .describe("RFC 6902 JSON Patch işlemleri; path'leri view:'outline'/'part' ile keşfedin. Dizi öğelerinde indeks yerine seçici kullanılabilir: '/sourceParameters/joins[alias=customers]/path' — seçici gövde platforma gitmeden indekse çevrilir, çözülemezse istek hiç gönderilmez.");
-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 jetonu ÇEREZDEN okuyan middleware de geçer — uca middleware bağlandığı anda bu alan olmadan çağrı 401 döner (09-05 koşusu S-21). İKİ ŞEKİL kabul edilir: (1) ham JWT, (2) `tok_…` referansı (giriş ucunu çağırdığınızda yanıtın tokenRefs alanında döner, 15 dk geçerli). anonymous ile birlikte verilemez.");
+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 jetonu ÇEREZDEN okuyan middleware de geçer — uca middleware bağlandığı anda bu alan olmadan çağrı 401 döner (09-05 koşusu S-21). ÜÇ ŞEKİL kabul edilir: (1) TERCİH EDİLEN `test:<ad>` — gateway kök .env'deki MCP_TEST_USER_<AD> satırıyla giriş ucunu kendisi çağırır, jetonu kasadan yeniden kullanır (satırı insan yazar), (2) `tok_…` referansı (giriş ucunu çağırdığınızda yanıtın tokenRefs alanında 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.");
 const cookiesParam = z.record(z.string()).optional().describe("İsteğe eklenecek çerezler (ad → değer): uygulamanın KENDİ oturum çerezi buraya verilir (ör. { CORE_Token: '<jwt>' }). asUser verildiğinde gateway NG_AccessToken çerezini zaten kendisi kurar; bu alan yalnız uygulama başka bir çerez adı okuyorsa gerekir. anonymous ile birlikte verilemez.");
 const executeInput = {
     project: projectParam,
@@ -189,6 +190,13 @@ function unboundQueryParameters(value, into = []) {
         unboundQueryParameters(entry, into);
     return into;
 }
+/** Çağrının dinamik filtresi (`filters`, sorguda ya da gövdede) bilinen işleçlerle mi — değilse istek gitmez (g-03). */
+function assertFilterOperators(tool, bound) {
+    const bodyFilters = bound.body && !Array.isArray(bound.body) ? bound.body.filters : undefined;
+    const error = filterOperatorError(tool, bound.query?.filters) ?? filterOperatorError(tool, bodyFilters);
+    if (error)
+        throw new PlatformApiError(error, 400);
+}
 function executePath(prefix, application, microservice, routeParams) {
     const routeSuffix = routeParams && routeParams.length > 0
         ? `/${routeParams.map(encodeURIComponent).join('/')}`
@@ -406,14 +414,20 @@ export function registerMicroserviceTools(server, platform) {
     }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/microservices/${id}/clone`, { environment })));
     server.registerTool('microservice_execute', {
         title: 'Microservice çalıştır',
-        description: "Kayıtlı microservice'i gerçek runtime yolundan çalıştırır (POST /{project}/m/{application}/{microservice SLUG'ı}). Dönen httpStatus microservice'in kendi sonucudur (hata da geçerli çıktıdır); beklenmedik sonuçta microservice_debug ile adım adım inceleyin. Anonim erişim testi için anonymous: true. Yanıt 'headers' alanında platformun döndüğü header'ları taşır (küçük harf; ör. headers['total-count'] — sayfalı tablo akışlarının okuduğu sözleşme; set-cookie/authorization elenir).",
-        inputSchema: executeInput,
+        description: "Kayıtlı microservice'i gerçek runtime yolundan çalıştırır (POST /{project}/m/{application}/{microservice SLUG'ı}). Dönen httpStatus microservice'in kendi sonucudur (hata da geçerli çıktıdır); beklenmedik sonuçta microservice_debug ile adım adım inceleyin. Anonim erişim testi için anonymous: true. Yanıt 'headers' alanı VARSAYILAN OLARAK yalnız iş başlıklarını taşır (küçük harf): content-type, content-length, content-disposition, location, total-count (sayfalı tablo akışlarının okuduğu sözleşme), x-request-id, traceparent. Ucun response adımında kendi yazdığı başlıkları ya da sunucu başlıklarını görmek için includeHeaders:'all'; hiç başlık istemiyorsanız 'none'. set-cookie/authorization her kipte elenir.",
+        inputSchema: {
+            ...executeInput,
+            includeHeaders: z.enum(['none', 'essential', 'all']).optional().describe("Yanıttaki 'headers' alanı. essential (varsayılan): content-type, content-length, content-disposition, location, total-count, x-request-id, traceparent. all: platformun döndüğü bütün başlıklar (gizliler hariç) — ucun kendi yazdığı başlığı doğrulamak için. none: başlık yok")
+        },
         annotations: writes
-    }, handle(config, async ({ project, environment, application, microservice, method, routeParams, query, body, parameters, headers, anonymous, asUser, cookies, language }) => {
+    }, handle(config, async ({ project, environment, application, microservice, method, routeParams, query, body, parameters, headers, anonymous, asUser, cookies, language, includeHeaders }) => {
         const notes = [];
-        const requestHeaders = { ...runIdentity(anonymous, asUser, cookies, headers), ...languageHeader(language, notes) };
+        const member = anonymous === true ? asUser : await resolveIdentity(asUser, platform, project, environment);
+        const requestHeaders = { ...runIdentity(anonymous, member, cookies, headers), ...languageHeader(language, notes) };
         const bound = bindCallParameters(method, parameters, query, body, notes);
-        return withNormalization(await platform.tenantRaw(method, project, executePath('m', application, microservice, routeParams), { environment, query: bound.query, body: bound.body, headers: requestHeaders, anonymous, mirrorAuthorizationCookie: true }), notes);
+        assertFilterOperators('microservice_execute', bound);
+        const raw = await platform.tenantRaw(method, project, executePath('m', application, microservice, routeParams), { environment, query: bound.query, body: bound.body, headers: requestHeaders, anonymous, mirrorAuthorizationCookie: true });
+        return withNormalization({ ...raw, headers: headersForMode(raw.headers, includeHeaders ?? 'essential') }, notes);
     }));
     server.registerTool('microservice_debug', {
         title: 'Microservice debug',
@@ -422,8 +436,10 @@ export function registerMicroserviceTools(server, platform) {
         annotations: writes
     }, handle(config, async ({ project, environment, application, microservice, method, routeParams, query, body, parameters, headers, anonymous, asUser, cookies, language }) => {
         const notes = [];
-        const requestHeaders = { ...runIdentity(anonymous, asUser, cookies, headers), ...languageHeader(language, notes) };
+        const member = anonymous === true ? asUser : await resolveIdentity(asUser, platform, project, environment);
+        const requestHeaders = { ...runIdentity(anonymous, member, cookies, headers), ...languageHeader(language, notes) };
         const bound = bindCallParameters(method, parameters, query, body, notes);
+        assertFilterOperators('microservice_debug', bound);
         const payload = await platform.tenantRaw(method, project, executePath('debug', application, microservice, routeParams), { environment, query: bound.query, body: bound.body, headers: requestHeaders, anonymous, mirrorAuthorizationCookie: true });
         const unbound = unboundQueryParameters(payload.body);
         return withNormalization({
@@ -474,7 +490,7 @@ export function registerMicroserviceTools(server, platform) {
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'microservice', definition, { operation: 'preview' }, policyOverride));
         // Önizleme de ucun middleware'lerini koşturur: kimlik verilmezse korumalı uç 401 döner ve kuru
         // koşu aracı tam gerektiği anda kullanılamaz hâle gelir (09-05 koşusu S-21).
-        const payload = await platform.tenantRaw('POST', project, `/microservices/${resolvedApplicationId}/preview`, { environment, body: definition, headers: { ...identityHeaders(asUser, cookies, undefined), ...languageHeader(language, normalized) }, mirrorAuthorizationCookie: true });
+        const payload = await platform.tenantRaw('POST', project, `/microservices/${resolvedApplicationId}/preview`, { environment, body: definition, headers: { ...identityHeaders(await resolveIdentity(asUser, platform, project, environment), cookies, undefined), ...languageHeader(language, normalized) }, mirrorAuthorizationCookie: true });
         return attachFindings(withResolved(withNormalization(payload, normalized), [...resolver.resolved, ...hydrated]), findings);
     }));
     server.registerTool('microservice_job_history', {

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.',