@appaflytech/zeyrek-ai-mcp 0.0.41 → 0.0.43

package/dist/tools/pages.js

@@ -1,11 +1,11 @@
 import { guid, projectParam, environmentParam, pagingParams, asUserIdParam, readOnly, writes, updates, destructive, microOps, isBranchName, branchSlug } from './common.js';
-import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, lostSetterTargets, fillComponentNames, componentNameNote, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, addComponentIdErrors, missingBlocksNodes, assertAddComponentIds, assertComponentBlocks, 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, screenEventsNeedPlatform } from '../knowledge/normalize.js';
+import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, lostSetterTargets, fillComponentNames, componentNameNote, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, addComponentIdErrors, missingBlocksNodes, retiredTypeNodes, assertNoRetiredNodes, 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, screenEventsNeedPlatform } from '../knowledge/normalize.js';
 import { functionSignature } from '../knowledge/functionGuards.js';
 import { attachFindings } from '../knowledge/policy.js';
 import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode, flowPath, countSchemaNodes, missingElementIds, readFullSchema } from './screens.js';
 import { fetchComponentEventNames } from './components.js';
-import { assertComponentNames, assertScreenWriteGuards, screenCatalogNotes, assertScreenCatalog } from './screenWrite.js';
-import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, styleTargetTypes, simulateLayoutOps, applySkeletonOps, reshapesSkeleton, planEventRemovals, resizeServerOps, planResizes, planPropTypes, rejectedOpsMessage } from './schemaOps.js';
+import { assertScreenWriteGuards, screenCatalogNotes, assertScreenCatalog } from './screenWrite.js';
+import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, applySkeletonOps, reshapesSkeleton, planEventRemovals, callerSlots, planEmulatedOps, recordsWithEventRemovals, serverOpsInOrder, rejectedOpsMessage } from './schemaOps.js';
 import { formBindingWarnings, formSubmitButtonWarnings } from '../knowledge/coverage.js';
 import { emptyWriteDiff, schemaOpDrops, unwrapProps, withWriteDiff, writeDiff } from '../platform/writeDiff.js';
 import { PlatformApiError } from '../platform/errors.js';
@@ -30,6 +30,9 @@ import { boxSectionNote, collectIds, ensureBoxSections, expandSectionToggles } f
 import { designSnapshotInput } from '../knowledge/designSnapshot.js';
 import { discoverPage } from '../knowledge/pageDiscover.js';
 import { applicationTypeField, resolveProfile, resolveProfileBySlug } from '../knowledge/platform/resolve.js';
+import { batchEnvelopeNote, batchIndexHint, openBatchEnvelopes } from '../knowledge/platform/batchOps.js';
+import { heroTags } from '../knowledge/platform/heroTag.js';
+import { profileLintReadsSavedNodes } from '../knowledge/platform/lint.js';
 import { resolveThemeNative } from '../knowledge/styleResolveNative.js';
 import { boundFlowSteps, pageLayoutWarnings, screenProfileWarnings } from './profileWrite.js';
 import { applyMobileSpacingDefaults, applyMobileSpacingToOps, emptyMobileSpacingFix, mobileSpacingNote } from '../knowledge/platform/mobileSpacing.js';
@@ -76,7 +79,8 @@ async function fetchPage(platform, project, environment, applicationId, pageId)
  * Platformun sayfa micro-op sözlüğü (`PageSchemaMicroOpApplier.KnownOps`). Gateway'in sunucuya
  * ilettiği op'lar yalnız bunlardır; `test/page-micro-op-parity.test.ts` listeyi backend ve
  * `@ng-apps/screen-builder` ile karşılaştırır. `resize_component` gateway adıdır ve sunucuya
