@appaflytech/zeyrek-ai-mcp 0.0.40 → 0.0.42

package/dist/tools/rows.js

@@ -53,9 +53,20 @@ const bulkBatchSize = 1000;
 const maxPathBytes = 50 * 1024 * 1024;
 const maxPathRows = 100_000;
 const pathParam = z.string().min(1).optional()
-    .describe("Gateway sürecinin okuyabildiği yerel `.json` (satır dizisi) ya da `.csv` dosyası; 'row'/'rows' ile birlikte verilmez. Satırlar ajan bağlamından HİÇ geçmez: gateway dosyayı okur, 1000'lik partilere böler ve ardışık toplu çağrı yapar. CSV ayracı ilk satırdan bulunur (`;` sayısı `,` sayısını geçerse `;`), değerler string gider ve tipe backend çevirir. 50 MB / 100.000 satır üstü reddedilir — o boyut import_analyze zinciridir.");
+    .describe("Gateway sürecinin okuyabildiği yerel `.json` (satır dizisi) ya da `.csv` dosyası; 'row'/'rows' ile birlikte verilmez. Satırlar ajan bağlamından HİÇ geçmez: gateway dosyayı okur, 1000'lik partilere böler ve ardışık toplu çağrı yapar; yanıt { written, batches, ids (platform döndürdüyse ilk 10), truncated } — tam id listesi için row_list. CSV ayracı ilk satırdan bulunur (`;` sayısı `,` sayısını geçerse `;`), değerler string gider ve tipe backend çevirir. 50 MB / 100.000 satır üstü reddedilir — o boyut import_analyze zinciridir.");
 const relationsByNameParam = z.boolean().optional()
     .describe("İlişki alanlarına id yerine GÖRÜNEN AD yazmayı açar: 'departman: \"Satış\"' hedef tablonun display ya da benzersiz alanında aranır ve id'ye çevrilir. Yalnız toplu yolda (rows / path) çalışır. Eşleşmeyen değer 422 döndürür ve hangi satırın hangi alanı olduğunu söyler — sessizce boş bırakmaz.");
