@appaflytech/zeyrek-ai-mcp 0.0.41 → 0.0.43

package/dist/tools/components.js

@@ -1,8 +1,8 @@
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
-import { normalizeComponentDefaults, componentDefaultsNote, assertComponentBlocks, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, normalizeDroppableStates, withNormalization } from '../knowledge/normalize.js';
+import { normalizeComponentDefaults, assertNoRetiredNodes, componentDefaultsNote, assertComponentBlocks, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, normalizeDroppableStates, withNormalization } from '../knowledge/normalize.js';
 import { eventContractsFor, eventPayloadNote } from '../knowledge/componentEvents.js';
 import { componentPresetDefaults, readProjectTheme } from '../knowledge/themeSchema.js';
-import { knowledgeFor, knowledgeNote, APPEARANCE_TOKEN_SETS, STATE_FLAG_NOTES, INTERNAL_ROLES_BY_TYPE } from '../knowledge/componentCatalog.js';
+import { knowledgeFor, knowledgeNote, retiredComponent, APPEARANCE_TOKEN_SETS, STATE_FLAG_NOTES, INTERNAL_ROLES_BY_TYPE } from '../knowledge/componentCatalog.js';
 import { MOBILE_STATE_FLAG_NOTES, mobileComponentKnowledge } from '../knowledge/mobileComponentCatalog.js';
 import { mobileComponentEventContracts } from '../knowledge/mobileComponentEvents.js';
 import { componentUpdateBody, fetchHost, schemaParam, unwrap } from './screens.js';
