@appaflytech/zeyrek-ai-mcp 0.0.28 → 0.0.30

package/dist/tools/schemaOps.js

@@ -1,7 +1,9 @@
 import { isFlexContainer, schemaOpValidationErrors, FLEX_LAYOUT_PROP_NAMES, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
 import { findNode, outlineAppliedPatch } from './screens.js';
 import { setPropTypeErrors } from '../knowledge/propTypes.js';
+import { connectDataOpIssues } from '../knowledge/connectDataDefinition.js';
 import { PlatformApiError } from '../platform/errors.js';
+import { jsonArray } from '../platform/jsonArray.js';
 import { z } from 'zod';
 /*
  * Şema micro-op'larının gateway tarafı: sayfa (`page_schema_patch`), layout (`layout_schema_patch`)
@@ -24,7 +26,7 @@ export function outlineWriteResponse(response) {
     if (Array.isArray(container.appliedPatch))
         container.appliedPatch = outlineAppliedPatch(container.appliedPatch);
 }
-export const opsParam = z.array(z.record(z.unknown())).describe("Micro-op listesi. Op sözlüğü: replace_prop {target, prop, value} (value ham değer, code sarmalı {type: 'code', ref: '{{ … }}'} ya da translation sarmalı {type: 'translation', ref: '<çeviri anahtarı>'} — prop tipini değiştirmek için komponenti silip yeniden EKLEMEYİN, ona yazan setter'ların hedefi silinir (FLOW-018); platform replace_prop'ta expression alanını OKUMAZ — gateway onu code sarmalına çevirir) | set_binding {target, prop, expression: '{{ Page.variables.x }}'} | add_component {parent (üst elementId ya da 'root'), index?, component} | remove_component {target} | move_component {target, parent, index?, position: {x, y}} (index ÇİZİM sırası değildir, runtime çocukları blocks.position'a göre (y, sonra x) çizer. page_schema_patch'te flex kapta gateway index'i görünen sıraya çevirir ve kardeş konumlarını yeniden yazar; ızgara kapta sırayı position.y verir, sona eklemeyen index PAGE-033 uyarısıdır. layout_schema_patch ve component_schema_patch bu çeviriyi YAPMAZ: orada sırayı position.y ile verin) | set_event {target, event, eventValue, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akış iki kez 422 duplicate-event. Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. set_event ile eventValue: null olay SİLMEZ, değersiz ölü kayıt bırakır. Olmayan olay 422 missing-event) | set_validations {target, validations: [{type, message, value, isActive}]} (komponentin validation listesini TAMAMEN değiştirir; boş dizi hepsini siler) | set_appearance {target, appearance: {heightType?, widthType?, tooltip?, background?, …}} (kurulu düğümün appearance'ına YALNIZ verilen alanları yazar, gerisini korur; null alanı temizler; bilinmeyen alan unknown-appearance-field ile reddedilir. GÖRÜNÜRLÜK appearance'ta DEĞİLDİR: gizlemek için replace_prop {target, prop: 'isHidden', value: true}, koşul için set_binding {prop: 'isHidden'} — add_component gövdesindeki appearance.isHidden'ı gateway props.isHidden'a taşır) | resize_component {target, size?: {w,h}, appearance?: {widthType,widthString,heightType,heightString}, states?: {isWrapper,isScrollable,isSticky,isDroppable,isFloating,isQuickStack}, breakpoint?: 1024} (gateway adı: platforma set_block {target, breakpoint, size} + set_appearance {target, appearance} + set_states {target, states} olarak gider — o üç op'u doğrudan da gönderebilirsiniz. move_component'e konan size reddedilir. Izgarada blocks[].size, flex'te appearance geçerlidir; ebeveynin düzeni yazılanı etkisiz kılıyorsa PAGE-019 uyarısı çıkar. states bir PROP DEĞİL düğüm alanıdır ve replace_prop onu yazamaz — düğümü silmeden isWrapper bayrağını değiştirmenin yolu budur). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op prop'un TİPİNİ yerinde değiştirir. Taşıyıcı alan tipe göre: static → data, code ve translation → ref (runtime data'yı her turda ezer, anahtar yalnız ref'te yaşar). Eksik taşıyıcı istek gönderilmeden reddedilir; page_schema_validate aynı kararı verir) | reorder {parent ('root' ya da elementId), order: [çocuk elementId'lerinin TAMAMI, yeni sırada]} (yalnız DİZİ sırasını değiştirir; çizim sırası blocks.position'dır — görünen sırayı değiştirmek için konumları set_block/move_component ile de yazın) | set_state_binding {target, binding: {name, expression, targets}} (ada göre ekler/değiştirir) | remove_state_binding {target, name} | batch {gestureId?, label?, ops: [...]} (iç içe batch yok). target = elementId. İstek atomiktir: tek op reddedilirse hiçbiri yazılmaz.");
+export const opsParam = 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} | remove_component {target} | move_component {target, parent, index?, position: {x, y}} (index ÇİZİM sırası değildir, runtime çocukları blocks.position'a göre (y, sonra x) çizer. page_schema_patch'te flex kapta gateway index'i görünen sıraya çevirir ve kardeş konumlarını yeniden yazar; ızgara kapta sırayı position.y verir, sona eklemeyen index PAGE-033 uyarısıdır. layout_schema_patch ve component_schema_patch bu çeviriyi YAPMAZ: orada sırayı position.y ile verin) | set_event {target, event, eventValue, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akışı ikinci kez bağlamak etkisizdir (unchanged; tekrar güvenli). Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. set_event ile eventValue: null olay SİLMEZ, değersiz ölü kayıt bırakır. Olmayan olay 422 missing-event) | set_validations {target, validations: [{type, message, value, isActive}]} (komponentin validation listesini TAMAMEN değiştirir; boş dizi hepsini siler) | set_appearance {target, appearance: {heightType?, widthType?, tooltip?, background?, …}} (kurulu düğümün appearance'ına YALNIZ verilen alanları yazar, gerisini korur; null alanı temizler; bilinmeyen alan unknown-appearance-field ile reddedilir. GÖRÜNÜRLÜK appearance'ta DEĞİLDİR: gizlemek için replace_prop {target, prop: 'isHidden', value: true}, koşul için set_binding {prop: 'isHidden'} — add_component gövdesindeki appearance.isHidden'ı gateway props.isHidden'a taşır) | resize_component {target, size?: {w,h}, appearance?: {widthType,widthString,heightType,heightString}, states?: {isWrapper,isScrollable,isSticky,isDroppable,isFloating,isQuickStack}, breakpoint?: 1024} (gateway adı: platforma set_block {target, breakpoint, size} + set_appearance {target, appearance} + set_states {target, states} olarak gider — o üç op'u doğrudan da gönderebilirsiniz. move_component'e konan size reddedilir. Izgarada blocks[].size, flex'te appearance geçerlidir; ebeveynin düzeni yazılanı etkisiz kılıyorsa PAGE-019 uyarısı çıkar. states bir PROP DEĞİL düğüm alanıdır ve replace_prop onu yazamaz — düğümü silmeden isWrapper bayrağını değiştirmenin yolu budur). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op prop'un TİPİNİ yerinde değiştirir. Taşıyıcı alan tipe göre: static → data, code ve translation → ref (runtime data'yı her turda ezer, anahtar yalnız ref'te yaşar). Eksik taşıyıcı istek gönderilmeden reddedilir; page_schema_validate aynı kararı verir) | reorder {parent ('root' ya da elementId), order: [çocuk elementId'lerinin TAMAMI, yeni sırada]} (yalnız DİZİ sırasını değiştirir; çizim sırası blocks.position'dır — görünen sırayı değiştirmek için konumları set_block/move_component ile de yazın) | set_state_binding {target, binding: {name, expression, targets}} (ada göre ekler/değiştirir) | remove_state_binding {target, name} | 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.");
 /**
  * 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
@@ -67,6 +69,29 @@ 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)
@@ -272,9 +297,44 @@ export function assertOpBodies(opRecords, propTypeOps) {
     if (sizedMoves.length > 0) {
         throw new PlatformApiError(`move_component yalnız 'position' uygular; gövdeye konan 'size' platformda SESSİZCE düşer (ölçüldü 2026-09-04, appliedPatch'te yalnız /blocks/0/position görünür). Boyut için resize_component kullanın: { op: 'resize_component', target: '<elementId>', size: { w, h } } — flex kapsayıcı içindeyse 'appearance'. Etkilenen hedefler: ${sizedMoves.map(entry => entry.target).join(' · ')}`, 400);
     }
+    const connectDataIssues = opRecords.flatMap(entry => connectDataOpIssues(entry).map(issue => `${issue.code} — ${issue.message}`));
+    if (connectDataIssues.length > 0)
+        throw new PlatformApiError(`Connect Data op gövdesi geçersiz (istek gönderilmedi): ${connectDataIssues.join(' · ')}`, 400);
     const validationIssues = schemaOpValidationErrors(opRecords);
     if (validationIssues.length > 0) {
         throw new PlatformApiError(`PAGE-016 — validation gövdesi eksik (istek gönderilmedi): ${validationIssues.join(' · ')}. `
             + "Çalışan biçim 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 }.", 400);
     }
 }
+/** İskelet kurallarının okuduğu prop'lar (düzen grubu dışında). */
+const SKELETON_PROPS = new Set(['edges', 'horizontal', 'refreshable', 'stickyHeader', 'isHidden']);
+/** Yama iskeleti değiştirebilir mi: yalnız o zaman kabuk okunur ve fark hesaplanır. */
+export function reshapesSkeleton(ops) {
+    return ops.some(entry => ['add_component', 'move_component', 'remove_component', 'set_appearance', 'set_states'].includes(String(entry.op))
+        || ((entry.op === 'replace_prop' || entry.op === 'set_binding') && (FLEX_LAYOUT_PROP_NAMES.has(String(entry.prop ?? '')) || SKELETON_PROPS.has(String(entry.prop ?? '')))));
+}
+/**
+ * `simulateLayoutOps`'un uygulamadığı ama iskeleti değiştiren op'lar: silme, görünüm, durum bayrakları ve
+ * iskelet prop'ları. Uygulanmasa yama "sabit boy verilen scroll-view"ü gerekçesiz, silinen app-bar'ı ikinci
+ * sayardı.
+ */
+export function applySkeletonOps(tree, ops) {
+    for (const entry of ops) {
+        const target = String(entry.target ?? '');
+        if (entry.op === 'remove_component')
+            removeNodeFromTree(tree, target);
+        if (entry.op === 'set_appearance' || entry.op === 'set_states') {
+            const node = findNode(tree, target);
+            const field = entry.op === 'set_appearance' ? 'appearance' : 'states';
+            const patch = entry[field];
+            if (node && patch && typeof patch === 'object')
+                node[field] = { ...node[field], ...patch };
+        }
+        if ((entry.op === 'replace_prop' || entry.op === 'set_binding') && SKELETON_PROPS.has(String(entry.prop ?? ''))) {
+            const node = findNode(tree, target);
+            const value = entry.op === 'set_binding' ? { type: 'code', ref: entry.expression } : entry.value;
+            if (node)
+                node.props = { ...node.props, [String(entry.prop)]: value && typeof value === 'object' ? value : { type: 'static', data: value } };
+        }
+    }
+}

package/dist/tools/screenWrite.js

@@ -1,6 +1,8 @@
-import { invalidScreenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, blockSizeNote, heightTypeNote, sizeStringNote } from '../knowledge/normalize.js';
+import { invalidScreenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, blockSizeNote, heightTypeNote, sizeStringNote, droppableStatesNote } from '../knowledge/normalize.js';
+import { catalogTypeRules, schemaCatalogErrors, schemaCatalogMessage } from '../knowledge/componentCatalog.js';
 import { FUNCTIONS_NAMESPACE } from '../knowledge/functionGuards.js';
-import { applyCatalogLayoutRules } from './components.js';
+import { reservedExpressionName } from '../knowledge/expressionPrelude.js';
+import { applyCatalogLayoutRules, applyCatalogLayoutRulesFrom, fetchCatalogComponents } from './components.js';
 import { PlatformApiError } from '../platform/errors.js';
 const GUARD_CODES = {
     page: { events: 'PAGE-011', widgets: 'PAGE-012', noun: 'sayfa', tree: 'schema' },
@@ -18,11 +20,16 @@ export function invalidComponentNames(nodes) {
         if (typeof name === 'string' && name.length > 0 && !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name.replace(/-/g, ''))) {
             found.push(`'${name}' (${node.elementId ?? '?'})`);
         }
-        else if (typeof name === 'string' && name.replace(/-/g, '') === FUNCTIONS_NAMESPACE) {
+        else if (typeof name === 'string' && reservedExpressionName(name) === FUNCTIONS_NAMESPACE) {
             // K1: preamble her komponent için `const <ad> = Components["<ad>"]` üretir; `Functions` adlı
             // komponent kullanıcı fonksiyonlarının ad alanını ezer ve sayfadaki her Functions.x() ölür.
             found.push(`'${name}' (${node.elementId ?? '?'}) — ayrılmış ad: ${FUNCTIONS_NAMESPACE} kullanıcı fonksiyonlarının ad alanıdır (K1)`);
         }
+        else if (typeof name === 'string' && reservedExpressionName(name) !== undefined) {
+            // ARC-143: runtime preamble adıyla çakışan komponenti uyarıyla eler — komponent sayfadaki hiçbir
+            // ifadede görünmez. Eşleme runtime'ın tire kuralıyla (yalnız ilk `-`) yapılır.
+            found.push(`'${name}' (${node.elementId ?? '?'}) — ayrılmış ad: ${reservedExpressionName(name)} ifade preamble'ının adıdır; runtime bu komponenti ifadelerden gizler (ARC-143)`);
+        }
         found.push(...invalidComponentNames(node.children));
     }
     return found;
@@ -35,9 +42,10 @@ export function invalidComponentNames(nodes) {
  * PAGE-009 ve PAGE-013'ün layout ayağı 2026-09-09'da eklendi: ikisi de yalnız sayfa yollarında
  * koşuyordu, oysa layout `views`'ü aynı runtime'dan geçer — bozuk ad o layout'a bağlı HER
  * sayfanın ifadelerini öldürür, iç içe repeater'ın geri yazma kırılması ise yapısaldır ve
- * barındıranın sayfa mı layout mu olduğuna bakmaz.
+ * barındıranın sayfa mı layout mu olduğuna bakmaz. `platform` yalnız PAGE-013 mesajının önerisini seçer
+ * (mobilde `grouped-list`); denetimlerin kendisi iki platformda aynıdır.
  */
-export function assertScreenWriteGuards(kind, screen) {
+export function assertScreenWriteGuards(kind, screen, platform) {
     const codes = GUARD_CODES[kind];
     const badEvents = invalidScreenEventNames(screen.events, codes.events);
     if (badEvents.length > 0)
@@ -49,12 +57,13 @@ export function assertScreenWriteGuards(kind, screen) {
     if (badNames.length > 0) {
         throw new PlatformApiError(`PAGE-009 — komponent adı JS tanımlayıcısı değil ya da ayrılmış (istek gönderilmedi): ${badNames.join(' · ')}. `
             + 'Runtime her komponent için `const <ad> = Components["<ad>"]` üretir; boşluklu ya da geçersiz bir ad '
-            + 'SAYFADAKİ TÜM ifadeleri "Missing initializer in const declaration" ile öldürür (layout adları her sayfaya sızar). '
+            + 'SAYFADAKİ TÜM ifadeleri "Missing initializer in const declaration" ile öldürür (layout adları her sayfaya sızar); '
+            + 'ifade preamble\'ının ayrılmış adını (Page, state, item, t, event, Row …) taşıyan komponent ise ifadelerden gizlenir. '
             + `name alanını elementId ile aynı yaz; okunabilir Türkçe başlık için props.title / props.text / props.label kullan (${codes.noun} ${codes.tree}).`, 400);
     }
     const nested = nestedRepeaterNodes(screen.schema);
     if (nested.length > 0)
-        throw new PlatformApiError(nestedRepeaterMessage(nested), 400);
+        throw new PlatformApiError(nestedRepeaterMessage(nested, platform), 400);
 }
 /**
  * Katalog kurallarını (blok sınırı · auto-height · boyut string'i) ağaca uygular ve
@@ -65,5 +74,25 @@ export async function screenCatalogNotes(platform, project, environment, applica
     if (!Array.isArray(nodes) || nodes.length === 0)
         return [];
     const catalog = await applyCatalogLayoutRules(platform, project, environment, applicationId, nodes);
-    return [...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes)];
+    return [...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes), ...droppableStatesNote(catalog.states)];
+}
+/**
+ * TB-123 / S2-33 — TAM ŞEMA yazan yolların kapısı: `screenCatalogNotes`'un yaptığı yerleşim
+ * normalizasyonuna katalog DOĞRULAMASINI ekler ve geçersiz enum/prop'ta isteği hiç göndermez.
+ *
+ * Neden yalnız bu yollarda: micro-op ucunda platformun kendi doğrulama duvarı zaten koşuyor
+ * (`invalid-enum-value` · `unknown-prop` · `invalid-appearance`), tam şema PUT/POST'unda ise
+ * koşmuyordu — aynı geçersiz değer bir yoldan 400, öbüründen 200 dönüyordu. Katalog okunamazsa
+ * doğrulama susar ve yazma eskisi gibi geçer: bilinmeyen sözlük yüzünden geçerli bir gövdeyi
+ * bloklamak, denetimi atlamaktan kötüdür.
+ */
+export async function assertScreenCatalog(platform, project, environment, applicationId, nodes, tool) {
+    if (!Array.isArray(nodes) || nodes.length === 0)
+        return [];
+    const components = await fetchCatalogComponents(platform, project, environment, applicationId).catch(() => []);
+    const errors = schemaCatalogErrors(nodes, catalogTypeRules(components));
+    if (errors.length > 0)
+        throw new PlatformApiError(schemaCatalogMessage(errors, tool), 400);
+    const catalog = applyCatalogLayoutRulesFrom(components, nodes);
+    return [...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes), ...droppableStatesNote(catalog.states)];
 }

package/dist/tools/screens.js

@@ -1,33 +1,115 @@
 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 { 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 = z.array(z.record(z.unknown()))
+export const schemaParam = jsonArray(z.array(z.record(z.unknown())))
     .describe('Komponent ağacı (DesignComponentManagementSchema listesi); verilmezse mevcut şema korunur');
-export const eventsParam = z.array(z.record(z.unknown()))
+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.");
+/**
+ * Şema ağacındaki TÜM düğümler (kök + iç içe çocuklar); page_get, page_create özeti, page_update
+ * ve page_schema_get aynı sayımı kullanır. Parçalı okumanın `deferred` yer tutucuları düğüm değildir.
+ */
+export function countSchemaNodes(nodes) {
+    return (nodes ?? []).reduce((total, node) => node.deferred === true ? total : total + 1 + countSchemaNodes(node.children), 0);
+}
+function schemaNodeKey(node) {
+    return typeof node.elementId === 'string' ? node.elementId : String(node.id);
+}
+function schemaNodeKeys(nodes) {
+    return (nodes ?? []).flatMap(node => [schemaNodeKey(node), ...schemaNodeKeys(node.children)]);
+}
+/** `stored` ağacında olup `sent` ağacında olmayan düğümlerin elementId'leri, ön-sırayla (PAGE-041). */
+export function missingElementIds(stored, sent) {
+    const kept = new Set(schemaNodeKeys(sent));
+    return schemaNodeKeys(stored).filter(key => !kept.has(key));
+}
+/**
+ * ZM-28: şemayı her biri `budgetChars` karakteri (JSON uzunluğu, `shrink` ile aynı ölçü) aşmayan
+ * parçalara böler. Ön-sıra ve deterministik: alt ağacı sığan düğüm BÜTÜN alınır, sığmayan kabuk olarak
+ * yazılır ve çocuklarına inilir; parçaların birleşimi orijinal şemanın birebir aynısıdır.
+ */
+export function splitSchemaIntoParts(schema, budgetChars) {
+    const parts = [];
+    let current = [];
+    let currentChars = 2;
+    const place = (item, chars) => {
+        if (current.length > 0 && currentChars + 1 + chars > budgetChars) {
+            parts.push(current);
+            current = [];
+            currentChars = 2;
+        }
+        currentChars += (current.length > 0 ? 1 : 0) + chars;
+        current.push(item);
+    };
+    const visit = (node, parentElementId, index) => {
+        const whole = { parentElementId, index, node };
+        const wholeChars = JSON.stringify(whole).length;
+        if (2 + wholeChars <= budgetChars) {
+            place(whole, wholeChars);
+            return;
+        }
+        const children = Array.isArray(node.children) ? node.children : [];
+        const shell = {
+            parentElementId,
+            index,
+            node: { ...node, children: children.map(child => ({ elementId: schemaNodeKey(child), deferred: true })) }
+        };
+        const shellChars = JSON.stringify(shell).length;
+        if (children.length === 0 || 2 + shellChars > budgetChars) {
+            throw new PlatformApiError(`'${schemaNodeKey(node)}' (${String(node.type)}) düğümünün kendi gövdesi ${children.length === 0 ? wholeChars : shellChars} karakter; parça bütçesi ${budgetChars} karakter olduğu için tek düğüm bile bir yanıta sığmıyor. Düğümün büyük prop'unu page_schema_patch (replace_prop) ile küçültün ya da parçalara bölün; sonra cursor:'0' ile yeniden okuyun.`, 400);
+        }
+        place(shell, shellChars);
+        children.forEach((child, childIndex) => visit(child, schemaNodeKey(node), childIndex));
+    };
+    schema.forEach((node, index) => visit(node, null, index));
+    if (current.length > 0 || parts.length === 0)
+        parts.push(current);
+    return parts;
+}
+/** Opak parçalı okuma cursor'ı: sürüm değişince eski cursor reddedilir. */
+export function encodeSchemaCursor(version, partIndex) {
+    return `${version}:${partIndex}`;
+}
+/** `'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))
+        return { partIndex: Number(cursor) };
+    const separator = cursor.lastIndexOf(':');
+    const partIndex = cursor.slice(separator + 1);
+    if (separator < 0 || !/^\d+$/.test(partIndex))
+        return undefined;
+    return { version: cursor.slice(0, separator), partIndex: Number(partIndex) };
+}
 /**
  * Ağacı yalnız kimlik alanlarına indirger; hedef aramak için okunur boyutta tutar.
  * `styleSource` verilirse (undefined DEĞİLSE) her düğüme efektif stil raporu da
  * yazılır: tema componentStyles → preset → düğümün kendi stili kaskadı.
  */
-export function summarize(node, styleSource) {
+export function summarize(node, styleSource, nativeTheme) {
     const summary = {
         id: node.id,
         elementId: node.elementId,
         name: node.name,
         type: node.type
     };
-    if (styleSource !== undefined) {
+    // 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 } : {}) };
+    }
+    else if (styleSource !== undefined) {
         const report = resolveNodeStyleReport(node, styleSource ?? undefined);
         if (report.resolvedStyle !== undefined)
             summary.resolvedStyle = report.resolvedStyle;
         summary.styleLayers = report.styleLayers;
     }
     if (Array.isArray(node.children) && node.children.length > 0) {
-        summary.children = node.children.map(child => summarize(child, styleSource));
+        summary.children = node.children.map(child => summarize(child, styleSource, nativeTheme));
     }
     return summary;
 }
@@ -96,6 +178,11 @@ export function flowPath(host, applicationId, hostId, flowId) {
             : `/components/${applicationId}/${hostId}/flows`;
     return flowId ? `${root}/${flowId}` : root;
 }
+/**
+ * Sayfa PUT gövdesi okunan sayfadan kurulur ve o sayfanın sürümünü `baseVersion` olarak taşır:
+ * platform sürümsüz sayfa PUT'unu reddeder (`plans/mobil-plantcare-acigi` b-05, K11). Gövde
+ * okunduğu andaki sayfanın üstüne yazar; ajanın planladığı sürümü `page_update` kendisi koyar.
+ */
 export function pageUpdateBody(page, overrides = {}) {
     const layout = (page.layout ?? {});
     return {
@@ -110,6 +197,9 @@ export function pageUpdateBody(page, overrides = {}) {
         middlewareIds: page.middlewareIds ?? [],
         roleIds: Array.isArray(page.roleIds) ? page.roleIds : identifiers(page.roles),
         layoutId: page.layoutId ?? layout.id ?? null,
+        baseVersion: page.version === undefined || page.version === null ? undefined : String(page.version),
+        isAnonymous: page.isAnonymous ?? false,
+        isLoginPage: page.isLoginPage ?? false,
         ...overrides
     };
 }

package/dist/tools/templates.js

@@ -48,7 +48,7 @@ export function registerTemplateTools(server, platform) {
         description: "Şablonun bir modüldeki kayıtlarını listeler (project_create'in templateOptions.filters'ını doldurmak için).",
         inputSchema: {
             id: guid,
-            module: z.string().describe("Module değeri: entity | microservice | workflow | page | layout | component | query | view | variable | global-function (fonksiyonlar, iki kaynak) | flow … (platform Module enum değeri, kebab-case)")
+            module: z.string().describe("Module değeri: entity | microservice | workflow | page | layout | component | query | view | variable | global-function (fonksiyonlar, iki kaynak) | flow | process-definition (yalnız aktif sürüm; kurulumda yeni kimlik, uygulama/workflow/sayfa/DTO kimlikleri yeniden eşlenir, var olan aynı slug'lı tanımda yeni sürüm yayınlanır ve uyarlama korunur) | business-calendar … (platform Module enum değeri, kebab-case)")
         },
         annotations: readOnly
     }, handle(config, ({ id, module }) => platform.org('GET', `/templates/${id}/items`, { query: { module } })));
@@ -77,6 +77,31 @@ export function registerTemplateTools(server, platform) {
             normalized.push(await defaultTemplateEnvironmentNote(platform, projectId));
         return withNormalization(await platform.org('POST', `/projects/${projectId}/templates`, { form }), normalized);
     }));
+    server.registerTool('template_application_create', {
+        title: 'Uygulamayı şablon olarak yayımla',
+        description: "Tek bir APPLICATION'dan yeni bir şablon sürümü üretir (POST /applications/{id}/templates). Sistem modülü şablonları (kompleks proje açılışında otomatik kurulanlar) uygulama kaynaklıdır: aynı ad + aynı applicationId ile çağırmak MEVCUT şablona yeni SÜRÜM ekler, template_create ise proje kaynaklı AYRI bir kayıt açar ve 'system_module_slug' işaretini taşımaz. 'systemModuleSlug' benzersizdir: başka bir şablonda kullanılıyorsa platform reddeder. environmentId boşsa platform projenin production OLMAYAN ilk environment'ını paketler.",
+        inputSchema: {
+            applicationId: guid,
+            name: z.string().min(1),
+            version: z.string().min(1).describe("Sürüm etiketi, ör. '1.0.0'"),
+            description: z.string().optional(),
+            changeLog: z.string().optional(),
+            systemModuleSlug: z.string().min(1).optional().describe("Sistem modülü işareti (ör. 'access'); kompleks proje açılışında otomatik kurulan şablonu bu alan belirler"),
+            environmentId: guid.optional().describe("Paketlenecek environment; boşsa production OLMAYAN ilk environment paketlenir")
+        },
+        annotations: writes
+    }, handle(config, async ({ applicationId, name, version, description, changeLog, systemModuleSlug, environmentId }) => {
+        const body = { name, version };
+        if (description)
+            body.description = description;
+        if (changeLog)
+            body.changeLog = changeLog;
+        if (systemModuleSlug)
+            body.systemModuleSlug = systemModuleSlug;
+        if (environmentId)
+            body.environmentId = environmentId;
+        return platform.org('POST', `/applications/${applicationId}/templates`, { body });
+    }));
     server.registerTool('template_check_updates', {
         title: 'Şablon güncellemesi var mı',
         description: 'Şablondan kurulmuş projenin kaynak şablonunda yeni sürüm var mı kontrol eder.',

package/dist/tools/translations.js

@@ -46,7 +46,7 @@ export function registerTranslationTools(server, platform) {
             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' }));
+        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]);
     }));

package/dist/tools/variables.js

@@ -1,11 +1,15 @@
 import { parseVariableEntries, mergeVariableEntries, withNormalization } from '../knowledge/normalize.js';
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
+import { STATE_STORAGE_KINDS } from '../knowledge/platform/profile.js';
+import { variableProfileWarnings } from './profileWrite.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
 const variablePath = (applicationId, pageId) => pageId ? `/variables/${applicationId}/${pageId}` : `/variables/${applicationId}`;
 const variablesParam = z.array(z.object({
     key: z.string().min(1).describe("Değişken adı; sayfada state.page.<key> ile okunur"),
-    value: z.unknown().describe('Herhangi bir JSON değeri; nesne verirseniz alanlarına state.page.<key>.<alan> ile erişilir')
+    value: z.unknown().describe('Herhangi bir JSON değeri; nesne verirseniz alanlarına state.page.<key>.<alan> ile erişilir'),
+    storage: z.enum(['memory', ...STATE_STORAGE_KINDS]).optional()
+        .describe("Değerin yaşadığı yer (yalnız mobil uygulamada uygulanır, MOB-014). Verilmezse kayıttaki tür korunur; yeni değişkende bellektir — state her sayfa açılışında buradaki value'dan başlar. 'device': cihaz deposu (AsyncStorage karşılığı), uygulama kapanıp açılınca son yazılan değer geri gelir. 'secure': güvenli depo (expo-secure-store), token gibi gizli ve küçük değerler için. 'memory': türü kaldırır. Çıkışta ikisi de silinir.")
 })).min(1).describe("Değişken listesi: [{ key: 'MyTest', value: { isActive: true } }]. Gateway bunu platformun beklediği JSON string'e çevirir.");
 const replaceParam = z.boolean().optional()
     .describe('true: seti komple bunlarla değiştir (diğer değişkenler silinir). Varsayılan false — gateway mevcut setle birleştirir.');
@@ -22,7 +26,7 @@ export function registerVariableTools(server, platform) {
         }
     };
     const write = async (method, { project, environment, applicationId, pageId, variables, replace }) => {
-        const incoming = variables.map(entry => ({ key: entry.key, value: entry.value ?? null }));
+        const incoming = variables.map(entry => ({ key: entry.key, value: entry.value, ...(entry.storage ? { storage: entry.storage } : {}) }));
         const existing = replace === true ? [] : await readEntries(project, environment, applicationId, pageId);
         const merged = mergeVariableEntries(existing, incoming, replace === true);
         const response = await platform.tenant(method, project, variablePath(applicationId, pageId), {
@@ -33,9 +37,11 @@ export function registerVariableTools(server, platform) {
                 data: JSON.stringify(merged.entries)
             }
         });
+        const platformWarnings = await variableProfileWarnings(platform, applicationId, merged.entries.filter(entry => incoming.some(current => current.key === entry.key)));
         return withNormalization({
             scope: pageId ? 'page' : 'application',
             variables: merged.entries.map(entry => entry.key),
+            ...(platformWarnings.length > 0 ? { platformWarnings } : {}),
             response
         }, [
             ...merged.fixes,
@@ -44,7 +50,7 @@ export function registerVariableTools(server, platform) {
     };
     server.registerTool('variable_list', {
         title: 'Değişkenleri getir',
-        description: "Application (pageId verilirse sayfa) değişken setini getirir. Platform seti tek kayıtta ve JSON STRING olarak tutar; gateway çözüp [{key, value}] dizisi döndürür. Sayfada okuma yolu: state.page.<key> (uygulama düzeyinde state.app.<key>).",
+        description: "Application (pageId verilirse sayfa) değişken setini getirir. Platform seti tek kayıtta ve JSON STRING olarak tutar; gateway çözüp [{key, value, storage?}] dizisi döndürür; storage yoksa değişken bellektedir. Sayfada okuma yolu: state.page.<key> (uygulama düzeyinde state.app.<key>).",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid.optional() },
         annotations: readOnly
     }, handle(config, async ({ project, environment, applicationId, pageId }) => ({
@@ -61,7 +67,7 @@ export function registerVariableTools(server, platform) {
     }, handle(config, ({ project, environment, applicationId }) => platform.tenant('GET', project, `/variables/${applicationId}/pages`, { environment })));
     server.registerTool('variable_create', {
         title: 'Değişken tanımla',
-        description: "Application (pageId verilirse sayfa) değişkeni tanımlar. Platform uygulama/sayfa başına TEK kayıt tutar ve seti komple değiştirir; gateway mevcut setle birleştirir (replace: true ile ezersiniz). Sayfada kullanım: prop { type:'code', ref:\"{{ state.page.<key>.<alan> }}\" } ya da flow'da value { type:'state', ref:'<key>' }.",
+        description: "Application (pageId verilirse sayfa) değişkeni tanımlar. Platform uygulama/sayfa başına TEK kayıt tutar ve seti komple değiştirir; gateway mevcut setle birleştirir (replace: true ile ezersiniz). Sayfada kullanım: prop { type:'code', ref:\"{{ state.page.<key>.<alan> }}\" } ya da flow'da value { type:'state', ref:'<key>' }. State varsayılan olarak BELLEKTEDİR: sayfa her açıldığında value'dan başlar. Mobil uygulamada kalıcı olması için variables[].storage verin (platform_guide('mobile') §Kalıcı state).",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -74,7 +80,7 @@ export function registerVariableTools(server, platform) {
     }, handle(config, input => write('POST', input)));
     server.registerTool('variable_update', {
         title: 'Değişken güncelle',
-        description: "Var olan değişken setini günceller (variable_create zaten kayıt varsa update'e düşer; ikisi de aynı sonucu verir). Anahtar bazında birleştirir, replace: true ile seti komple değiştirir.",
+        description: "Var olan değişken setini günceller (variable_create zaten kayıt varsa update'e düşer; ikisi de aynı sonucu verir). Anahtar bazında birleştirir, replace: true ile seti komple değiştirir. storage vermediğiniz değişkenin kayıttaki saklama türü korunur.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,

package/dist/tools/workflows.js

@@ -5,18 +5,20 @@ import { workflowOutline, resolvePart, resolvePatchOperations } from '../knowled
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
 import { policyRules, microfunctionStepFindings, workflowStepFindings, undefinedInputFieldFindings } from '../knowledge/rules.js';
+import { identityMiddlewareFindings } from '../knowledge/access.js';
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import { existingMatch, ifExistsParam, listAll, platformRename, withOutcome, withRename } from '../platform/ifExists.js';
 import { outlineWrite, recordWriteViewParam } from '../platform/writeView.js';
 import fastJsonPatch from 'fast-json-patch';
+import { jsonArray } from '../platform/jsonArray.js';
 import { z } from 'zod';
 import { constraintSummary } from '../knowledge/backendConstraints.js';
 import { unmappedMembers, introducedUnmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
 const workflowIfExistsParam = ifExistsParam('workflow', 'mevcut workflow\'u bu tanımla tam gövde günceller (id\'si korunur; workflow_update ile aynı yazma)');
 const policyOverrideParam = z.boolean().optional()
     .describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
-const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
+const patchOperationsParam = jsonArray(z.array(z.record(z.unknown())).min(1))
     .describe("RFC 6902 JSON Patch işlemleri. Step hedeflerken İNDEKS YERİNE SEÇİCİ kullanın: { op: 'replace', path: '/steps[id=<stepId>]/rule/expression', value: '…' } — saklanan steps sırası gönderdiğiniz sıra DEĞİLDİR, indeks yolu sessizce başka adımı yazar. Seçici gövde platforma gitmeden indekse çevrilir; çözülemezse istek hiç gönderilmez. '/steps[name=setUser]/rule/joins' ve düz '/steps/2/...' de kabul edilir; yanıt her op'un hangi adıma indiğini patchTargets ile döner.");
 /**
  * Platform `set-user` step'i için `StepRule.Name`'i BOŞ döndürür (adı sabit: 'user') ve DTO
@@ -123,7 +125,8 @@ export function registerWorkflowTools(server, platform) {
         const stepFindings = [
             ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
             ...await workflowStepFindings(platform, project, environment, applicationId, definition, definition.type, policyOverride),
-            ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride)
+            ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride),
+            ...await identityMiddlewareFindings(platform, project, environment, definition, definition.type, policyOverride)
         ];
         const bodyFindings = (operation) => evaluatePolicy(config, policyRules, 'workflow', definition, { operation, workflowKind: definition.type }, policyOverride);
         const createFindings = enforcePolicy([...bodyFindings('create'), ...stepFindings]);
@@ -164,7 +167,8 @@ export function registerWorkflowTools(server, platform) {
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride),
             ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
             ...await workflowStepFindings(platform, project, environment, applicationId, definition, definition.type, policyOverride),
-            ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride)
+            ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride),
+            ...await identityMiddlewareFindings(platform, project, environment, definition, definition.type, policyOverride)
         ]);
         const drift = unmappedMembers('UpdateWorkflowCommand', definition);
         const payload = await platform.tenant('PUT', project, `/workflows/${applicationId}/${id}`, { environment, body: definition });
@@ -186,7 +190,8 @@ export function registerWorkflowTools(server, platform) {
             ...evaluatePolicy(config, policyRules, 'workflow', patched, { operation: 'update', workflowKind: patched.type }, policyOverride),
             ...await microfunctionStepFindings(platform, project, environment, patched, patched.type, policyOverride),
             ...await workflowStepFindings(platform, project, environment, applicationId, patched, patched.type, policyOverride),
-            ...await undefinedInputFieldFindings(platform, project, environment, patched, patched.type, policyOverride)
+            ...await undefinedInputFieldFindings(platform, project, environment, patched, patched.type, policyOverride),
+            ...await identityMiddlewareFindings(platform, project, environment, patched, patched.type, policyOverride)
         ]);
         const drift = introducedUnmappedMembers('UpdateWorkflowCommand', (current?.data ?? current), patched);
         // Gövde değil FARK gönderilir: gateway normalizasyonları da op'a çevrilsin diye net diff
@@ -218,7 +223,7 @@ export function registerWorkflowTools(server, platform) {
     }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/workflows/clone/${id}`, { environment })));
     server.registerTool('workflow_preview', {
         title: 'Workflow önizle',
-        description: "Kaydedilmemiş workflow tanımını çalıştırır; kaydetmeden önce her akışı preview ile doğrulayın. definition = PreviewWorkflowCommand gövdesi. Test girdisi 'previewPayload' anahtarıyla verilir ('parameters'/'input' ÇALIŞMAZ), değişkenler 'previewVariables'. previewPayload STRING olmalıdır (JSON.stringify(...) ya da \"({ id: 1 })\") — nesne gönderilirse platform 'Unexpected end of input' ile 500 döner. Akışın parameterDtoId'si YOKSA previewPayload verilmez (platform 400 döner; gateway alanı düşürüp gatewayNormalized ile bildirir). Preview tek transaction'da koşar ve sonunda ROLLBACK edilir: table create/update step'leri kalıcı satır YAZMAZ (ölçüldü, İK koşusu W-1). Tek istisna code step içindeki dış HTTP çağrılarıdır — onlar geri alınamaz. Yanıt WorkflowPreviewDto: steps[] (her adım: step{id,name,type}, input[] ifade→değer, output, hasError, errorType, errorMessage, errorDetail, elapsedMilliseconds, nextStep, children[] loop/alt akış, automations[]), input, output, executionSuccess. executionSuccess YALNIZ son adıma bakar; gateway tüm ağacı tarayıp hata bulursa yanıta 'runtimeErrors' ekler — HTTP 200 akışın geçtiği anlamına gelmez, ÖNCE bu alana bakın; 'input' boşsa girdi hiç bağlanmamıştır. Kayıtlı bir akışı çalıştırmadan sınamak için workflow_get gövdesini (steps + kayıtlı previewPayload/previewVariables) olduğu gibi verin — Studio'nun Önizleme düğmesi de bunu yapar. Zamanlanmış işin akışında previewPayload vermeyin (iş girdisiz koşar); job geçmişi hatayı mesaj olarak yazar, adım izini burada görün (platform_guide('microservice') §Zamanlanmış işin gerçek sonucunu görmek). Okuma rehberi: platform_guide('workflow') §Önizleme çıktısını okumak. " + constraintSummary('PreviewWorkflowCommand'),
+        description: "Kaydedilmemiş workflow tanımını çalıştırır; kaydetmeden önce her akışı preview ile doğrulayın. definition = PreviewWorkflowCommand gövdesi. Test girdisi 'previewPayload' anahtarıyla verilir ('parameters'/'input' ÇALIŞMAZ), değişkenler 'previewVariables'. previewPayload STRING bir JavaScript İFADESİDİR ve parantezli nesne yazılır: \"({ id: 1 })\" — nesne gönderilirse platform 'Unexpected end of input' ile 500 döner; '{' ile başlayan metin blok olarak ayrıştırılır, 'JSON.stringify(…)' metni nesne değil string üretir — ikisi de sessizce input: {} ile koşardı ve WF-016 ile istek gitmeden durur (38/M-12). Akışın parameterDtoId'si YOKSA previewPayload verilmez (platform 400 döner; gateway alanı düşürüp gatewayNormalized ile bildirir). Preview tek transaction'da koşar ve sonunda ROLLBACK edilir: table create/update step'leri kalıcı satır YAZMAZ (ölçüldü, İK koşusu W-1). Tek istisna code step içindeki dış HTTP çağrılarıdır — onlar geri alınamaz. Yanıt WorkflowPreviewDto: steps[] (her adım: step{id,name,type}, input[] ifade→değer, output, hasError, errorType, errorMessage, errorDetail, elapsedMilliseconds, nextStep, children[] loop/alt akış, automations[]), input, output, executionSuccess. executionSuccess YALNIZ son adıma bakar; gateway tüm ağacı tarayıp hata bulursa yanıta 'runtimeErrors' ekler — HTTP 200 akışın geçtiği anlamına gelmez, ÖNCE bu alana bakın; 'input' boşsa girdi hiç bağlanmamıştır. Kayıtlı bir akışı çalıştırmadan sınamak için workflow_get gövdesini (steps + kayıtlı previewPayload/previewVariables) olduğu gibi verin — Studio'nun Önizleme düğmesi de bunu yapar. Zamanlanmış işin akışında previewPayload vermeyin (iş girdisiz koşar); job geçmişi hatayı mesaj olarak yazar, adım izini burada görün (platform_guide('microservice') §Zamanlanmış işin gerçek sonucunu görmek). Okuma rehberi: platform_guide('workflow') §Önizleme çıktısını okumak. " + constraintSummary('PreviewWorkflowCommand'),
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam, language: languageParam },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, definition, policyOverride, language }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "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"
   }
-}
+}