+/**
+ * 37 S-4: `path` "satırlar ajan bağlamından hiç geçmez" der, ama toplu uç her partide yazdığı id'leri
+ * döndürünce yanıt dosyanın satır sayısı kadar id taşıyordu (82 satır → `ids[82]`). Dosya yolunda
+ * yanıt sayıdır; id'lerden yalnız ilk birkaçı örnek olarak kalır, tamamı row_list'tedir.
+ */
+const fileIdSample = 10;
+function withIdSample(outcome) {
+    if (!outcome.ids)
+        return outcome;
+    return { ...outcome, ids: outcome.ids.slice(0, fileIdSample), truncated: outcome.ids.length > fileIdSample };
+}
 function collectIds(payload, into) {
     const data = payload?.data;
     if (Array.isArray(data))
@@ -315,7 +326,7 @@ export function registerRowTools(server, platform) {
             const outcome = await writeInBatches(platform, 'POST', project, environment, headers, resolvedEntityId, bulkRows, rowContext, relationsByName);
             if (fileRows)
                 notes.push(`${path} okundu: ${fileRows.length} satır, ${Math.ceil(fileRows.length / bulkBatchSize)} parti.`);
-            return attachFindings(withUnmappedMembers(withNormalization(withResolved(outcome, resolver.resolved), notes), bulkDrift), [...shapeFindings, ...(fileRows ? [] : derivedRowFindings(bulkRows))]);
+            return attachFindings(withUnmappedMembers(withNormalization(withResolved(fileRows ? withIdSample(outcome) : outcome, resolver.resolved), notes), bulkDrift), [...shapeFindings, ...(fileRows ? [] : derivedRowFindings(bulkRows))]);
         }
         const body = { row, ...(wantedLocalizations ? { localizations: wantedLocalizations } : {}), ...(rowContext ? { rowContext } : {}) };
         const drift = unmappedMembers('CreateRowCommand', body);
@@ -384,7 +395,7 @@ export function registerRowTools(server, platform) {
             const outcome = await writeInBatches(platform, 'PUT', project, environment, headers, resolvedEntityId, bulkRows, rowContext, relationsByName);
             if (fileRows)
                 notes.push(`${path} okundu: ${fileRows.length} satır, ${Math.ceil(fileRows.length / bulkBatchSize)} parti.`);
-            return attachFindings(withUnmappedMembers(withNormalization(withResolved(outcome, resolver.resolved), notes), bulkDrift), [...shapeFindings, ...(fileRows ? [] : derivedRowFindings(bulkRows))]);
+            return attachFindings(withUnmappedMembers(withNormalization(withResolved(fileRows ? withIdSample(outcome) : outcome, resolver.resolved), notes), bulkDrift), [...shapeFindings, ...(fileRows ? [] : derivedRowFindings(bulkRows))]);
         }
         const body = { row, ...(localizations ? { localizations } : {}), ...(rowContext ? { rowContext } : {}) };
         const drift = unmappedMembers('UpdateRowCommand', body);

package/dist/tools/schemaOps.js

@@ -1,4 +1,5 @@
-import { isFlexContainer, schemaOpValidationErrors, FLEX_LAYOUT_PROP_NAMES, PAGE_CONTAINER_ELEMENT_ID, COMPONENT_BODY_RULE } from '../knowledge/normalize.js';
+import { isFlexContainer, schemaOpValidationErrors, FLEX_LAYOUT_PROP_NAMES, PAGE_CONTAINER_ELEMENT_ID, COMPONENT_BODY_RULE, RETIRED_TYPE_RULE } from '../knowledge/normalize.js';
+import { retiredComponent } from '../knowledge/componentCatalog.js';
 import { findNode, outlineAppliedPatch } from './screens.js';
 import { setPropTypeErrors } from '../knowledge/propTypes.js';
 import { connectDataOpIssues } from '../knowledge/connectDataDefinition.js';
@@ -26,13 +27,18 @@ export function outlineWriteResponse(response) {
     if (Array.isArray(container.appliedPatch))
         container.appliedPatch = outlineAppliedPatch(container.appliedPatch);
 }
-export const opsParam = jsonArray(z.array(z.record(z.unknown()))).describe("Micro-op listesi. Op sözlüğü: replace_prop {target, prop, value} (value ham değer, code sarmalı {type: 'code', ref: '{{ … }}'} ya da translation sarmalı {type: 'translation', ref: '<çeviri anahtarı>'} — prop tipini değiştirmek için komponenti silip yeniden EKLEMEYİN, ona yazan setter'ların hedefi silinir (FLOW-018); platform replace_prop'ta expression alanını OKUMAZ — gateway onu code sarmalına çevirir) | set_binding {target, prop, expression: '{{ Page.variables.x }}'} | add_component {parent (üst elementId ya da 'root'), index?, component: {elementId, name (= elementId), type, props, blocks: [{breakpoint: 1024, size: {w,h}, position: {x,y}}]}} (blocks ZORUNLU, gateway doldurmaz — blocks'suz ya da null blocks'lu düğüm istek gitmeden PAGE-037 ile reddedilir, platform onu kayıtta 500 NullReferenceException ile düşürürdü; flex kapta position yalnız sıradır; ifadede name okunur, elementId değil) | remove_component {target} | move_component {target, parent, index?, position: {x, y}} (index ÇİZİM sırası değildir, runtime çocukları blocks.position'a göre (y, sonra x) çizer. page_schema_patch'te flex kapta gateway index'i görünen sıraya çevirir ve kardeş konumlarını yeniden yazar; ızgara kapta sırayı position.y verir, sona eklemeyen index PAGE-033 uyarısıdır. layout_schema_patch ve component_schema_patch bu çeviriyi YAPMAZ: orada sırayı position.y ile verin) | set_event {target, event, eventValue, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akışı ikinci kez bağlamak etkisizdir (unchanged; tekrar güvenli). Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. set_event ile eventValue: null olay SİLMEZ, değersiz ölü kayıt bırakır. Olmayan olay 422 missing-event) | set_validations {target, validations: [{type, message, value, isActive}]} (komponentin validation listesini TAMAMEN değiştirir; boş dizi hepsini siler) | set_appearance {target, appearance: {heightType?, widthType?, tooltip?, background?, …}} (kurulu düğümün appearance'ına YALNIZ verilen alanları yazar, gerisini korur; null alanı temizler; bilinmeyen alan unknown-appearance-field ile reddedilir. GÖRÜNÜRLÜK appearance'ta DEĞİLDİR: gizlemek için replace_prop {target, prop: 'isHidden', value: true}, koşul için set_binding {prop: 'isHidden'} — add_component gövdesindeki appearance.isHidden'ı gateway props.isHidden'a taşır) | resize_component {target, size?: {w,h}, appearance?: {widthType,widthString,heightType,heightString}, states?: {isWrapper,isScrollable,isSticky,isDroppable,isFloating,isQuickStack}, breakpoint?: 1024} (gateway adı: platforma set_block {target, breakpoint, size} + set_appearance {target, appearance} + set_states {target, states} olarak gider — o üç op'u doğrudan da gönderebilirsiniz. move_component'e konan size reddedilir. Izgarada blocks[].size, flex'te appearance geçerlidir, blocks yine zorunlu; ebeveynin düzeni yazılanı etkisiz kılıyorsa PAGE-019 uyarısı çıkar. states bir PROP DEĞİL düğüm alanıdır ve replace_prop onu yazamaz — düğümü silmeden isWrapper bayrağını değiştirmenin yolu budur). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op prop'un TİPİNİ yerinde değiştirir. Taşıyıcı alan tipe göre: static → data, code ve translation → ref (runtime data'yı her turda ezer, anahtar yalnız ref'te yaşar). Eksik taşıyıcı istek gönderilmeden reddedilir; page_schema_validate aynı kararı verir) | reorder {parent ('root' ya da elementId), order: [çocuk elementId'lerinin TAMAMI, yeni sırada]} (yalnız DİZİ sırasını değiştirir; çizim sırası blocks.position'dır — görünen sırayı değiştirmek için konumları set_block/move_component ile de yazın) | set_state_binding {target, binding: {name, expression, targets}} (ada göre ekler/değiştirir) | remove_state_binding {target, name} | set_connect_data {target, path, ref, data?} (prop'u veri kaynağına BAĞLAR: değer { type: 'connectData', ref: <tanım>, data: <son satırlar> } olur; path düz prop 'rows', nesne içi 'config.series' ya da dizi öğesi 'series.1.data'; data verilmezse bağlı prop'un satırları korunur, bağlı olmayan prop'un statik satırları (iç içe sarmallar açılarak) son satır olarak taşınır — D-11; tanım şekli ve alt küme kuralları istek gitmeden denetlenir — PAGE-035 · CD-004; platform_guide('page') §Kural 1c-3) | remove_connect_data {target, path} (bağlantıyı kaldırır, değer static olur; son satırlar static öğelere sarılarak korunur) — bağlı prop'a replace_prop ile connectData sarmalı, set_binding ya da set_prop_type yazılmaz; replace_prop { value: [ham satırlar] } yalnız örnek satırları değiştirir (CD-005) | batch {gestureId?, label?, ops: [...]} (iç içe batch yok). target = elementId. İstek atomiktir: tek op reddedilirse hiçbiri yazılmaz.");
+export const opsParam = jsonArray(z.array(z.record(z.unknown()))).describe("Micro-op listesi. Op sözlüğü: replace_prop {target, prop, value} (value ham değer, code sarmalı {type: 'code', ref: '{{ … }}'} ya da translation sarmalı {type: 'translation', ref: '<çeviri anahtarı>'} — prop tipini değiştirmek için komponenti silip yeniden EKLEMEYİN, ona yazan setter'ların hedefi silinir (FLOW-018); platform replace_prop'ta expression alanını OKUMAZ — gateway onu code sarmalına çevirir) | set_binding {target, prop, expression: '{{ Page.variables.x }}'} | add_component {parent (üst elementId ya da 'root'), index?, component: {elementId, name (= elementId), type, props, blocks: [{breakpoint: 1024, size: {w,h}, position: {x,y}}]}} (blocks ZORUNLU, gateway doldurmaz — blocks'suz ya da null blocks'lu düğüm istek gitmeden PAGE-037 ile reddedilir, platform onu kayıtta 500 NullReferenceException ile düşürürdü; katalogdan kaldırılan tip (component_list'te retired: true — ör. table) istek gitmeden PAGE-051 ile reddedilir, replacedBy tipini kullanın; flex kapta position yalnız sıradır; ifadede name okunur, elementId değil) | remove_component {target} | move_component {target, parent, index?, position: {x, y}} (index ÇİZİM sırası değildir, runtime çocukları blocks.position'a göre (y, sonra x) çizer. page_schema_patch'te flex kapta gateway index'i görünen sıraya çevirir ve kardeş konumlarını yeniden yazar; ızgara kapta sırayı position.y verir, sona eklemeyen index PAGE-033 uyarısıdır. layout_schema_patch ve component_schema_patch bu çeviriyi YAPMAZ: orada sırayı position.y ile verin) | set_event {target, event, eventValue, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akışı ikinci kez bağlamak etkisizdir (unchanged; tekrar güvenli). Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. set_event ile eventValue: null olay SİLMEZ, değersiz ölü kayıt bırakır. Olmayan olay 422 missing-event) | set_validations {target, validations: [{type, message, value, isActive}]} (komponentin validation listesini TAMAMEN değiştirir; boş dizi hepsini siler) | set_appearance {target, appearance: {heightType?, widthType?, tooltip?, background?, …}} (kurulu düğümün appearance'ına YALNIZ verilen alanları yazar, gerisini korur; null alanı temizler; bilinmeyen alan unknown-appearance-field ile reddedilir. GÖRÜNÜRLÜK appearance'ta DEĞİLDİR: gizlemek için replace_prop {target, prop: 'isHidden', value: true}, koşul için set_binding {prop: 'isHidden'} — add_component gövdesindeki appearance.isHidden'ı gateway props.isHidden'a taşır) | resize_component {target, size?: {w,h}, appearance?: {widthType,widthString,heightType,heightString}, states?: {isWrapper,isScrollable,isSticky,isDroppable,isFloating,isQuickStack}, breakpoint?: 1024} (gateway adı: platforma set_block {target, breakpoint, size} + set_appearance {target, appearance} + set_states {target, states} olarak gider — o üç op'u doğrudan da gönderebilirsiniz. move_component'e konan size reddedilir. Izgarada blocks[].size, flex'te appearance geçerlidir, blocks yine zorunlu; ebeveynin düzeni yazılanı etkisiz kılıyorsa PAGE-019 uyarısı çıkar. states bir PROP DEĞİL düğüm alanıdır ve replace_prop onu yazamaz — düğümü silmeden isWrapper bayrağını değiştirmenin yolu budur). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op prop'un TİPİNİ yerinde değiştirir. Taşıyıcı alan tipe göre: static → data, code ve translation → ref (runtime data'yı her turda ezer, anahtar yalnız ref'te yaşar). Eksik taşıyıcı istek gönderilmeden reddedilir; page_schema_validate aynı kararı verir) | reorder {parent ('root' ya da elementId), order: [çocuk elementId'lerinin TAMAMI, yeni sırada]} (yalnız DİZİ sırasını değiştirir; çizim sırası blocks.position'dır — görünen sırayı değiştirmek için konumları set_block/move_component ile de yazın) | set_state_binding {target, binding: {name, expression, targets}} (ada göre ekler/değiştirir) | remove_state_binding {target, name} | set_connect_data {target, path, ref, data?} (prop'u veri kaynağına BAĞLAR: değer { type: 'connectData', ref: <tanım>, data: <son satırlar> } olur; path düz prop 'rows', nesne içi 'config.series' ya da dizi öğesi 'series.1.data'; data verilmezse bağlı prop'un satırları korunur, bağlı olmayan prop'un statik satırları (iç içe sarmallar açılarak) son satır olarak taşınır — D-11; tanım şekli ve alt küme kuralları istek gitmeden denetlenir — PAGE-035 · CD-004; platform_guide('page') §Kural 1c-3) | remove_connect_data {target, path} (bağlantıyı kaldırır, değer static olur; son satırlar static öğelere sarılarak korunur) — bağlı prop'a replace_prop ile connectData sarmalı, set_binding ya da set_prop_type yazılmaz; replace_prop { value: [ham satırlar] } yalnız örnek satırları değiştirir (CD-005) | batch {gestureId?, label?, ops: [...]} (yalnız gruplamadır: gateway zarfı açar, içindeki op'lar tek tek yazılmış gibi denetlenip düz listeyle gider — PAGE-048; iç içe batch yok). target = elementId. Op'lar yazıldıkları SIRAYLA uygulanır (resize_component / set_prop_type / remove_event dahil — PAGE-050): aynı yamada eklenen düğüm SONRAKİ op'un hedefi olabilir; bir olayın bağını değiştirirken önce remove_event, sonra add_event yazın. İstek atomiktir: tek op reddedilirse hiçbiri yazılmaz.");
 /**
  * PAGE-008 — `set_event` uydurma bir olay adıyla 200 döner ve bağ SESSİZCE ölü kalır: motor olayı
  * komponentin yaydığı adla eşleştirir, eşleşme yoksa akış hiç çalışmaz. Kontrol yalnız hedefin
  * tipini ve o tipin katalogdaki olay listesini pozitif olarak çözebildiğinde konuşur (okunan ağaçta
  * olmayan hedefler — sayfa yamasında layout düğümleri — ve katalogda olay tanımlamayan tipler
  * doğrulanmadan geçer).
+ *
+ * Emekli tipte KAYITLI düğümde liste yerine geçen bileşenden okunur (`RETIRED_COMPONENTS`): kayıt
+ * defteri `table`'ı eski olaylarıyla tutar ama runtime o düğümü `datatable` ile çizer. Kayıtlı
+ * tipten okununca denetim tersine dönüyordu — yayılan `rowDoubleClick` reddediliyor, hiç yayılmayan
+ * `doubleClick` geçip ölü bağ yazılıyordu (inceleme 2026-10-13).
  */
 export function unknownEventOps(ops, typesByElementId, eventsBySlug) {
     return ops
@@ -42,10 +48,11 @@ export function unknownEventOps(ops, typesByElementId, eventsBySlug) {
         const target = String(op.target ?? '');
         const event = String(op.event ?? '');
         const type = typesByElementId.get(target);
-        const declared = type ? eventsBySlug.get(type) : undefined;
+        const drawnAs = retiredComponent(type)?.replacedBy ?? type;
+        const declared = drawnAs ? eventsBySlug.get(drawnAs) : undefined;
         if (!event || !declared || declared.includes(event))
             return [];
-        return [`'${target}' (${type}) komponenti '${event}' diye bir olay YAYMAZ. Yaydıkları: ${declared.join(', ')}. Platform bu op'u 200 ile kabul eder ama bağ sessizce ölü kalır — akış hiçbir zaman çalışmaz. Doğru adı component_get(slug:'${type}') çıktısındaki events listesinden alın.`];
+        return [`'${target}' (${drawnAs === type ? type : `${type} — emekli tip, runtime ${drawnAs} ile çizer`}) komponenti '${event}' diye bir olay YAYMAZ. Yaydıkları: ${declared.join(', ')}. Platform bu op'u 200 ile kabul eder ama bağ sessizce ölü kalır — akış hiçbir zaman çalışmaz. Doğru adı component_get(slug:'${type}') çıktısındaki events listesinden alın.`];
     });
 }
 /**
@@ -54,14 +61,15 @@ export function unknownEventOps(ops, typesByElementId, eventsBySlug) {
  * toplanır ve tek yanıtta döner. Yama yine ATOMİKTİR — birbirine bağlı op'lar (add_component +
  * set_event) yarım kalmasın diye geçenler de gönderilmez.
  */