- * `set_block` + `set_appearance` + `set_states` olarak çevrilir.
+ * `set_block` + `set_appearance` + `set_states` olarak çevrilir. `batch` sözlüktedir ama iletilmez:
+ * zarf araç girişinde açılır (PAGE-048).
  */
 export const SERVER_PAGE_OPS = [
     'replace_prop', 'set_binding', 'set_prop_type', 'add_component', 'remove_component', 'move_component', 'reorder', 'set_block',
@@ -171,7 +175,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
     }));
     server.registerTool('page_runtime_get', {
         title: 'Sayfanın runtime çıktısını getir',
-        description: "Çıkan uygulamanın sayfa için aldığı GERÇEK paketi döner (GET /{project}/{application}/p/{slug} — sayfanın ham serve yolu budur; Studio preview ve runtime aynı ucu tüketir): sayfa şeması + layout views'ü + sayfa olayları + flow'lar + değişken anahtarları (variableKeys: middleware değişkenleri, pageVariableKeys/appVariableKeys: state.page/state.app anahtarları) + kullanıcı fonksiyonu imzaları (appFunctions/pageFunctions — bir ifadeye Functions.<ad>(…) yazmadan önce adı ve parametre sırasını buradan alın; gövde taşınmaz, function_get ile okunur). Kurduğun sayfanın SON hâlini doğrulamanın yolu budur (layout-slot yerleşimi dahil — Kural 1f). DİKKAT: sayfaya bağlı middleware'ler bu çağrıda GERÇEKTEN koşar; middleware reddederse yanıt middlewareBlocked ile döner — korumalı sayfada bu beklenen davranıştır ve kendisi bir doğrulamadır. Kompleks projede yanıta 'accessDecision' eklenir (allow | deny | not-enforced | unknown, mode, izin, reason, next): sayfa reddi page.view kararından mı geldi, sıradaki adım ne.",
+        description: "Çıkan uygulamanın sayfa için aldığı GERÇEK paketi döner (GET /{project}/{application}/p/{slug} — sayfanın ham serve yolu budur; Studio preview ve runtime aynı ucu tüketir): sayfa şeması + layout views'ü + sayfa olayları + flow'lar + değişken anahtarları (variableKeys: middleware değişkenleri, pageVariableKeys/appVariableKeys: state.page/state.app anahtarları) + kullanıcı fonksiyonu imzaları (appFunctions/pageFunctions — bir ifadeye Functions.<ad>(…) yazmadan önce adı ve parametre sırasını buradan alın; gövde taşınmaz, function_get ile okunur). Kurduğun sayfanın SON hâlini doğrulamanın yolu budur (layout-slot yerleşimi dahil — Kural 1f). DİKKAT: sayfaya bağlı middleware'ler bu çağrıda GERÇEKTEN koşar; middleware reddederse yanıt middlewareBlocked ile döner — korumalı sayfada bu beklenen davranıştır ve kendisi bir doğrulamadır. Kompleks projede yanıta 'accessDecision' eklenir (allow | deny | not-enforced | unknown, mode, izin, reason, next): sayfa reddi page.view kararından mı geldi, sıradaki adım ne. Mobil sayfada heroTag taşıyan düğümler `heroTags`'te listelenir (layout'unkiler dahil; statik etiket metniyle, ifadeye bağlı olan `bound: true` ile): paylaşılan öğe çiftini kurarken iki sayfanın özetini buradan karşılaştırın (platform_guide('page') §Kural 1g-3).",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -224,6 +228,9 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         const nativeTheme = resolveStyles && runtimeApplication.type === 'mobile' ? resolveThemeNative((theme ?? undefined)) : undefined;
         // Mobilde de tema katmanı (componentStyles ← $preset) çizerin tabanıdır (f-16); rapor aynı kaynağı okur.
         const nodeStyleSource = styleSource;
+        // Paylaşılan öğe etiketleri (frontend ADR 0022, MOB-030): iki sayfanın özeti karşılaştırılarak çift kurulur.
+        // Layout'un düğümleri de cihazda çizilir (başlıktaki logo); listede önce onlar gelir.
+        const pageHeroTags = runtimeApplication.type === 'mobile' ? [...heroTags(layout?.views), ...heroTags(body.schema)] : [];
         return {
             ...(decision ? { accessDecision: decision } : {}),
             page: { id: body.id, name: body.name, slug: body.slug, browserTitle: body.browserTitle, browserTitleKey: body.browserTitleKey, isHomepage: body.isHomepage },
@@ -231,6 +238,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             events: body.events ?? [],
             layout: layout ? { id: layout.id, name: layout.name, views: asNodes(layout.views).map(node => summarize(node, nodeStyleSource, nativeTheme)) } : null,
             schema: asNodes(body.schema).map(node => summarize(node, nodeStyleSource, nativeTheme)),
+            ...(pageHeroTags.length > 0 ? { heroTags: pageHeroTags } : {}),
             ...(nativeTheme ? { styleResolver: 'native' } : {}),
             widgets: named(body.widgets),
             flows: named(body.flows),
@@ -251,7 +259,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 }
                 : {}),
             note: nativeTheme
-                ? "Mobil uygulama: nativeStyle, mobil çizerin düğüme verdiği React Native stilidir — shell kutunun, text içine akan metnin stili (RN'de tipografi miras alınmaz); warnings mobilde çizilmeyen değerlerdir (MOB-002). Tema componentStyles ← $preset katmanı TABANDIR (panel grupları üstüne biner, serbest style son söz); mobil katalogda style prop'u olmadığı için $preset'e yeni başvuru yazılamaz, componentStyles tipin bütün düğümlerine iner."
+                ? "Mobil uygulama: nativeStyle, mobil çizerin düğüme verdiği React Native stilidir — shell kutunun, text içine akan metnin stili (RN'de tipografi miras alınmaz); warnings mobilde çizilmeyen değerlerdir (MOB-002; hareket alanları MOB-028). bound (yalnız varsa) değeri çalışma anında oluşan, ifadeye bağlı stil alanlarıdır (<grup>.<alan>) — stile girmezler. motion (yalnız hareketli düğümde) motionStyle'ın /dev ve cihazdaki çözümüdür; kanvas ve page_screenshot'ın donuk karesi uygulamaz. Tema componentStyles ← $preset katmanı TABANDIR (panel grupları üstüne biner, serbest style son söz); mobil katalogda style prop'u olmadığı için $preset'e yeni başvuru yazılamaz, componentStyles tipin bütün düğümlerine iner."
                 : resolveStyles
                     ? "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f). resolvedStyle = componentStyles → preset → düğüm stili kaskadı (aibox'ta tipli grupların derlemesi TABAN katmandır); styleLayers hangi katmanların konuştuğunu söyler — styleLayers.componentPreset ise CSS DEĞİL, düğümün hangi bileşen preseti versiyonundan kurulduğunun işaretidir."
                     : "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f); tam gövde gerekirse view:'full'. Bir düğümün ekranda GERÇEKTEN aldığı stili görmek için resolveStyles:true."
@@ -692,98 +700,20 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid },
         annotations: readOnly
     }, handle(config, ({ project, environment, applicationId, pageId }) => platform.tenant('GET', project, `/pages/${applicationId}/${pageId}/ai-context`, { environment })));