@@ -184,7 +184,7 @@ export function registerComponentTools(server, platform) {
     const config = platform.config;
     server.registerTool('component_list', {
         title: 'Komponent sözlüğünü listele',
-        description: "Sayfaya konabilecek kayıtlı komponent tiplerini (slug, name, kategori, droppable) kompakt listeler; tek tipin tam sözlüğü + davranış bilgisi için component_get, komponent modelinin geneli için platform_guide('component'). scope:'all' platformun varsayılan kataloğunu da getirir.",
+        description: "Sayfaya konabilecek kayıtlı komponent tiplerini (slug, name, kategori, droppable) kompakt listeler; retired: true taşıyan tip katalogdan kaldırılmıştır, yerine replacedBy kullanılır; tek tipin tam sözlüğü + davranış bilgisi için component_get, komponent modelinin geneli için platform_guide('component'). scope:'all' platformun varsayılan kataloğunu da getirir.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -207,13 +207,16 @@ export function registerComponentTools(server, platform) {
                 categories: component.categories,
                 isDroppable: component.isDroppable,
                 kind: component.kind,
-                widgetType: component.widgetType
+                widgetType: component.widgetType,
+                ...(retiredComponent(typeof component.slug === 'string' ? component.slug : undefined)
+                    ? { retired: true, replacedBy: retiredComponent(String(component.slug)).replacedBy }
+                    : {})
             }))
         };
     }));
     server.registerTool('component_get', {
         title: 'Komponent sözlüğünü getir',
-        description: "Tek komponent tipinin tam sözlüğü: prop'lar (tip/enum/default), event'ler (yükleriyle), davranış bilgisi (knowledge) ve boyut sınırları. Şemaya uydurma prop yazmayın — yalnız burada dönenleri kullanın. Yanıtta guide alanı dönerse derin rehberi platform_guide ile okuyun (örn. html). slug ya da id ile çağrılır.",
+        description: "Tek komponent tipinin tam sözlüğü: prop'lar (tip/enum/default), event'ler (yükleriyle), davranış bilgisi (knowledge) ve boyut sınırları. Şemaya uydurma prop yazmayın — yalnız burada dönenleri kullanın. Yanıtta guide alanı dönerse derin rehberi platform_guide ile okuyun (örn. html). Yanıtta retired alanı dönerse tip katalogdan kaldırılmıştır (kayıt defterinde eşitleme silmediği için durur): o tipi yeni düğümde kullanmayın, replacedBy'ı kullanın. slug ya da id ile çağrılır.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -242,6 +245,7 @@ export function registerComponentTools(server, platform) {
             : [];
         const componentSlug = typeof component.slug === 'string' ? component.slug : undefined;
         const knowledge = knowledgeFor(componentSlug);
+        const retired = retiredComponent(componentSlug);
         // Mobil uygulamada kayıt mobil kataloğun satırıdır (`listComponents` type=mobile); davranış
         // notları web runtime'ından gelir (`knowledge` — mobil şema web sınıfını genişletir), bileşenin
         // mobil farkları `mobileKnowledge`'ta, bütün mobil bileşenlere geçen notlar `mobileNotes`'ta (G4).
@@ -262,6 +266,7 @@ export function registerComponentTools(server, platform) {
             slug: component.slug,
             name: component.name,
             description: component.description,
+            ...(retired ? { retired } : {}),
             kind: component.kind,
             widgetType: component.widgetType,
             isDroppable: component.isDroppable,
@@ -282,7 +287,7 @@ export function registerComponentTools(server, platform) {
             ...(componentSlug && INTERNAL_ROLES_BY_TYPE[componentSlug]
                 ? {
                     internalRoles: INTERNAL_ROLES_BY_TYPE[componentSlug],
-                    internalRolesNote: "Bu komponentin İÇ kontrolleri dışarıdan adreslenebilir: page_screenshot actions hedefine '<elementId>__<rol>' yazın (ör. 'tbl_vacancy__pager-next'). Kimlikler runtime'ın data-element-id özniteliğidir; ikinci bir mekanizma yoktur."
+                    internalRolesNote: "Bu komponentin İÇ kontrolleri dışarıdan adreslenebilir: page_screenshot actions hedefine '<elementId>__<rol>' yazın (ör. 'tabs_ayar__tab-genel'). Kimlikler runtime'ın data-element-id özniteliğidir; ikinci bir mekanizma yoktur."
                 }
                 : {}),
             ...(themeDefaults ? { themeDefaults } : {}),
@@ -322,6 +327,7 @@ export function registerComponentTools(server, platform) {
         if (body.kind === 'widget' && !body.widgetType) {
             throw new PlatformApiError("kind:'widget' için widgetType (container | modal | drawer) zorunludur.");
         }
+        assertNoRetiredNodes(body.schema);
         const wrapped = body.kind === 'widget' && body.widgetType && (body.schema ?? []).length > 0
             ? wrapWidgetRoot(body.schema ?? [], body.widgetType, await listComponents(platform, project, environment, applicationId).catch(() => []))
             : { schema: body.schema, notes: [] };

package/dist/tools/designSchemaPatch.js

@@ -1,5 +1,5 @@
-import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, normalizeSchemaOps, assertAddComponentIds, validationNote, componentNameNote, componentDefaultsNote, replacePropNote, flexSizeWarnings, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, verticalGapWarnings, withNormalization, FLEX_LAYOUT_PROP_NAMES } from '../knowledge/normalize.js';
-import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, styleTargetTypesFrom, simulateLayoutOps, removeNodeFromTree, planEventRemovals, planResizes, planPropTypes, assertOpBodies, applySkeletonOps, reshapesSkeleton } from './schemaOps.js';
+import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, normalizeSchemaOps, assertAddComponentIds, assertNoRetiredTypes, validationNote, componentNameNote, componentDefaultsNote, replacePropNote, flexSizeWarnings, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, verticalGapWarnings, withNormalization, FLEX_LAYOUT_PROP_NAMES } from '../knowledge/normalize.js';
+import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, removeNodeFromTree, planEventRemovals, callerSlots, planEmulatedOps, recordsWithEventRemovals, serverOpsInOrder, assertOpBodies, applySkeletonOps, reshapesSkeleton } from './schemaOps.js';
 import { guid, projectParam, environmentParam, updates, microOps } from './common.js';
 import { fetchHost, hostPath } from './screens.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
@@ -10,6 +10,7 @@ import { PlatformApiError } from '../platform/errors.js';
 import { connectDataOpIssues, connectedPropKeys } from '../knowledge/connectDataDefinition.js';
 import { handle } from '../platform/responses.js';
 import { slotWarning } from './layouts.js';
+import { batchEnvelopeNote, openBatchEnvelopes } from '../knowledge/platform/batchOps.js';
 import { applicationTypeField, resolveProfile } from '../knowledge/platform/resolve.js';
 import { boundFlowSteps, layoutPatchWarnings, screenProfileWarnings } from './profileWrite.js';
 import { z } from 'zod';
@@ -57,12 +58,14 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, ops, operations, allowFlowDeletion, view }) => {
-        const allOps = microOps(spec.tool, ops, operations).map(op => op);
+        const opened = openBatchEnvelopes(spec.tool, microOps(spec.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');
         const opRecords = allOps.filter(entry => !['remove_event', 'resize_component', 'set_prop_type'].includes(String(entry.op)));
         assertAddComponentIds(opRecords);
+        assertNoRetiredTypes(opRecords);
         const record = await fetchHost(platform, host, project, environment, applicationId, id);
         // Platform ucu kaydın türüne bakmaz: sıradan bir komponentin id'si verilirse kataloğundaki
         // tanımın yanına bir şema yazılırdı.
@@ -78,15 +81,13 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         const sectionToggles = expandSectionToggles(opRecords, nodes, sectionIds);
         const sectionNotes = boxSectionNote([...createdSections, ...sectionToggles.created], sectionToggles.removed);
         const events = host === 'layout' ? record.events : undefined;
-        // Normalizasyon kayıttan SONRA koşar: stil anahtarı çevirisi hedefin komponent TİPİNE bakar
-        // (TB-129, table.style.th/td kebab-case kalır) ve tip yalnız okunan ağaçta var. Gövde hataları
-        // bu yüzden bir okuma sonrasında rapor edilir; karar hiç değişmez, yalnız sıra değişti.
-        const normalized = normalizeSchemaOps(opRecords, styleTargetTypesFrom(opRecords, nodes));
+        const normalized = normalizeSchemaOps(opRecords);
         assertOpBodies(opRecords, propTypeOps);
         // CD-005 layout ve widget host'unda da: bağlı prop'u (iç içe yol dahil) ezen yazma ve bağlı olmayan prop'ta
         // remove_connect_data okunan ağaca bakarak reddedilir (gövde denetimi assertOpBodies'te koştu).
         const connectedProps = connectedPropKeys(nodes);
-        const connectionIssues = opRecords.flatMap(entry => connectDataOpIssues(entry, connectedProps).map(issue => `${issue.code} — ${issue.message}`));
+        // `set_prop_type` ayrı listededir; bağlı prop'u ezen yazımı o da yapar (sayfa yamasıyla aynı kapı).
+        const connectionIssues = [...opRecords, ...propTypeOps].flatMap(entry => connectDataOpIssues(entry, connectedProps).map(issue => `${issue.code} — ${issue.message}`));
         if (connectionIssues.length > 0)
             throw new PlatformApiError(`Connect Data op gövdesi geçersiz (istek gönderilmedi): ${connectionIssues.join(' · ')}`, 400);
         if (opRecords.some(entry => entry.op === 'set_event' || entry.op === 'add_event')) {
@@ -102,7 +103,9 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
                 throw new PlatformApiError(`PAGE-008 — geçersiz olay adı (istek gönderilmedi): ${unknown.join(' · ')}`, 400);
         }
         stripGatewayEventFields(opRecords);
-        const deletedFlows = orphanedFlowPlan(nodes, events, [...opRecords, ...removeEventOps]);
+        // Bölüm anahtarı op'larını yukarıda ekledi; buradan sonra `opRecords` yeni op almaz.
+        const slots = callerSlots(allOps, opRecords);
+        const deletedFlows = orphanedFlowPlan(nodes, events, recordsWithEventRemovals(slots, opRecords));
         if (deletedFlows.length > 0 && allowFlowDeletion !== true)
             throw new PlatformApiError(orphanedFlowMessage(deletedFlows), 400);
         const added = opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component);
@@ -120,7 +123,7 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         // her yamada koşsaydı kayıtlı ağacında zaten iç içe repeater olan layout hiç yamalanamazdı.
         const simulatable = opRecords.some(entry => ['add_component', 'move_component'].includes(String(entry.op))
             || (entry.op === 'replace_prop' && FLEX_LAYOUT_PROP_NAMES.has(String(entry.prop ?? ''))));
-        const nested = simulatable ? nestedRepeaterNodes(simulated) : [];
+        const nested = simulatable ? nestedRepeaterNodes(simulated, resolved.profile.platform) : [];
         if (nested.length > 0)
             throw new PlatformApiError(nestedRepeaterMessage(nested, resolved.profile.platform), 400);
         const reshaped = simulatable || opRecords.some(entry => entry.op === 'remove_component');
@@ -145,9 +148,10 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
             layoutWarnings.push(...layoutPatchWarnings(resolved, nodes, skeleton));
         }
         const removedEvents = planEventRemovals(removeEventOps);
-        const resized = resizeOps.length > 0 ? planResizes(nodes, resizeOps, spec.readTool) : { serverOps: [], applied: [], warnings: [] };
-        const propTypes = propTypeOps.length > 0 ? planPropTypes(nodes, propTypeOps, spec.readTool) : { serverOps: [], applied: [] };
-        const serverOps = [...removeEventOps, ...resized.serverOps, ...propTypes.serverOps, ...opRecords];
+        // Sayfa yamasıyla aynı iki söz (`pages.ts` `planPageWrite`, PAGE-050): öykünülen op ağacın o andaki hâline göre
+        // planlanır ve liste platforma çağıranın sırasıyla gider.
+        const { resized, propTypes } = planEmulatedOps(nodes, slots, opRecords, spec.readTool);
+        const serverOps = serverOpsInOrder(slots, { sent: opRecords, resized: resized.groups, propTypes: propTypes.serverOps });
         const response = ((await platform.tenant('PATCH', project, `${hostPath(host, applicationId, id)}/schema`, {
             environment,
             body: { ops: serverOps }
@@ -181,6 +185,7 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
             }
         }
         return withWriteDiff(withNormalization(response, [
+            ...batchEnvelopeNote(opened),
             ...componentNameNote(normalized.names),
             ...sectionNotes,
             ...componentDefaultsNote(normalized.components),

package/dist/tools/layouts.js

@@ -2,7 +2,7 @@ import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, u
 import { resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import fastJsonPatch from 'fast-json-patch';
-import { fillComponentNames, componentNameNote, normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
+import { fillComponentNames, componentNameNote, normalizeComponentDefaults, assertNoRetiredNodes, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
 import { fetchHost, layoutUpdateBody, schemaParam, eventsParam, modeParam, summarize, findNode, readFullSchema } from './screens.js';
 import { assertScreenWriteGuards, assertScreenCatalog } from './screenWrite.js';
 import { applyPropTypesToSchema, isSetPropTypeOp, setPropTypeErrors } from '../knowledge/propTypes.js';
@@ -15,7 +15,7 @@ import { jsonArray } from '../platform/jsonArray.js';
 import { z } from 'zod';
 const patchOperationsParam = jsonArray(z.array(z.record(z.unknown())).min(1))
     .describe("JSON Patch listesi (RFC 6902): { op, path, value }. Yol seçici alabilir — '/views/0/children[elementId=baslik]/props/content/data'.");
-const viewsParam = schemaParam.describe("Layout'un komponent ağacı: her düğümde elementId, name (= elementId), type, blocks zorunlu — blocks: [{ breakpoint: 1024, size: { w, h }, position: { x, y } }], gateway doldurmaz (PAGE-037). DİKKAT: layout'ta şema alanının adı 'schema' değil 'views'tir; ağaçta hedefli değişiklik için tam ağaç yerine layout_schema_patch micro-op'larını kullanın. İçinde MUTLAKA bir { type: 'slot' } komponenti olmalı — sayfa içeriği YALNIZ slot'un içine render edilir, slot'suz layout'a bağlanan sayfalar boş görünür. 2026-09-08'den beri views, page_schema_patch'in doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile REDDEDİLİR (kabul edilen değer listesiyle) ve hiçbir şey kaydedilmez — eskiden sessizce kaydediliyordu (P1-2).");
+const viewsParam = schemaParam.describe("Layout'un komponent ağacı: her düğümde elementId, name (= elementId), type, blocks zorunlu — blocks: [{ breakpoint: 1024, size: { w, h }, position: { x, y } }], gateway doldurmaz (PAGE-037). DİKKAT: layout'ta şema alanının adı 'schema' değil 'views'tir; ağaçta hedefli değişiklik için tam ağaç yerine layout_schema_patch micro-op'larını kullanın. İçinde MUTLAKA bir { type: 'slot' } komponenti olmalı — sayfa içeriği YALNIZ slot'un içine render edilir, slot'suz layout'a bağlanan sayfalar boş görünür. 2026-09-08'den beri views, page_schema_patch'in doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile REDDEDİLİR (kabul edilen değer listesiyle) ve hiçbir şey kaydedilmez — eskiden sessizce kaydediliyordu (P1-2). layout_create'te katalogdan kaldırılan tipte düğüm (component_list'te retired: true) PAGE-051 ile reddedilir.");
 function countSlots(nodes) {
     if (!Array.isArray(nodes))
         return 0;
@@ -118,6 +118,7 @@ export function registerLayoutTools(server, platform) {
         const resolved = await resolveProfile(platform, applicationId);
         const named = fillComponentNames(views);
         assertScreenWriteGuards('layout', { schema: views, events }, resolved.profile.platform);
+        assertNoRetiredNodes(views);
         const fixed = normalizeComponentDefaults(views);
         const catalogNotes = await assertScreenCatalog(platform, project, environment, applicationId, views, 'layout_create');
         const gaps = [
@@ -227,6 +228,10 @@ export function registerLayoutTools(server, platform) {
         const profile = await resolveProfile(platform, applicationId);
         const named = fillComponentNames(overrides.views);
         assertScreenWriteGuards('layout', { schema: overrides.views, events: overrides.events }, profile.profile.platform);
+        // PAGE-051: ağacın tamamı değil yalnız yamanın EKLEDİĞİ düğümler — kayıtlı emekli düğüm yazılabilir kalır.
+        assertNoRetiredNodes(resolved.operations
+            .filter(op => op.op === 'add' && /\/(views|children)\/(\d+|-)$/.test(String(op.path ?? '')))
+            .map(op => op.value));
         const fixed = normalizeComponentDefaults(overrides.views);
         const catalogNotes = await assertScreenCatalog(platform, project, environment, applicationId, overrides.views, 'layout_patch');
         const body = layoutUpdateBody({ ...current, applicationId }, overrides);

package/dist/tools/merges.js

@@ -11,8 +11,14 @@ const mergeDescription = z.string().trim().max(2000).optional()
     .describe("Dalda ne değişti ve neden merge edilmeli — gözden geçirene yazılan gövde. Merge bunu ASLA ezmez; opsiyoneldir ama açıklamasız istekte değişiklik listesi okunacak tek şey kalır.");
 const resolution = z.object({
     itemKey: z.string().min(1).describe("Plan kaydının anahtarı, ör. 'page:8f1c…' (merge_get çıktısındaki items[].key)"),
-    path: z.string().optional().describe("Eleman yolu, ör. 'components[elementId=btn_save].props[name=label].ref'; boş bırakılırsa o kaydın TÜM çakışmaları çözülür"),
-    choice: z.enum(['source', 'target']).describe("source = dal, target = development")
+    path: z.string().optional().describe("Eleman yolu, ör. 'components[elementId=btn_save].props[name=label].ref'; boş bırakılırsa o kaydın TÜM çakışmaları çözülür (custom'da yalnız kaydın tek çakışması varsa)"),
+    choice: z.enum(['source', 'target', 'both', 'custom']).describe("source = dal, target = development, both = iki tarafın birleşimi — yalnız combinable: true elemanda, birleşimi platform hesaplar; duplicate'te ikisini de tut demektir (slug taşıyan kopyada kapalı, combinable: false; base dolu kopyada source da kapalı). custom = value'daki değer"),
+    value: z.unknown().optional().describe("YALNIZ choice='custom' ile ve orada ZORUNLU: yazılacak değer. Türü (dizi/nesne/skaler) source ya da target ile aynı olmalı. Kök yolda kaydın gövdesidir, order-conflict'te kimlik listesidir, duplicate'te tek öğedir (kimliği development'ınki olur), tipi değişen prop'ta ('…props[id=…]') prop gövdesidir — valueType ile ref birlikte yazılır, kimliği yoldan gelir, statik listenin satırlarını (children) sunucu ref'ten kurar.")
+}).superRefine((entry, context) => {
+    if (entry.choice === 'custom' && entry.value === undefined)
+        context.addIssue({ code: 'custom', path: ['value'], message: "choice='custom' değer ister: yazılacak değeri value alanında gönderin" });
+    if (entry.choice !== 'custom' && entry.value !== undefined)
+        context.addIssue({ code: 'custom', path: ['value'], message: "value yalnız choice='custom' ile gönderilir; source / target / both değer taşımaz" });
 });
 /**
  * B-08 (2026-09-09 koşusu): `ResolveMergeConflictsCommandHandler` yanıtı
@@ -30,7 +36,7 @@ export function resolveSummary(payload, planId, requested) {
         ...(plan.status === undefined ? {} : { status: plan.status }),
         ...(plan.summary === undefined ? {} : { summary: plan.summary }),
         resolved: { requested, elements: resolvedElements },
-        note: "Yanıt ÖZETTİR — plan gövdesi kesildi. Planın kalan çakışmaları için merge_get { projectId, planId, view: 'conflicts' }; summary.unresolved 0 olduğunda merge_apply."
+        note: "Yanıt ÖZETTİR — plan gövdesi kesildi. Planın kalan çakışmaları için merge_get { projectId, planId, view: 'conflicts' }; summary.unresolved 0 olduğunda merge_apply. summary.duplicates çözümsüz olası kopyalardır: combinable: true olan kopya merge'ü engellemez (ikisi de yazılır), slug taşıyan kopya (combinable: false) ise summary.unresolved'a sayılır ve birini seçene kadar apply edilmez; merge_get { checks: true } okunmadan apply edilmez."
     };
 }
 export function registerMergeTools(server, platform) {
@@ -55,13 +61,27 @@ export function registerMergeTools(server, platform) {
     }, handle(config, ({ projectId, ...query }) => platform.org('GET', `/merges/${projectId}`, { query })));
     server.registerTool('merge_get', {
         title: 'Merge planını oku',
-        description: "Bir merge planını döner. items[] yalnız DEĞİŞEN kayıtları taşır; her kayıtta kind (add|update|delete|conflict) ve elements[] vardır. Çakışan elemanlarda base/source/target üç değeri birden gelir. dataRisk: true olan kalemde SEBEP dataRiskReasons[] içindedir: 'field-removed' (alan siliniyor), 'field-narrowed' (tip/nullable/unique daraltılıyor), 'not-null-without-default-on-populated-table' (hedefte satır varken varsayılansız NOT NULL alan ekleniyor — bu apply'ı DDL aşamasında düşürür, alanı nullable yapın ya da varsayılan verin), 'table-removed' (hedefte satırı olan tablo siliniyor). dataRisk bir UYARIDIR, apply'ı bloklamaz. items[].dependents[] ({ id, name, module }) dolu olan kalem, DALIN SİLDİĞİ ama development'ın dal açıldıktan sonra kullanmaya başladığı kayıttır: silme ÇAKIŞMAYA döner; hedef lehine çözüm kaydı ve bağımlısını korur, kaynak lehine çözüm siler (bağımlı FK ile düşebilir). Sorgunun çıktı DTO'su ve alanları aynı çakışma grubuna girer. Süreç kenarlarında (edges) iki taraf AYNI geçidin çıkışlarına dokunduysa yol 'versions[id=…].model.edges{from=<düğüm>}' olan TEK çakışma gelir; farklı geçitler kendiliğinden birleşir. Merge çevirileri (translation, adı 'key') ve microfunction'ları da taşır; microfunction hedefte TASLAK kalır, yayını kullanıcı yapar. derivedFromKey dolu olan kalem OTOMATİK ÜRETİLMİŞ bir kayıttır (varsayılan DTO); kaynağını (entity ya da query) çözdüğünüzde aynı yoldaki çakışması aynı tarafa KENDİLİĞİNDEN çözülür — ayrı ayrı ve zıt çözülemez. Uygulanmış planlarda title, description, createdBy ve appliedBy da gelir. kind=revert ise bu bir geri alma planıdır: revertsPlanId geri aldığı planı verir ve elements'te source merge ÖNCESİ, target ŞİMDİKİ değerdir. isStale: true ise plan alındığından beri DAL ya da development değişmiştir: items o değişikliği taşimaz ve merge_apply 409 döner — merge_refresh ile planı tazeleyin. elements[].isNoise: true olan eleman GÖSTERİM gürültüsüdür — kanvasın kendi durumu (workflow schema), DTO'dan türetilen şema (microservice schema.parameterScheme/returnScheme), sunucu yönetimli anahtar; merge gövdesinde KALIR ve uygulanır, yalnız okurken atlanır. Çakışan eleman asla işaretlenmez. items[].references[] o kalemin gövdesindeki guid'lerin karşılığıdır ({ id, name, module }): bir table step'in rule.entityId'si hangi tabloya, bir branch'in nextStepId'si hangi adıma, bir filtrenin fieldId'si hangi alana işaret ediyor — plan dışına çıkmadan okunur. items[].parentKey dolu olan kayıt başka bir kaydın çocuğudur (DTO çocukları, iç içe klasörler); ebeveyniyle birlikte okunur. items[].recordType kaydın modül içindeki türüdür — bir workflow kaydı 'workflow', 'automation' ya da 'middleware' olabilir ve modül üçüne de workflow der. items[].hiddenFields o kaydın GÖVDESİNDE okunmayacak anahtarlardır (aynı politika; eklenen/silinen kayıt tek eleman olarak geldiği için yolun değil anahtarın sorusudur).",
-        inputSchema: { projectId: guid, planId: guid, view: mergeView },
+        description: "Bir merge planını döner. items[] yalnız DEĞİŞEN kayıtları taşır; her kayıtta kind (add|update|delete|conflict) ve elements[] vardır. Çakışan elemanlarda base/source/target üç değeri birden gelir. dataRisk: true olan kalemde SEBEP dataRiskReasons[] içindedir: 'field-removed' (alan siliniyor), 'field-narrowed' (tip/nullable/unique daraltılıyor), 'not-null-without-default-on-populated-table' (hedefte satır varken varsayılansız NOT NULL alan ekleniyor — bu apply'ı DDL aşamasında düşürür, alanı nullable yapın ya da varsayılan verin), 'table-removed' (hedefte satırı olan tablo siliniyor). dataRisk bir UYARIDIR, apply'ı bloklamaz. items[].dependents[] ({ id, name, module }) dolu olan kalem, DALIN SİLDİĞİ ama development'ın dal açıldıktan sonra kullanmaya başladığı kayıttır: silme ÇAKIŞMAYA döner; hedef lehine çözüm kaydı ve bağımlısını korur, kaynak lehine çözüm siler (bağımlı FK ile düşebilir). Sorgunun çıktı DTO'su ve alanları aynı çakışma grubuna girer. Süreç kenarlarında (edges) iki taraf AYNI geçidin çıkışlarına dokunduysa yol 'versions[id=…].model.edges{from=<düğüm>}' olan TEK çakışma gelir; farklı geçitler kendiliğinden birleşir. Merge çevirileri (translation, adı 'key') ve microfunction'ları da taşır; microfunction hedefte TASLAK kalır, yayını kullanıcı yapar. derivedFromKey dolu olan kalem OTOMATİK ÜRETİLMİŞ bir kayıttır (varsayılan DTO); kaynağını (entity ya da query) çözdüğünüzde aynı yoldaki çakışması aynı tarafa KENDİLİĞİNDEN çözülür — ayrı ayrı ve zıt çözülemez. Uygulanmış planlarda title, description, createdBy ve appliedBy da gelir. kind=revert ise bu bir geri alma planıdır: revertsPlanId geri aldığı planı verir ve elements'te source merge ÖNCESİ, target ŞİMDİKİ değerdir. isStale: true ise plan alındığından beri DAL ya da development değişmiştir: items o değişikliği taşimaz ve merge_apply 409 döner — merge_refresh ile planı tazeleyin. elements[].isNoise: true olan eleman GÖSTERİM gürültüsüdür — kanvasın kendi durumu (workflow schema), DTO'dan türetilen şema (microservice schema.parameterScheme/returnScheme), sunucu yönetimli anahtar; merge gövdesinde KALIR ve uygulanır, yalnız okurken atlanır. Çakışan eleman asla işaretlenmez. items[].references[] o kalemin gövdesindeki guid'lerin karşılığıdır ({ id, name, module }): bir table step'in rule.entityId'si hangi tabloya, bir branch'in nextStepId'si hangi adıma, bir filtrenin fieldId'si hangi alana işaret ediyor — plan dışına çıkmadan okunur. items[].parentKey dolu olan kayıt başka bir kaydın çocuğudur (DTO çocukları, iç içe klasörler); ebeveyniyle birlikte okunur. items[].recordType kaydın modül içindeki türüdür — bir workflow kaydı 'workflow', 'automation' ya da 'middleware' olabilir ve modül üçüne de workflow der. items[].hiddenFields o kaydın GÖVDESİNDE okunmayacak anahtarlardır (aynı politika; eklenen/silinen kayıt tek eleman olarak geldiği için yolun değil anahtarın sorusudur). Bir taraf prop'un TİPİNİ (valueType: static → code) değiştirip öbür taraf da tipine ya da değerine (ref/data) dokunduysa eleman prop'un KENDİSİDİR: yol '…props[id=…]', base/source/target prop gövdesi, combinable: false — tip ile değer tek karardır. Nesne prop'unda (icon, surfaceStyle) anahtarın değeri '…ref.<anahtar>…', çizilen satırı '…children[name=<anahtar>]…' yolundadır; ikisi de çakışırsa kararı ref'e verin — satır karar istemez, unresolved'a sayılmaz; merge onu değerin birleşik hâlinden kurar. ÇÖZÜM DEĞER TAŞIR: elements[].combinable: true olan çakışma (kimliksiz ya da gruplu liste) both ile birleştirilebilir; elements[].value both/custom çözümünün yazılacak değeridir. kind='duplicate' OLASI KOPYADIR: iki taraf aynı içeriği farklı kimlikle eklemiş, twinPath development'taki ikizdir. combinable: true olan kopya ENGELLEMEZ — çözümsüzse ikisi de yazılır; kopyalar aynı slug'ı taşıyorsa (tablo alanı = kolon, sayfa = rota) combinable: false gelir, ikisi birden kalamaz: unresolved sayılır, both reddedilir, birini seçmek gerekir. Tablo alanında slug, bileşen prop'unda ad TEKİLDİR: içerik farklı olsa da aynı slug'lı alan ya da aynı adlı prop eklemesi combinable: false kopyadır; aynı ad farklı slug'lı iki alan ayrı eklenir (name-clash uyarısı). Development tabanda var olan bir alanı dalın eklediği slug'a yeniden adlandırdıysa dalın alanı yine duplicate gelir; base doludur (alanın taban hâli) ve source 400 döner — veri taşıyan alan silinmez, target ya da custom seçilir. target dalınkini düşürür, source development'ınkini çıkarır, custom tek öğe yazar; düşen kopyadan türemiş DTO alanı da düşer. summary.duplicates çözümsüz kopya sayısıdır. items[].derivedFromPath dolu olan DTO alanı tablo alanına bağlıdır (fields[id=…]); tablo alanı kararı ona kendiliğinden geçer. checks: true merge öncesi doğrulamayı da ekler: unresolved (error) · duplicate-open · name-clash (aynı adla iki kardeş) · dangling-reference (merge'ün düşürdüğü kimliğe kalan başvuru) — uyarılar engellemez, merge_apply'dan önce okunur.",
+        inputSchema: {
+            projectId: guid,
+            planId: guid,
+            view: mergeView,
+            checks: z.boolean().optional().describe("true ise planın merge öncesi doğrulaması (checks[]) yanıta eklenir; plan planned değilse boş gelir")
+        },
         annotations: readOnly
-    }, handle(config, ({ projectId, planId, view }) => platform.org('GET', `/merges/${projectId}/${planId}?view=${view ?? 'conflicts'}`)));
+    }, handle(config, async ({ projectId, planId, view, checks }) => {
+        const payload = await platform.org('GET', `/merges/${projectId}/${planId}?view=${view ?? 'conflicts'}`);
+        if (!checks)
+            return payload;
+        const checkPayload = await platform.org('GET', `/merges/${projectId}/${planId}/checks`);
+        return {
+            ...(payload && typeof payload === 'object' ? payload : { data: payload }),
+            checks: checkPayload?.data?.checks ?? []
+        };
+    }));
     server.registerTool('merge_resolve', {
         title: 'Merge çakışmalarını çöz',
-        description: "Çakışan elemanlar için dal (source) ya da development (target) seçimini plana yazar. Yalnız status=planned iken çalışır. path boş bırakılırsa o kaydın tüm çakışmaları aynı tarafa çözülür. YANIT ÖZETTİR: { planId, status, summary, resolved } — platform planın tamamını döner ama gateway onu kesip yalnız sayaçları verir (orta boy planda tam gövde 68-121 KB'a çıkıyor ve yanıt sınırını aşıyordu; çağrı hata gibi görünürken çözüm UYGULANMIŞ oluyordu). Planın kendisini görmek için merge_get { planId, view:'conflicts' } çağırın; kalan çakışma sayısı summary.unresolved'dadır.",
+        description: "Çakışan elemanlar ve olası kopyalar için kararı plana yazar: source (dal), target (development), both (iki tarafın birleşimi — yalnız combinable: true elemanda; kopyada ikisini de tut) ya da custom (value'daki değer). Yalnız status=planned iken çalışır. path boş bırakılırsa o kaydın tüm çakışmaları aynı karara çözülür. Türetilmiş kaydı (varsayılan DTO) kaynağına zıt çözmek 400 döner. YANIT ÖZETTİR: { planId, status, summary, resolved } — platform planın tamamını döner ama gateway onu kesip yalnız sayaçları verir (orta boy planda tam gövde 68-121 KB'a çıkıyor ve yanıt sınırını aşıyordu; çağrı hata gibi görünürken çözüm UYGULANMIŞ oluyordu). Planın kendisini görmek için merge_get { planId, view:'conflicts' } çağırın; kalan çakışma sayısı summary.unresolved'dadır.",
         inputSchema: { projectId: guid, planId: guid, resolutions: z.array(resolution).min(1) },
         annotations: updates
     }, handle(config, async ({ projectId, planId, resolutions }) => {
@@ -82,14 +102,14 @@ export function registerMergeTools(server, platform) {
     }));
     server.registerTool('merge_refresh', {
         title: 'Merge planını tazele',
-        description: "Açık bir planı dalın ve development'ın ŞU ANKİ hâline göre yeniden hesaplatır. İstek yerinde kalır: id'si, başlığı, açıklaması ve geçmişi korunur — yalnız değişiklik listesi yenilenir. KAYDEDİLMİŞ ÇAKIŞMA SEÇİMLERİ DÜŞER: yeni plan yeni elemanlar üretir, çözümler baştan verilir. Yalnız status=planned bir planda çalışır ve dal ready olmalıdır. Bayat bir planı (merge_get → isStale: true, ya da merge_apply 409) düzeltmenin yolu budur; merge_discard + merge_plan istemez. Asenkron: yanıt 202, plan planning durumundadır — merge_get ile planned bekleyin.",
+        description: "Açık bir planı dalın ve development'ın ŞU ANKİ hâline göre yeniden hesaplatır. İstek yerinde kalır: id'si, başlığı, açıklaması ve geçmişi korunur — yalnız değişiklik listesi yenilenir. DEĞİŞMEYEN ELEMANIN KARARI KORUNUR: aynı kalem, aynı yol ve üç tarafı (base/source/target) aynı kalan elemanın kararı ve değeri yeni plana taşınır; değişenler yeniden sorulur (etkinlikte merge.resolutions_carried { carried, dropped }). Yalnız status=planned bir planda çalışır ve dal ready olmalıdır. Bayat bir planı (merge_get → isStale: true, ya da merge_apply 409) düzeltmenin yolu budur; merge_discard + merge_plan istemez. Asenkron: yanıt 202, plan planning durumundadır — merge_get ile planned bekleyin.",
         inputSchema: { projectId: guid, planId: guid },
         annotations: writes
     }, handle(config, async ({ projectId, planId }) => {
         const payload = await platform.org('POST', `/merges/${projectId}/${planId}/refresh`);
         return {
             ...(payload && typeof payload === 'object' ? payload : { data: payload }),
-            note: "plan yeniden hesaplanıyor; merge_get ile status=planned bekleyin — çakışma çözümleri baştan verilir"
+            note: "plan yeniden hesaplanıyor; merge_get ile status=planned bekleyin — değişmeyen elemanların kararları korunur, yalnız değişenler yeniden sorulur"
         };
     }));
     server.registerTool('merge_revert', {