-export function rejectedOpsMessage(unordered) {
+export function rejectedOpsMessage(unordered, indexHint = '') {
     const rejected = [...unordered].sort((left, right) => left.index - right.index);
     const lines = rejected.map(entry => `#${entry.index} ${entry.op}${entry.target ? ` '${entry.target}'` : ''} [${entry.code}]: ${entry.message}`);
     const validationHint = rejected.some(entry => entry.code === 'PAGE-016')
         ? " PAGE-016 çalışan biçimi dört alanı da taşır: { type: 'required'|'email'|'regex'|'max-length'|'min-length'|'max-value'|'min-value'|'value-options', message: '<kullanıcıya görünen metin>', value: <eşik/desen/true>, isActive: true }."
         : '';
     const bodyHint = rejected.some(entry => entry.code === 'PAGE-037') ? ` PAGE-037 ${COMPONENT_BODY_RULE}` : '';
-    return `Ön kontrol ${rejected.length} op'u reddetti; yama atomik olduğu için HİÇBİR op gönderilmedi (istek gönderilmedi). Düşen op'ları düzeltip TÜM listeyi tek çağrıda yeniden gönderin.${validationHint}${bodyHint}\n${lines.join('\n')}\nrejectedOps: ${JSON.stringify(rejected)}`;
+    const retiredHint = rejected.some(entry => entry.code === 'PAGE-051') ? ` PAGE-051 ${RETIRED_TYPE_RULE}` : '';
+    return `Ön kontrol ${rejected.length} op'u reddetti; yama atomik olduğu için HİÇBİR op gönderilmedi (istek gönderilmedi). Düşen op'ları düzeltip TÜM listeyi tek çağrıda yeniden gönderin.${indexHint}${validationHint}${bodyHint}${retiredHint}\n${lines.join('\n')}\nrejectedOps: ${JSON.stringify(rejected)}`;
 }
 export function collectTypes(nodes, into) {
     for (const node of nodes ?? []) {
@@ -70,29 +78,6 @@ export function collectTypes(nodes, into) {
         collectTypes(node.children, into);
     }
 }
-/**
- * TB-129 — `replace_prop` yalnız elementId taşır; stil anahtarı çevirisinin komponent TİPİNE
- * bakabilmesi için hedeflerin tipi okunan ağaçtan çıkarılır. Harita YALNIZ `style` prop'u yazan
- * bir op varsa kurulur: başka türlü fazladan bir okuma maliyeti doğardı.
- */
-export function styleTargetTypesFrom(ops, nodes) {
-    if (!ops.some(entry => entry.op === 'replace_prop' && String(entry.prop ?? '') === 'style'))
-        return undefined;
-    const types = new Map();
-    collectTypes(nodes, types);
-    return types;
-}
-/** Aynı harita, ağacı tembel okuyan yazma yolu için; okuma düşerse çeviri eski davranışa döner. */
-export async function styleTargetTypes(ops, readHost) {
-    if (!ops.some(entry => entry.op === 'replace_prop' && String(entry.prop ?? '') === 'style'))
-        return undefined;
-    try {
-        return styleTargetTypesFrom(ops, (await readHost()).schema);
-    }
-    catch {
-        return undefined;
-    }
-}
 export function removeNodeFromTree(nodes, target, parent) {
     for (let index = 0; index < nodes.length; index++) {
         if (nodes[index].elementId === target)
@@ -210,9 +195,11 @@ export function resizeServerOps(op) {
  * Sunucu hedefi ve bloğu kendisi doğrular; burada okunan sayfadan yapılan kontrol ajana bağlamı
  * olan bir mesaj ve PAGE-019/020 uyarıları içindir. `size` yalnız verilen kenarı taşır: eksik
  * kenar okunan bloktan tamamlanır, yoksa sunucu 0 yazardı.
+ * `groups` op başına çevrilmiş sunucu op'larıdır (girdiyle aynı sırada): `serverOpsInOrder` her birini kendi yerine koyar.
+ * Uyarı metni yazıldığını İDDİA ETMEZ ("yazılır", "yazılıyor"): aynı plan kuru koşuda da koşar (PAGE-049, TOOL-060).
  */
 export function planResizes(schema, ops, readTool = 'page_schema_get') {
-    const serverOps = [];
+    const groups = [];
     const applied = [];
     const warnings = [];
     for (const op of ops) {
@@ -249,13 +236,13 @@ export function planResizes(schema, ops, readTool = 'page_schema_get') {
             resolved = { ...op, size: merged };
             applied.push(`${target}.size=${JSON.stringify(merged)}`);
             if (inFlex) {
-                warnings.push(`PAGE-019 (uyarı): '${target}' düğümünün ebeveyni flex kapsayıcı; orada yerleşimi 'blocks[].size' DEĞİL appearance (widthType/widthString/heightType/heightString) belirler. Boyut yazıldı ama ekranda etkisi olmayabilir — flex'te ölçü vermek için aynı op'a 'appearance' koyun.`);
+                warnings.push(`PAGE-019 (uyarı): '${target}' düğümünün ebeveyni flex kapsayıcı; orada yerleşimi 'blocks[].size' DEĞİL appearance (widthType/widthString/heightType/heightString) belirler. Boyut yazılır ama ekranda etkisi olmayabilir — flex'te ölçü vermek için aynı op'a 'appearance' koyun.`);
             }
         }
         if (states) {
             applied.push(`${target}.states=${JSON.stringify(states)}`);
             if (states.isWrapper === true) {
-                warnings.push(`PAGE-020 (uyarı): '${target}' düğümüne isWrapper:true yazıldı — runtime sarmalayıcı düğüme 'min-height: 80vh' veriyor ve bu, sayfanın altına yüzlerce piksel ölü boşluk ekleyebilir (ölçüldü 09-05: dokuz düğüm ~1600px). style ile ezilemez; gerekmiyorsa isWrapper:false bırakın.`);
+                warnings.push(`PAGE-020 (uyarı): '${target}' düğümüne isWrapper:true yazılıyor — runtime sarmalayıcı düğüme 'min-height: 80vh' veriyor ve bu, sayfanın altına yüzlerce piksel ölü boşluk ekleyebilir (ölçüldü 09-05: dokuz düğüm ~1600px). style ile ezilemez; gerekmiyorsa isWrapper:false bırakın.`);
             }
         }
         if (appearance) {
@@ -264,9 +251,120 @@ export function planResizes(schema, ops, readTool = 'page_schema_get') {
                 warnings.push(`PAGE-019 (uyarı): '${target}' düğümünün ebeveyni flex DEĞİL; ızgarada yerleşimi 'blocks[].size' belirler ve appearance genişlik/yükseklik alanları etkisiz kalabilir. Izgarada ölçü vermek için aynı op'a 'size' koyun.`);
             }
         }
-        serverOps.push(...resizeServerOps(resolved));
+        groups.push(resizeServerOps(resolved));
+    }
+    return { serverOps: groups.flat(), groups, applied, warnings };
+}
+/** Gateway'in listeden ayırıp kendisi çevirdiği / planladığı op'lar. */
+const EMULATED_OPS = new Set(['resize_component', 'set_prop_type', 'remove_event']);
+/**
+ * Yamanın ÇAĞIRANIN SIRASI: `allOps` (ajanın yazdığı liste) ile `records`'u (öykünülen op'lar ayrıldıktan sonra kalan,
+ * gateway'in yerinde onardığı liste) tek sıraya dizer. `records` `allOps`'ta olmayan op taşıyabilir — kutu bölümü
+ * anahtarı (BX-002, `expandSectionToggles`) eklediklerini tetikleyen op'un hemen arkasına yerleştirir; onlar
+ * tetikleyenle birlikte kalır. Eşleme nesne kimliğiyledir, sayarak değil: sayarken eklenen op hizayı kaydırıyor ve
+ * `[replace_prop, set_prop_type]` yine ters gidiyordu (inceleme 2026-10-10).
+ */
+export function callerSlots(allOps, records) {
+    const written = new Set(allOps);
+    const slots = [];
+    let cursor = 0;
+    for (const op of allOps) {
+        if (EMULATED_OPS.has(String(op.op))) {
+            slots.push({ emulated: op });
+            continue;
+        }
+        const at = records.indexOf(op, cursor);
+        if (at < 0)
+            continue;
+        let end = at + 1;
+        while (end < records.length && !written.has(records[end]))
+            end += 1;
+        for (let index = cursor; index < end; index += 1)
+            slots.push({ record: index });
+        cursor = end;
+    }
+    for (let index = cursor; index < records.length; index += 1)
+        slots.push({ record: index });
+    return slots;
+}
+/** `records` + `remove_event`'ler, çağıranın sırasıyla: akış silme planı (G-21) yamayı uygulanacağı sırayla benzetir. */
+export function recordsWithEventRemovals(slots, records) {
+    return slots.flatMap(slot => {
+        if ('record' in slot)
+            return records.slice(slot.record, slot.record + 1);
+        return slot.emulated.op === 'remove_event' ? [slot.emulated] : [];
+    });
+}
+/**
+ * Platforma giden liste, ÇAĞIRANIN SIRASIYLA: gateway'in öykündüğü op (`resize_component`, `set_prop_type`) kendi
+ * yerinde çevrilmiş hâliyle, `remove_event` olduğu gibi durur; flex sıra çevirisinin eklediği taşımalar
+ * (`flexIndexOrder` `trailing`) sona gelir. Platform op'ları sırayla uygular (`PageSchemaMicroOpApplier.Apply`).
+ * 2026-10-10'a dek öykünülen op'lar listenin BAŞINA alınıyordu (ayrı istekle önceden yazıldıkları günden kalma):
+ * `[replace_prop, set_prop_type]` ters gidiyor, son yazan statik değer oluyor ve bağ sessizce kayboluyordu —
+ * yanıt yine `propTypes: static → code` diyordu (inceleme, `test/page-dry-run-parity.test.ts`).
+ *
+ * `sent`, `records`'un giden hâlidir ve onunla aynı sıradadır (`orderByIndex` kopyalasa da sırayı korur, eklediklerini
+ * sona yazar).
+ */
+export function serverOpsInOrder(slots, parts) {
+    let records = 0;
+    let resized = 0;
+    let propTypes = 0;
+    const ordered = slots.flatMap(slot => {
+        if ('record' in slot) {
+            records += 1;
+            return parts.sent.slice(slot.record, slot.record + 1);
+        }
+        if (slot.emulated.op === 'resize_component')
+            return parts.resized[resized++] ?? [];
+        if (slot.emulated.op === 'set_prop_type')
+            return parts.propTypes.slice(propTypes, ++propTypes);
+        return [slot.emulated];
+    });
+    return [...ordered, ...parts.sent.slice(records)];
+}
+/**
+ * Öykünülen op'ların planı, ağacın O ANDAKİ hâline göre: yama sırayla benzetilir (ekleme, silme, taşıma, düzen prop'u,
+ * önceki `resize_component`'in yazdığı boyut) ve her `resize_component` / `set_prop_type` kendi sırasındaki ağaçta
+ * çözülür. Yalnız kayıtlı ağaca bakılırken `[add_component yeni, set_prop_type yeni]` "hedef bulunamadı" ile düşüyor,
+ * silinip yeniden eklenen düğümün eksik kenarı ESKİ düğümden tamamlanıyor, ardışık iki `resize_component`'in ikincisi
+ * birincinin yazdığı kenarı eziyordu. Öykünülen op yoksa ağaç kopyalanmaz.
+ */
+export function planEmulatedOps(schema, slots, records, readTool = 'page_schema_get') {
+    const resized = { groups: [], applied: [], warnings: [] };
+    const propTypes = { serverOps: [], applied: [] };
+    if (!slots.some(slot => 'emulated' in slot && slot.emulated.op !== 'remove_event'))
+        return { resized, propTypes };
+    const tree = structuredClone(schema);
+    for (const slot of slots) {
+        if ('record' in slot) {
+            const record = records[slot.record];
+            if (record?.op === 'remove_component')
+                removeNodeFromTree(tree, String(record.target ?? ''));
+            else if (record)
+                simulateLayoutOps(tree, [record]);
+            continue;
+        }
+        if (slot.emulated.op === 'resize_component') {
+            const plan = planResizes(tree, [slot.emulated], readTool);
+            const group = plan.groups[0] ?? [];
+            resized.groups.push(group);
+            resized.applied.push(...plan.applied);
+            resized.warnings.push(...plan.warnings);
+            for (const written of group.filter(entry => entry.op === 'set_block')) {
+                const blocks = findNode(tree, String(written.target))?.blocks;
+                const block = blocks?.find(entry => Number(entry?.breakpoint) === Number(written.breakpoint));
+                if (block)
+                    block.size = written.size;
+            }
+        }
+        if (slot.emulated.op === 'set_prop_type') {
+            const plan = planPropTypes(tree, [slot.emulated], readTool);
+            propTypes.serverOps.push(...plan.serverOps);
+            propTypes.applied.push(...plan.applied);
+        }
     }
-    return { serverOps, applied, warnings };
+    return { resized, propTypes };
 }
 /**
  * `set_prop_type` (P0-2) 2026-09-14'ten beri platformun op'u; taşıyıcı kuralı

package/dist/tools/screenWrite.js

@@ -1,4 +1,4 @@
-import { invalidScreenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, assertComponentBlocks, blockSizeNote, heightTypeNote, sizeStringNote, droppableStatesNote } from '../knowledge/normalize.js';
+import { invalidScreenEventNames, screenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, assertComponentBlocks, blockSizeNote, heightTypeNote, sizeStringNote, droppableStatesNote } from '../knowledge/normalize.js';
 import { catalogTypeRules, schemaCatalogErrors, schemaCatalogMessage } from '../knowledge/componentCatalog.js';
 import { FUNCTIONS_NAMESPACE } from '../knowledge/functionGuards.js';
 import { reservedExpressionName } from '../knowledge/expressionPrelude.js';
@@ -56,7 +56,7 @@ export function invalidComponentNames(nodes) {
  */
 export function assertScreenWriteGuards(kind, screen, platform) {
     const codes = GUARD_CODES[kind];
-    const badEvents = invalidScreenEventNames(screen.events, codes.events);
+    const badEvents = invalidScreenEventNames(screen.events, codes.events, screenEventNames(kind, platform));
     if (badEvents.length > 0)
         throw new PlatformApiError(`Geçersiz ${codes.noun} olayı (istek gönderilmedi): ${badEvents.join(' · ')}`, 400);
     const badWidgets = invalidWidgetTypeNodes(screen.schema, codes.widgets);
@@ -64,7 +64,7 @@ export function assertScreenWriteGuards(kind, screen, platform) {
         throw new PlatformApiError(`Geçersiz widget düğümü (istek gönderilmedi): ${badWidgets.join(' · ')}`, 400);
     assertComponentNames(kind, screen.schema);
     assertComponentBlocks(screen.schema);
-    const nested = nestedRepeaterNodes(screen.schema);
+    const nested = nestedRepeaterNodes(screen.schema, platform);
     if (nested.length > 0)
         throw new PlatformApiError(nestedRepeaterMessage(nested, platform), 400);
 }

package/dist/tools/screens.js

@@ -2,11 +2,12 @@ import { PlatformApiError } from '../platform/errors.js';
 import { resolveNodeStyleReport } from '../knowledge/styleResolve.js';
 import { nodeNativeStyle } from '../knowledge/styleResolveNative.js';
 import { jsonArray } from '../platform/jsonArray.js';
+import { prune } from '../platform/responses.js';
 import { z } from 'zod';
 export const hostParam = z.enum(['page', 'layout', 'component'])
     .describe("Akışın barındırıcısı: page | layout | component (widget de component'tir)");
 export const schemaParam = jsonArray(z.array(z.record(z.unknown())))
-    .describe("Komponent ağacı (DesignComponentManagementSchema listesi): her düğümde elementId, name (= elementId), type, blocks zorunlu — blocks: [{ breakpoint: 1024, size: { w, h }, position: { x, y } }], gateway doldurmaz (PAGE-037). Verilmezse mevcut şema korunur");
+    .describe("Komponent ağacı (DesignComponentManagementSchema listesi): her düğümde elementId, name (= elementId), type, blocks zorunlu — blocks: [{ breakpoint: 1024, size: { w, h }, position: { x, y } }], gateway doldurmaz (PAGE-037). Oluşturmada katalogdan kaldırılan tipte düğüm (component_list'te retired: true) PAGE-051 ile reddedilir. Verilmezse mevcut şema korunur");
 export const eventsParam = jsonArray(z.array(z.record(z.unknown())))
     .describe("Sayfa/layout düzeyi olaylar: [{ name, value }] — value bir flow id'sidir");
 export const modeParam = z.enum(['summary', 'subtree', 'full']).optional().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.");
@@ -75,6 +76,44 @@ export function splitSchemaIntoParts(schema, budgetChars) {
 export function encodeSchemaCursor(version, partIndex) {
     return `${version}:${partIndex}`;
 }
+/**
+ * ADR 0001 — `mode:'full'` okumanın sayfa ve layout ortak kapısı: sığan ağaç tam döner, sığmayan HATA
+ * verir (sessiz kırpma yok); `cursor` ile parçalar `items[]` olarak gelir, sürüm değişince 409.
+ * `allowTruncated:true` kırpmayı açıkça ister — global `shrink()` kırpar, `onTruncated` işaretler.
+ */
+export function readFullSchema(read) {
+    const nodeCount = countSchemaNodes(read.nodes);
+    if (read.cursor !== undefined) {
+        const decoded = decodeSchemaCursor(read.cursor);
+        if (!decoded)
+            throw new PlatformApiError(`cursor '${read.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 !== read.versionKey) {
+            throw new PlatformApiError(`${read.noun} bu cursor alındıktan sonra değişti (cursor sürümü '${decoded.version}', güncel sürüm '${read.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(read.nodes, Math.floor(read.maxResponseBytes * 0.75));
+        const items = parts[decoded.partIndex];
+        if (!items)
+            throw new PlatformApiError(`cursor '${read.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 {
+            ...read.base,
+            nodeCount,
+            part: { index: decoded.partIndex, count: parts.length, nodes: countSchemaNodes(items.map(item => item.node)) },
+            items,
+            ...(nextIndex < parts.length ? { nextCursor: encodeSchemaCursor(read.versionKey, nextIndex) } : {})
+        };
+    }
+    const full = { ...read.base, nodeCount, [read.field]: read.nodes };
+    const chars = (JSON.stringify(prune(full)) ?? '').length;
+    if (chars > read.maxResponseBytes) {
+        if (read.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(read.maxResponseBytes)} KB). Kırpılmış şema hangi düğümlerin düştüğünü söylemez ve geri yazılırsa ${read.noun === 'Sayfa' ? 'sayfa' : 'layout'} 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);
+        }
+        read.onTruncated?.();
+    }
+    return full;
+}
 /** `'0'` sürümsüz ilk parçadır; `<sürüm>:<parça>` sürümü taşır. Çözülemeyen cursor `undefined`. */
 export function decodeSchemaCursor(cursor) {
     if (/^\d+$/.test(cursor))
@@ -99,8 +138,8 @@ export function summarize(node, styleSource, nativeTheme) {
     };
     // Mobil uygulama: stil CSS değil React Native nesnesidir (`shell` kutu, `text` metin).
     if (nativeTheme !== undefined) {
-        const { shell, text, warnings } = nodeNativeStyle(node, nativeTheme, styleSource ?? undefined);
-        summary.nativeStyle = { shell, text, ...(warnings.length > 0 ? { warnings } : {}) };
+        const { shell, text, motion, bound, warnings } = nodeNativeStyle(node, nativeTheme, styleSource ?? undefined);
+        summary.nativeStyle = { shell, text, ...(motion ? { motion } : {}), ...(bound ? { bound } : {}), ...(warnings.length > 0 ? { warnings } : {}) };
     }
     else if (styleSource !== undefined) {
         const report = resolveNodeStyleReport(node, styleSource ?? undefined);

package/dist/tools/translations.js

@@ -1,14 +1,84 @@
-import { guid, projectParam, environmentParam, readOnly, updates } from './common.js';
+import { guid, projectParam, environmentParam, readOnly, writes, updates } from './common.js';
 import { handle } from '../platform/responses.js';
+import { PlatformApiError } from '../platform/errors.js';
 import { z } from 'zod';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
 import { readProjectLanguages, translationLanguageFindings } from '../knowledge/languages.js';
 import { policyRules } from '../knowledge/rules.js';
+import { readFile, writeFile } from 'node:fs/promises';
+import { basename, extname, resolve } from 'node:path';
+const isoLanguageCode = z.string().regex(/^[a-z]{2}$/, 'ISO 639-1 iki harfli küçük dil kodu (tr, en, de …); tr-TR gibi bölge ekli kod reddedilir');
 const translationKeyInput = z.object({
     key: z.string().min(1),
-    values: z.record(z.string().regex(/^[a-z]{2}$/, 'ISO 639-1 iki harfli küçük dil kodu (tr, en, de …); tr-TR gibi bölge ekli kod reddedilir'), z.string()).describe("Dil kodu (ISO 639-1, iki küçük harf) → çeviri metni. Platform kodu yalnız 184 kodluk ISO sözlüğüne göre doğrular (TR-001); PROJENİN languages listesine göre doğrulamaz — o bağı gateway kurar (TR-002)"),
+    values: z.record(isoLanguageCode, z.string()).describe("Dil kodu (ISO 639-1, iki küçük harf) → çeviri metni. Platform kodu yalnız 184 kodluk ISO sözlüğüne göre doğrular (TR-001); PROJENİN languages listesine göre doğrulamaz — o bağı gateway kurar (TR-002)"),
     componentId: guid.optional().describe("Çeviriyi belirli bir komponente bağlar; o komponent silinince kaydı da silinir")
 });
+/**
+ * ADR 0018 (zeyrek-backend/docs/adr/0018-ceviri-dosya-aktarimi.md) §4: çeviri dosyası platformda
+ * saklanmaz — içe aktarma ucu dosyanın kendisini multipart alır, dışa aktarma yalnız yerel yola
+ * yazılır. Sınır backend `TranslationConstants.ImportMaxFileBytes` ile aynıdır; aşan dosya gidip
+ * 422 almak yerine burada durur.
+ */
+const translationFileMaxBytes = 10 * 1024 * 1024;
+const xlsxContentType = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
+/**
+ * `translation_update { file }` kipi. Backend `POST /translations/{applicationId}/import`
+ * (`ImportTranslationsCommand`) dili kendisi projeye eklediği için TR-002 ön okuması yapılmaz.
+ */
+async function importTranslationFile(platform, { project, environment, applicationId, file, targetLanguage, dryRun }) {
+    const absolute = resolve(file);
+    if (extname(absolute).toLowerCase() !== '.xlsx') {
+        throw new PlatformApiError(`translation_update: file bir .xlsx dosyası olmalı (${absolute}). Çeviri dosyası yalnız Excel biçiminde içe aktarılır; biçimi translation_export'un ürettiği dosyadır.`);
+    }
+    let bytes;
+    try {
+        bytes = await readFile(absolute);
+    }
+    catch (error) {
+        throw new PlatformApiError(`translation_update: dosya okunamadı — ${absolute} (${error instanceof Error ? error.message : String(error)}). Yol gateway sürecinin çalıştığı makineye göre çözülür.`);
+    }
+    if (bytes.byteLength > translationFileMaxBytes) {
+        throw new PlatformApiError(`translation_update: dosya ${bytes.byteLength} B, platformun 10 MB çeviri dosyası sınırının üstünde. Dosyada resim ya da ek sayfa varsa kaldırın; yalnız Key / kaynak / hedef sütunları gerekir.`);
+    }
+    const response = await platform.tenant('POST', project, `/translations/${applicationId}/import`, {
+        environment,
+        multipart: [
+            { name: 'File', filename: basename(absolute), contentType: xlsxContentType, content: bytes },
+            { name: 'TargetLanguage', value: targetLanguage },
+            { name: 'DryRun', value: dryRun ? 'true' : 'false' }
+        ]
+    });
+    const result = response?.data ?? {};
+    const notes = [];
+    if (result.languageAdded) {
+        notes.push(`Hedef dil '${result.targetLanguage}' projeye bütün ortamlarda eklendi; production'da çeviriler deployment'la gelir, o zamana kadar varsayılan dile düşer (TR-004).`);
+    }
+    else if (result.dryRun && result.targetLanguageInProject === false) {
+        notes.push(`Hedef dil '${result.targetLanguage}' projede yok; dryRun olmadan yapılan çağrı onu projeye bütün ortamlarda ekleyecek (TR-004).`);
+    }
+    if ((result.unknownKeyCount ?? 0) > 0) {
+        notes.push(`${result.unknownKeyCount} key application'da yok ve açılmadı (${(result.unknownKeys ?? []).join(', ')}). Yeni key için keys kipini kullanın.`);
+    }
+    if (result.applicationMismatch) {
+        notes.push('Dosya başka bir application\'dan dışa aktarılmış (_zeyrek meta); yalnız bu application\'da bulunan key\'ler yazıldı.');
+    }
+    return { ...result, ...(notes.length > 0 ? { note: notes.join(' ') } : {}) };
+}
+/**
+ * 38 S-6: platform PUT yanıtında uygulamanın BÜTÜN sözlüğünü döner (`ArrayBaseResponse<TranslationDto>`;
+ * 3. çağrıda 226 satır, ~25 bin karakter) — tek anahtar eklemek bile tam sözlüğü ajan bağlamına
+ * sokuyordu. Yanıt yazılanın özetidir; sözlüğün kendisi translation_list'tedir. Örnek sınırı
+ * `row_*` path yanıtındaki id örneğiyle aynıdır (37 S-4).
+ */
+const writtenKeySample = 10;
+function translationWriteSummary(keys, deletedKeys) {
+    return {
+        written: keys.length,
+        ...(deletedKeys.length > 0 ? { deleted: deletedKeys.length } : {}),
+        keys: keys.slice(0, writtenKeySample).map(entry => entry.key),
+        truncated: keys.length > writtenKeySample
+    };
+}
 /**
  * Yazma öncesi projenin dil durumunu okur. Proje okunamazsa (uç düşer, yetki yoksa) kontrol
  * ATLANIR ve karar platforma kalır — `project_create`'in slug ön aramasındaki (PRJ-001) davranışın
@@ -30,24 +100,96 @@ export function registerTranslationTools(server, platform) {
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid },
         annotations: readOnly
     }, handle(config, ({ project, environment, applicationId }) => platform.tenant('GET', project, `/translations/${applicationId}`, { environment })));
+    server.registerTool('translation_export', {
+        title: 'Çevirileri Excel olarak dışa aktar',
+        description: "Application'ın bütün çeviri key'lerini çevirmene verilecek bir .xlsx dosyasına yazar: A Key · B kaynak dil (referans) · C hedef dil (hedefte değeri olan key'ler dolu gelir). Dosya YALNIZ outPath'e yazılır — Sürücü'ye yüklenmez, platformda iz kalmaz; içerik bağlama girmez, yanıt yol ve sayılardır ({ keys: application'daki key sayısı, targetMissing: hedefte boş olanlar }). Çevirmen C sütununu doldurduktan sonra dosyayı translation_update { file, targetLanguage, dryRun: true } ile önce sınayın, sonra dryRun olmadan içe aktarın; hedef dil projede yoksa içe aktarma onu projeye BÜTÜN ortamlarda ekler (TR-004). Ajan çeviriyi kendisi yapacaksa dosyaya gerek yok: translation_list → translation_update { keys }.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            targetLanguage: isoLanguageCode.describe("Çevirmenin dolduracağı hedef dil (C sütunu); başlığa 'Target Language (ES)' biçiminde yalnız çevirmen için yazılır — içe aktarma başlığı okumaz, dili translation_update'in targetLanguage'ı belirler"),
+            sourceLanguage: isoLanguageCode.optional().describe('Çevirmene referans olacak kaynak dil (B sütunu); verilmezse projenin varsayılan dili'),
+            missingOnly: z.boolean().optional().describe("true: yalnız hedef dilde değeri olmayan ya da boş key'ler yazılır"),
+            outPath: z.string().min(1).describe("Dosyanın yazılacağı yerel yol, .xlsx ile biter (zorunlu). Yol gateway sürecinin çalıştığı makineye göre çözülür; var olan dosya ezilir")
+        },
+        annotations: writes
+    }, handle(config, async ({ project, environment, applicationId, targetLanguage, sourceLanguage, missingOnly, outPath }) => {
+        if (sourceLanguage === targetLanguage) {
+            throw new PlatformApiError(`translation_export: kaynak ve hedef dil aynı ('${targetLanguage}'). sourceLanguage'ı başka bir dil yapın ya da vermeyip projenin varsayılan diline bırakın.`);
+        }
+        const absolute = resolve(outPath);
+        if (extname(absolute).toLowerCase() !== '.xlsx') {
+            throw new PlatformApiError(`translation_export: outPath .xlsx ile bitmeli (${absolute}); çeviri dosyası yalnız Excel biçiminde üretilir.`);
+        }
+        const response = await platform.tenantWithHeaders('GET', project, `/translations/${applicationId}/export`, {
+            environment,
+            expectBinary: true,
+            query: { targetLanguage, ...(sourceLanguage ? { sourceLanguage } : {}), ...(missingOnly ? { missingOnly } : {}) }
+        });
+        const payload = response.body;
+        try {
+            await writeFile(absolute, payload.bytes);
+        }
+        catch (error) {
+            throw new PlatformApiError(`translation_export: dosya yazılamadı — ${absolute} (${error instanceof Error ? error.message : String(error)}). Klasör var olmalı; yol gateway sürecinin çalıştığı makineye göre çözülür.`);
+        }
+        const listed = await platform.tenant('GET', project, `/translations/${applicationId}`, { environment });
+        const translations = listed?.data ?? [];
+        const keys = new Set(translations.map(translation => translation.key));
+        const translatedKeys = new Set(translations.filter(translation => translation.language === targetLanguage && (translation.value ?? '').trim() !== '').map(translation => translation.key));
+        const projectLanguages = readProjectLanguages(await platform.org('GET', `/p/${platform.resolveProject(project)}`).catch(() => undefined));
+        const fileName = /filename\*?=(?:UTF-8'')?"?([^";]+)"?/i.exec(response.headers['content-disposition'] ?? '')?.[1];
+        const notes = projectLanguages && !projectLanguages.languages.includes(targetLanguage)
+            ? [`Hedef dil '${targetLanguage}' projenin dil listesinde yok; dosya içe aktarılınca proje diline bütün ortamlarda eklenir (TR-004).`]
+            : [];
+        notes.push(`Çevirmen C sütununu doldurduktan sonra: translation_update { file: '<yol>', targetLanguage: '${targetLanguage}', dryRun: true } → sonra dryRun olmadan.`);
+        return {
+            outPath: absolute,
+            fileName: fileName ?? basename(absolute),
+            bytes: payload.bytes.byteLength,
+            keys: keys.size,
+            targetMissing: keys.size - translatedKeys.size,
+            sourceLanguage: sourceLanguage ?? projectLanguages?.defaultLanguage,
+            targetLanguage,
+            note: notes.join(' ')
+        };
+    }));
     server.registerTool('translation_update', {
         title: 'Çevirileri güncelle',
-        description: "Bir ya da daha çok çeviri anahtarını toplu ekler/günceller (keys) ve/veya siler (deletedKeys) — tek çağrıda ikisi de verilebilir. 'keys' üzerinden yeni bir anahtar da açılabilir (upsert; verilmeyen diller silinmez, korunur). DİKKAT: çeviri yazmak tek başına YETMEZ — runtime bir etiketi ancak projenin languages listesi ve defaultLanguage kuruluysa çözer, aksi hâlde ekrana ham anahtar basar ve yazma yine 200 döner (ölçüldü 2026-09-09, S-15). Gateway yazmadan önce projeyi okur ve bağ kopuksa TR-002 caution'ı düşer; dilleri project_update(languages, defaultLanguage) ile kurun. Backend ön kontrolü (TR-001, block): anahtarlar boş olamaz ve tekil, dil kodları ISO 639-1 listesinden, deletedKeys boş olamaz.",
+        description: "Bir ya da daha çok çeviri anahtarını toplu ekler/günceller (keys) ve/veya siler (deletedKeys) — tek çağrıda ikisi de verilebilir. 'keys' üzerinden yeni bir anahtar da açılabilir (upsert; verilmeyen diller silinmez, korunur). DİKKAT: çeviri yazmak tek başına YETMEZ — runtime bir etiketi ancak projenin languages listesi ve defaultLanguage kuruluysa çözer, aksi hâlde ekrana ham anahtar basar ve yazma yine 200 döner (ölçüldü 2026-09-09, S-15). Gateway yazmadan önce projeyi okur ve bağ kopuksa TR-002 caution'ı düşer; dilleri project_update(languages, defaultLanguage) ile kurun. Backend ön kontrolü (TR-001, block): anahtarlar boş olamaz ve tekil, dil kodları ISO 639-1 listesinden, deletedKeys boş olamaz. Yanıt özettir: { written, deleted?, keys (yazılan ilk 10 anahtar), truncated } — platformun döndürdüğü tam sözlük bağlama taşınmaz, okumak için translation_list. DOSYA KİPİ: 'file' (yerel .xlsx yolu, translation_export biçimi) verilirse keys/deletedKeys verilmez; dosya platforma multipart gider ve SAKLANMAZ. C sütunu 'targetLanguage'ta verilen dile yazılır (zorunlu; başlık metni okunmaz — C1'deki '(ES)' gibi kod dili belirlemez): dolu hücre mevcut değeri EZER, boş hücre atlanır, application'da olmayan key açılmaz (unknownKeys); hedef dil projede yoksa projeye BÜTÜN ortamlarda eklenir (TR-004). 'dryRun: true' hiçbir şey yazmadan sayar. Yanıt: { targetLanguage, created, updated, unchanged, skippedEmpty, unknownKeyCount, unknownKeys, targetLanguageInProject, languageAdded, applicationMismatch, dryRun, note? }.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
             applicationId: guid,
             keys: z.array(translationKeyInput).optional().describe('Eklenecek/güncellenecek anahtarlar'),
-            deletedKeys: z.array(z.string().min(1)).optional().describe('Silinecek anahtar adları')
+            deletedKeys: z.array(z.string().min(1)).optional().describe('Silinecek anahtar adları'),
+            file: z.string().min(1).optional().describe("Çevirmenin doldurduğu yerel .xlsx yolu (en çok 10 MB): A Key, B kaynak dil (okunmaz), C hedef dil; başlık satırı okunmaz, dil targetLanguage'tan gelir. Gateway dosyayı okuyup içe aktarma ucuna gönderir, Sürücü'ye yüklemez. keys/deletedKeys ile birlikte verilmez"),
+            targetLanguage: isoLanguageCode.optional().describe("Yalnız file ile ve file verilince ZORUNLU: C sütununun yazılacağı dil (ISO 639-1, 'de'). Dosyanın başlığı dili belirlemez; projede yoksa dil projeye BÜTÜN ortamlarda eklenir (TR-004)"),
+            dryRun: z.boolean().optional().describe('Yalnız file ile: yazmadan created/updated/unchanged/skippedEmpty/unknownKeys sayımını ve dilin projeye eklenip eklenmeyeceğini döner')
         },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, keys, deletedKeys }) => {
+    }, handle(config, async ({ project, environment, applicationId, keys, deletedKeys, file, targetLanguage, dryRun }) => {
+        if (file !== undefined && (keys?.length || deletedKeys?.length)) {
+            throw new PlatformApiError("translation_update: 'file' ile 'keys'/'deletedKeys' birlikte verilmez — dosyayı ayrı bir çağrıda içe aktarın, tek tek anahtarları başka bir çağrıda yazın.");
+        }
+        if (dryRun !== undefined && file === undefined) {
+            throw new PlatformApiError("translation_update: dryRun yalnız 'file' kipinde geçerlidir; keys/deletedKeys yazımının kuru koşusu yoktur.");
+        }
+        if (targetLanguage !== undefined && file === undefined) {
+            throw new PlatformApiError("translation_update: targetLanguage yalnız 'file' kipinde geçerlidir; keys yazımında dil her değerin kendi anahtarıdır (values: { de: '…' }).");
+        }
+        if (file !== undefined && targetLanguage === undefined) {
+            throw new PlatformApiError("translation_update: 'file' kipinde targetLanguage zorunludur — C sütununun hangi dile yazılacağını dosya değil istek söyler (ör. targetLanguage: 'de'). Dosyanın başlığındaki '(DE)' okunmaz.");
+        }
+        if (file !== undefined)
+            return importTranslationFile(platform, { project, environment, applicationId, file, targetLanguage: targetLanguage, dryRun: dryRun ?? false });
         if (!keys?.length && !deletedKeys?.length) {
             throw new Error("'keys' ya da 'deletedKeys' parametrelerinden en az biri dolu olmalı.");
         }
         const body = { keys: keys ?? [], deletedKeys: deletedKeys ?? [] };
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'translation', body, { operation: 'update' }), false);
         const languages = await languageFindings(platform, project, keys ?? []);
-        return attachFindings(await platform.tenant('PUT', project, `/translations/${applicationId}`, { environment, body }), [...findings, ...languages]);
+        await platform.tenant('PUT', project, `/translations/${applicationId}`, { environment, body });
+        return attachFindings(translationWriteSummary(body.keys, body.deletedKeys), [...findings, ...languages]);
     }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.40",
+  "version": "0.0.42",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",
@@ -60,4 +60,4 @@
     "typescript": "^5.7.2",
     "vitest": "^3.0.0"
   }
-}
+}