-    server.registerTool('page_schema_validate', {
-        title: 'Sayfa şemasını doğrula (kuru çalıştırma)',
-        description: "Micro-op'ları kaydetmeden şemaya uygular ve doğrulama hatalarını (suggestions ile) döndürür; page_schema_patch öncesi planı test etmek için. Gövdeye page_schema_patch ile AYNI normalizasyonu uygular (Prop sarmalı, validation biçimi) — kuru koşu ile yazma aynı gövdeyi görür.",
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid, ops: opsParam.optional(), operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı) — entity/microservice/workflow patch'leriyle aynı adı kullanabilmeniz için") },
-        annotations: readOnly
-    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations }) => {
-        const allOps = microOps('page_schema_validate', ops, operations).map(op => op);
-        const propTypeIssues = setPropTypeErrors(allOps.filter(entry => entry.op === 'set_prop_type'));
-        if (propTypeIssues.length > 0)
-            throw new PlatformApiError(`set_prop_type gövdesi eksik (istek gönderilmedi): ${propTypeIssues.join(' · ')}`, 400);
-        // Kuru koşu ile yazma AYNI gövdeyi görür (P0-2 Step 3): resize_component burada da sunucu
-        // op'larına çevrilir, platform dokunulan düğümleri aynı kapsamla doğrular.
-        const opRecords = allOps.filter(entry => entry.op !== 'resize_component');
-        const resolved = await resolveProfile(platform, applicationId);
-        // ARC-143: kuru koşu page_schema_patch'in add_component kapısını (PAGE-009 · 011 · 012 · 013)
-        // atlıyordu; ayrılmış adlı komponent validate'ten geçip yamada reddediliyordu.
-        assertScreenWriteGuards('page', { schema: opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component) }, resolved.profile.platform);
-        const readPage = () => fetchPage(platform, project, environment, applicationId, pageId);
-        const normalized = normalizeSchemaOps(opRecords, await styleTargetTypes(opRecords, readPage));
-        const added = opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component).filter(Boolean);
-        // page_schema_patch'in sırası: kimlik ve blocks op başına (PAGE-037), sonra ad (PAGE-009).
-        assertAddComponentIds(opRecords);
-        assertComponentBlocks(added);
-        assertComponentNames('page', added);
-        const validationIssues = [
-            ...schemaOpValidationErrors(opRecords).map(issue => `PAGE-016 — ${issue}`),
-            ...codePropTemplateErrors(opRecords).map(issue => `PAGE-032 — ${issue}`)
-        ];
-        const spacing = await mobileSpacingForOps(resolved.profile.platform, opRecords, () => fetchPage(platform, project, environment, applicationId, pageId));
-        const ordering = resolved.profile.layout.orderBy === 'block-position'
-            ? await orderByIndex(opRecords, () => fetchPage(platform, project, environment, applicationId, pageId))
-            : { ops: opRecords, moved: [], warnings: [] };
-        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
-        });
-        // page_schema_patch'in Connect Data duvarı kuru koşuda da koşar: patch'in reddedeceği op burada görünür.
-        const connectedProps = opRecords.some(entry => ['set_binding', 'set_prop_type', 'replace_prop', 'set_connect_data', 'remove_connect_data'].includes(String(entry.op)))
-            ? await fetchPage(platform, project, environment, applicationId, pageId).then(page => connectedPropKeys(page.schema), () => null)
-            : null;
-        const connectDataRejections = opRecords.flatMap((entry, index) => connectDataOpIssues(entry, connectedProps).map(issue => ({
-            index,
-            op: String(entry.op ?? ''),
-            target: typeof entry.target === 'string' ? entry.target : null,
-            code: issue.code,
-            message: issue.message
-        })));
-        // Yazmadaki gibi katalog kuralları GİDEN listeye: kuru koşu kırpılmamış boyutu doğrulayıp
-        // yazmanın geçireceği gövdeye hata veriyor, notu da vermiyordu (Y-13 C).
-        const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, ordering.ops.filter(entry => entry.op === 'add_component').map(entry => entry.component));
-        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] }
-        })) ?? {});
-        const skeletonWarnings = await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, () => fetchPage(platform, project, environment, applicationId, pageId), opRecords, 'audit');
-        if (validationIssues.length > 0)
-            response.validationWarnings = validationIssues;
-        if (ordering.warnings.length > 0 || profileWarnings.length > 0 || skeletonWarnings.length > 0)
-            response.layoutWarnings = [...ordering.warnings, ...profileWarnings, ...skeletonWarnings];
-        if (connectDataRejections.length > 0)
-            response.rejectedOps = connectDataRejections;
-        Object.assign(response, applicationTypeField(resolved));
-        return withNormalization(response, [
-            ...componentNameNote(normalized.names),
-            ...componentDefaultsNote(normalized.components),
-            ...validationNote(normalized.validations),
-            ...catalogNotes,
-            ...replacePropNote(normalized.props),
-            ...flexIndexOrderNote(ordering.moved),
-            ...mobileSpacingNote(spacing)
-        ]);
-    }));
-    server.registerTool('page_schema_patch', {
-        title: 'Sayfa şemasına patch uygula',
-        description: "Micro-op'ları doğrulama duvarından geçirip TEK PATCH ile kaydeder; açık studio canvas'ları SignalR ile canlı güncellenir. İstek atomiktir: bir op reddedilirse hiçbiri yazılmaz. baseVersion (page_schema_get çıktısındaki version ya da önceki yamanın newVersion'ı) verilirse sayfa o sürümden beri değişmişse 409 döner ve hiçbir op uygulanmaz (stale plan koruması); verilmezse gateway yalnız bu çağrıda zaten okuduğu sayfanın sürümünü gönderir. Yanıttaki appliedPatch, her op'un şemada tam olarak hangi JSON Pointer'a dokunduğunu söyler; gövdesi VARSAYILAN OLARAK iskelettir (eklenen düğüm id/type/children'a iner) — tam gövde için view:'full'. Op'un gerçekten kaydedilip kaydedilmediğini gövde değil silentlyDropped söyler. Gateway ön kontrolleri (PAGE-006/008/016/032, set_prop_type gövdesi, move_component size) op başına toplanır: düşen HER op tek hata yanıtında rejectedOps[] ({ index, op, target, code, message }) ile listelenir ve hiçbir op gönderilmez — hepsini düzeltip listeyi bir kez yeniden gönderin.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            applicationId: guid,
-            pageId: guid,
-            ops: opsParam.optional(),
-            operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı) — entity/microservice/workflow patch'leriyle aynı adı kullanabilmeniz için"),
-            baseVersion: z.string().optional().describe("page_schema_get çıktısındaki version ya da önceki page_schema_patch yanıtındaki newVersion; sayfa o sürümden beri değiştiyse 409 döner ve hiçbir op uygulanmaz"),
-            expectedUpdatedAt: z.string().optional().describe("Eski koruma: page_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz. baseVersion tercih edilir"),
-            allowFlowDeletion: z.boolean().optional().describe("true: bu yama bir akışı referanssız bırakacaksa yine de uygulanır. Varsayılan false — platform referanssız akışı KALICI siler ve gateway isteği önden reddeder (G-21). Silinen akışlar yanıtta deletedFlows ile listelenir."),
-            view: writeViewParam
-        },
-        annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, baseVersion, expectedUpdatedAt, allowFlowDeletion, view }) => {
-        const allOps = microOps('page_schema_patch', ops, operations).map(op => op);
+    /**
+     * Sayfa şemasına yazımın PLANI — `page_schema_patch` ve `page_schema_validate` aynısını koşar: ön kontroller, onarım,
+     * öykünülen op'ların çevrilmesi, platforma gidecek liste, uyarılar. Kuru koşu yazımla AYNI kararı verir (yazımın
+     * reddedeceği yamayı aynı mesajla reddeder) ve platforma AYNI gövdeyi doğrulatır; fark yalnız gönderilen istekte.
+     *
+     * İki işleyici ayrı yazılmıştı ve ayrışmıştı (TOOL-059, ölçüldü 2026-10-10, gerçek uç): kuru koşu
+     * `remove_component page_container`'a `valid: true` diyor, yazım aynı op'u PAGE-006 ile reddediyordu; kuru koşu
+     * PAGE-034 · PAGE-008 · MOVE-SIZE kapılarını, akış silme planını (G-21), yama sonrası iç içe tekrarlayıcıyı (PAGE-013),
+     * kök eklemenin taşınmasını ve `resize_component` planını da koşmuyordu. Emsal: ARC-143, `page-meta.test.ts`
+     * "validate = yazma". Regresyon: `test/page-dry-run-parity.test.ts`.
+     */
+    const planPageWrite = async (tool, { project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion }) => {
+        const opened = openBatchEnvelopes(tool, microOps(tool, ops, operations).map(op => op));
+        const allOps = opened.ops;
         const removeEventOps = allOps.filter(entry => entry.op === 'remove_event');
         const resizeOps = allOps.filter(entry => entry.op === 'resize_component');
         const propTypeOps = allOps.filter(entry => entry.op === 'set_prop_type');
@@ -826,14 +756,16 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             const toggles = expandSectionToggles(opRecords, schema, taken);
             sectionNotes = boxSectionNote([...created, ...toggles.created], toggles.removed);
         }
-        const normalized = normalizeSchemaOps(opRecords, await styleTargetTypes(opRecords, readPage));
+        const normalized = normalizeSchemaOps(opRecords);
         for (const entry of opRecords)
             reject('PAGE-016', entry, schemaOpValidationErrors([entry]));
         for (const entry of opRecords)
             reject('PAGE-032', entry, codePropTemplateErrors([entry]));
         for (const entry of opRecords)
             reject('PAGE-037', entry, [...addComponentIdErrors([entry]), ...(entry.op === 'add_component' ? missingBlocksNodes([entry.component]) : [])]);
-        const touchesConnection = opRecords.some(entry => entry.op === 'set_binding' || entry.op === 'set_prop_type' || entry.op === 'replace_prop' || entry.op === 'remove_connect_data');
+        for (const entry of opRecords)
+            reject('PAGE-051', entry, entry.op === 'add_component' ? retiredTypeNodes([entry.component]) : []);
+        const touchesConnection = propTypeOps.length > 0 || opRecords.some(entry => entry.op === 'set_binding' || entry.op === 'replace_prop' || entry.op === 'remove_connect_data');
         let connectedProps = null;
         if (touchesConnection) {
             try {
@@ -843,7 +775,8 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 connectedProps = null;
             }
         }
-        for (const entry of opRecords) {
+        // `set_prop_type` ayrı listededir; bağlı prop'u ezen yazımı (CD-005) o da yapar.
+        for (const entry of [...opRecords, ...propTypeOps]) {
             for (const issue of connectDataOpIssues(entry, connectedProps))
                 reject(issue.code, entry, [issue.message]);
         }
@@ -864,7 +797,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 reject('PAGE-008', entry, unknownEventOps([entry], typesByElementId, eventsBySlug));
         }
         if (rejected.length > 0)
-            throw new PlatformApiError(rejectedOpsMessage(rejected), 400);
+            throw new PlatformApiError(rejectedOpsMessage(rejected, batchIndexHint(opened)), 400);
         stripGatewayEventFields(opRecords);
         const wantsRootAdd = opRecords.some(entry => entry.op === 'add_component' && (entry.parent === undefined || entry.parent === null || entry.parent === 'root'));
         let retargeted = [];
@@ -882,16 +815,17 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             ? await orderByIndex(opRecords, readPage)
             : { ops: opRecords, moved: [], warnings: [] };
         const sentOps = ordering.ops;
+        // Bu noktadan sonra `opRecords` yeni op almaz (bölüm anahtarı yukarıda eklendi): çağıranın sırası sabittir.
+        const slots = callerSlots(allOps, opRecords);
         // Akış silen op'lar yamadan ÖNCE hesaplanır: uyarı sonradan geldiğinde akış zaten kalıcı
         // silinmiş oluyordu ve "önce yedekle" tavsiyesi uygulanamıyordu (09-05 koşusu, G-21).
         let deletedFlows = [];
         // remove_event opRecords'ta değil, ayrı listede durur; koşul yalnız opRecords'a baktığı sürece
         // yalnız olay kaldıran bir yama bu korumayı hiç tetiklemiyordu (2026-09-14).
-        // `batch` içindeki silme de planı gerektirir; açma `orphanedFlowPlan`'da.
-        if ([...opRecords, ...removeEventOps].some(entry => ['remove_component', 'set_event', 'remove_event', 'batch'].includes(String(entry.op)))) {
+        if ([...opRecords, ...removeEventOps].some(entry => ['remove_component', 'set_event', 'remove_event'].includes(String(entry.op)))) {
             try {
                 const page = await readPage();
-                deletedFlows = orphanedFlowPlan(page.schema, page.events, [...opRecords, ...removeEventOps]);
+                deletedFlows = orphanedFlowPlan(page.schema, page.events, recordsWithEventRemovals(slots, opRecords));
             }
             catch {
                 deletedFlows = [];
@@ -942,7 +876,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 const touched = simulateLayoutOps(simulated, sentOps);
                 // PAGE-013 op'lar UYGULANDIKTAN SONRAKİ ağaca bakar: tek başına eklenen düğüm masum
                 // görünür, iç içeliği ancak hedef parent zinciri belli olunca anlarsın.
-                nestedAfterOps = nestedRepeaterNodes(simulated);
+                nestedAfterOps = nestedRepeaterNodes(simulated, resolved.profile.platform);
                 layoutWarnings = [
                     ...(blocksMeaningful ? pageContainerPositionWarning(page.schema) : []),
                     ...(blocksMeaningful ? verticalGapWarnings(simulated, 'PAGE-010 (uyarı)', touched) : []),
@@ -959,25 +893,100 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         if (nestedAfterOps.length > 0)
             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');
+        // Öykünülen op'lar ağacın o andaki hâline göre planlanır ve çağıranın yazdığı yerde gider (PAGE-050).
+        const { resized, propTypes } = planEmulatedOps(resizeOps.length > 0 || propTypeOps.length > 0 ? (await readPage()).schema ?? [] : [], slots, opRecords);
+        const serverOps = serverOpsInOrder(slots, { sent: sentOps, resized: resized.groups, propTypes: propTypes.serverOps });
         const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, {
             kind: 'page',
             ops: [...opRecords, ...propTypeOps],
-            savedNodes: writesStyle ? await readPage().then(page => page.schema, () => undefined) : undefined,
+            // Kayıtlı ağaç: `style` yazımında hedefin tipi, `heroTag` yazımında sayfanın öteki etiketleri (MOB-030) için.
+            savedNodes: resolved.profile.platform !== 'web' && profileLintReadsSavedNodes(opRecords) ? await readPage().then(page => page.schema, () => undefined) : undefined,
             steps: await boundFlowSteps(platform, resolved, project, environment, 'page', applicationId, pageId, opRecords)
         });
-        const skeletonWarnings = reshapesSkeleton(opRecords)
-            ? await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, readPage, sentOps, 'new')
-            : [];
+        // Kuru koşu hiçbir şey yazmaz: iskelet bulgularının tamamını döner; yazım yalnız bu yamayla YENİ geleni.
+        const skeletonWarnings = tool === 'page_schema_validate'
+            ? await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, readPage, sentOps, 'audit')
+            : reshapesSkeleton(opRecords)
+                ? await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, readPage, sentOps, 'new')
+                : [];
         layoutWarnings = [...ordering.warnings, ...layoutWarnings, ...profileWarnings, ...skeletonWarnings];
+        return {
+            opRecords,
+            sentOps,
+            serverOps,
+            resolved,
+            removedEvents,
+            resized,
+            propTypes,
+            deletedFlows,
+            formWarnings,
+            flowWarnings,
+            flowsBeforePatch,
+            layoutWarnings,
+            readVersion: () => (typeof cachedPage?.version === 'string' ? cachedPage.version : undefined),
+            notes: [
+                ...batchEnvelopeNote(opened),
+                ...rootAddsNote(retargeted, PAGE_CONTAINER_ELEMENT_ID),
+                ...componentNameNote(normalized.names),
+                ...sectionNotes,
+                ...componentDefaultsNote(normalized.components),
+                ...validationNote(normalized.validations),
+                ...catalogNotes,
+                ...replacePropNote(normalized.props),
+                ...flexIndexOrderNote(ordering.moved),
+                ...mobileSpacingNote(spacing)
+            ]
+        };
+    };
+    server.registerTool('page_schema_validate', {
+        title: 'Sayfa şemasını doğrula (kuru çalıştırma)',
+        description: "Micro-op'ları kaydetmeden şemaya uygular ve doğrulama hatalarını (suggestions ile) döndürür; page_schema_patch öncesi planı test etmek için. page_schema_patch'in PLANINI koşar (PAGE-049): aynı ön kontroller — yazımın reddedeceği yamayı aynı mesajla, istek göndermeden reddeder — aynı onarım ve platforma aynı gövde; yazımın döneceği uyarılar (layoutWarnings, formWarnings, flowWarnings) burada da görünür.",
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid, ops: opsParam.optional(), operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı) — entity/microservice/workflow patch'leriyle aynı adı kullanabilmeniz için"), allowFlowDeletion: z.boolean().optional().describe('page_schema_patch\'e vereceğiniz değer: true ise akışı referanssız bırakan yama kuru koşuda da reddedilmez. Varsayılan false — yazım onu reddeder, kuru koşu da (G-21).') },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, allowFlowDeletion }) => {
+        const plan = await planPageWrite('page_schema_validate', { project, environment, applicationId, pageId, ops, operations, allowFlowDeletion });
+        const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
+            environment,
+            body: { ops: plan.serverOps }
+        })) ?? {});
+        // Yazımın yanıtında dönecek uyarılar kuru koşuda da görünür: plan aynı, yalnız istek farklı.
+        if (plan.deletedFlows.length > 0)
+            response.deletedFlows = plan.deletedFlows;
+        if (plan.resized.warnings.length > 0)
+            response.resizeWarnings = plan.resized.warnings;
+        if (plan.formWarnings.length > 0)
+            response.formWarnings = plan.formWarnings;
+        if (plan.flowWarnings.length > 0)
+            response.flowWarnings = plan.flowWarnings;
+        if (plan.layoutWarnings.length > 0)
+            response.layoutWarnings = plan.layoutWarnings;
+        Object.assign(response, applicationTypeField(plan.resolved));
+        return withNormalization(response, plan.notes);
+    }));
+    server.registerTool('page_schema_patch', {
+        title: 'Sayfa şemasına patch uygula',
+        description: "Micro-op'ları doğrulama duvarından geçirip TEK PATCH ile kaydeder; açık studio canvas'ları SignalR ile canlı güncellenir. İstek atomiktir: bir op reddedilirse hiçbiri yazılmaz. baseVersion (page_schema_get çıktısındaki version ya da önceki yamanın newVersion'ı) verilirse sayfa o sürümden beri değişmişse 409 döner ve hiçbir op uygulanmaz (stale plan koruması); verilmezse gateway yalnız bu çağrıda zaten okuduğu sayfanın sürümünü gönderir. Yanıttaki appliedPatch, her op'un şemada tam olarak hangi JSON Pointer'a dokunduğunu söyler; gövdesi VARSAYILAN OLARAK iskelettir (eklenen düğüm id/type/children'a iner) — tam gövde için view:'full'. Op'un gerçekten kaydedilip kaydedilmediğini gövde değil silentlyDropped söyler. Gateway ön kontrolleri (PAGE-006/008/016/032/037/051, set_prop_type gövdesi, move_component size) op başına toplanır: düşen HER op tek hata yanıtında rejectedOps[] ({ index, op, target, code, message }) ile listelenir ve hiçbir op gönderilmez — hepsini düzeltip listeyi bir kez yeniden gönderin.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            pageId: guid,
+            ops: opsParam.optional(),
+            operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı) — entity/microservice/workflow patch'leriyle aynı adı kullanabilmeniz için"),
+            baseVersion: z.string().optional().describe("page_schema_get çıktısındaki version ya da önceki page_schema_patch yanıtındaki newVersion; sayfa o sürümden beri değiştiyse 409 döner ve hiçbir op uygulanmaz"),
+            expectedUpdatedAt: z.string().optional().describe("Eski koruma: page_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz. baseVersion tercih edilir"),
+            allowFlowDeletion: z.boolean().optional().describe("true: bu yama bir akışı referanssız bırakacaksa yine de uygulanır. Varsayılan false — platform referanssız akışı KALICI siler ve gateway isteği önden reddeder (G-21). Silinen akışlar yanıtta deletedFlows ile listelenir."),
+            view: writeViewParam
+        },
+        annotations: updates
+    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, baseVersion, expectedUpdatedAt, allowFlowDeletion, view }) => {
+        const plan = await planPageWrite('page_schema_patch', { project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion });
+        const { opRecords, sentOps, serverOps, resolved, removedEvents, resized, propTypes, deletedFlows, formWarnings, flowWarnings, flowsBeforePatch, layoutWarnings } = plan;
         // Tek istek, tek sürüm: öykünülen op'lar 2026-09-14'e kadar ayrı GET + tam PUT çiftleriydi ve
         // yamadan ÖNCE yazılıyordu — PATCH reddedilse bile kalıcıydılar. Artık hepsi aynı atomik PATCH'te.
         // baseVersion yalnız biliniyorsa gider (ajanın verdiği ya da bu çağrıda zaten okunan sayfanınki):
         // sürümü öğrenmek için ayrı GET atılmaz, platform satırı her yamada kilitler.
-        const sentVersion = baseVersion ?? (typeof cachedPage?.version === 'string' ? cachedPage.version : undefined);
+        const sentVersion = baseVersion ?? plan.readVersion();
         const response = ((await platform.tenant('PATCH', project, `/pages/${applicationId}/${pageId}/schema`, {
             environment,
             body: { ops: serverOps, baseVersion: sentVersion }
@@ -1049,17 +1058,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             }
         }
         Object.assign(response, applicationTypeField(resolved));
-        return withWriteDiff(withNormalization(response, [
-            ...rootAddsNote(retargeted, PAGE_CONTAINER_ELEMENT_ID),
-            ...componentNameNote(normalized.names),
-            ...sectionNotes,
-            ...componentDefaultsNote(normalized.components),
-            ...validationNote(normalized.validations),
-            ...catalogNotes,
-            ...replacePropNote(normalized.props),
-            ...flexIndexOrderNote(ordering.moved),
-            ...mobileSpacingNote(spacing)
-        ]), opDrops);
+        return withWriteDiff(withNormalization(response, plan.notes), opDrops);
     }));
     server.registerTool('page_discover', {
         title: 'Tasarım ekranından sayfa iskeleti öner',
@@ -1166,6 +1165,9 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 summary.layoutWarnings = updateWarnings;
             return withNormalization(summary, schema === undefined ? [] : [...container.fixes, ...skeletonNotes, ...componentNameNote(named), ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved), ...mobileSpacingNote(spacing)]);
         }
+        // PAGE-051 yalnız gerçekten OLUŞTURAN dalda: `ifExists: 'update'` var olan sayfada page_update gibi
+        // davranır ve kayıtlı emekli düğüm yazılabilir kalmalıdır.
+        assertNoRetiredNodes(container.schema);
         if (templateRoot && layoutId === undefined)
             skeletonNotes = shellLessPageSkeleton(templateRoot);
         const response = await platform.tenant('POST', project, `/pages/${applicationId}`, {
@@ -1343,7 +1345,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
  */
 async function mobileSpacingForOps(platformName, ops, readSaved) {
     const fix = emptyMobileSpacingFix();
-    if (platformName !== 'mobile' || !ops.some(entry => entry.op === 'add_component' || entry.op === 'batch'))
+    if (platformName !== 'mobile' || !ops.some(entry => entry.op === 'add_component'))
         return fix;
     const saved = await readSaved().then(page => page.schema, () => undefined);
     if (saved !== undefined)

package/dist/tools/platformInfo.js

@@ -66,8 +66,9 @@ const guideRouting = {
     entity: "alan tipleri, ilişkiler, hazır entity'ler",
     page: 'sayfa/flow işleri; prop\'u veri kaynağına bağlama (connectData, Kural 1c-3); flex düzen prop grubu ve boyut modları (Kural 1f-2)',
     layout: 'yerleşim kabuğu: tek slot, views, dar ekranda yığılma, widthType fill/fixed/auto',
-    mobile: "mobil UYGULAMA (type:'mobile'): kurulum sırası (mobile_app_create), flex-only yerleşim, tipli stil, sekmeler (properties.mobile.tabs) ve çekmece, adım sözlüğü, MOB-* bulguları, page_screenshot device",
-    'mobile-publish': "mobil uygulamanın mağaza yayını: mobile_store_* / mobile_build_* akışı, ön kontrol P-01…P-11 (push kimlikleri dahil), derleme hata kodları, insanın Studio'da yaptıkları",
+    mobile: "mobil UYGULAMA (type:'mobile'): kurulum sırası (mobile_app_create), flex-only yerleşim, tipli stil, sekmeler (properties.mobile.tabs) ve çekmece, sayfa mount/focus olayları, MOB-* bulguları, page_screenshot device",
+    'mobile-steps': "mobil uygulamada cihaza dokunan akış adımları (redirect, alert, confirm, download, storage, setcookie, share, haptic, location, notification-*, permission, open-settings, back, ad-show, scan-code): mobildeki davranış, args sözleşmesi, Steps.<adım> sonucu; bildirim, izin, reklam ve konum tarifleri",
+    'mobile-publish': "mobil uygulamanın mağaza yayını: mobile_store_* / mobile_build_* akışı, ön kontrol P-01…P-14 (push kimlikleri, izinler, reklam ve kod tarama dahil), derleme hata kodları, insanın Studio'da yaptıkları",
     'mobile-layout': 'mobil ekranın mizanpajı — tek dil: güvenli alan, tek kaydırıcı, 16 dp kenar, gap ritmi, saydam/yüzeyli grup, genişlik, yarıçap/yazı ölçeği; MOB-015…021 reçeteleri ve layoutReport hiza ölçümü',
     component: 'komponent modeli, olay sözleşmeleri, appearance boyut sözlüğü (widthString/heightString)',
     html: 'hazır komponent yetmediğinde tek seferlik kaçış kapısı (Mustache, fireEvent, script kuralları)',

package/dist/tools/profileWrite.js

@@ -48,8 +48,8 @@ async function pageShell(platform, project, environment, applicationId, layoutId
     }
 }
 /**
- * `set_event` ile bağlanan akışların adımları (MOB-005). Akış gövdeleri şemada değil ayrı uçtadır;
- * okunamazsa bulgu üretilmez, yazım yine geçer.
+ * `set_event` ile bağlanan akışların adımları (MOB-005). Akış gövdeleri şemada değil ayrı uçtadır; okunamazsa bulgu
+ * üretilmez, yazım yine geçer. `ops` araç girişinde açılmış listedir (PAGE-048): `batch` zarfı buraya ulaşmaz.
  */
 export async function boundFlowSteps(platform, resolved, project, environment, host, applicationId, hostId, ops) {
     if (resolved.profile.platform === 'web')