@appaflytech/zeyrek-ai-mcp 0.0.8 → 0.0.9

package/dist/tools/designSchemaPatch.js

@@ -0,0 +1,152 @@
+import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, staleSetterWarnings, normalizeSchemaOps, validationNote, componentDefaultsNote, replacePropNote, flexSizeWarnings, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, verticalGapWarnings, withNormalization, FLEX_LAYOUT_PROP_NAMES } from '../knowledge/normalize.js';
+import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, removeNodeFromTree, planEventRemovals, planResizes, planPropTypes, assertOpBodies } from './schemaOps.js';
+import { guid, projectParam, environmentParam, updates, microOps } from './common.js';
+import { fetchHost, hostPath } from './screens.js';
+import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
+import { schemaOpDrops, withWriteDiff } from '../platform/writeDiff.js';
+import { fetchComponentEventNames } from './components.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { handle } from '../platform/responses.js';
+import { slotWarning } from './layouts.js';
+import { z } from 'zod';
+const HOSTS = {
+    layout: {
+        tool: 'layout_schema_patch',
+        readTool: 'layout_schema_get',
+        tree: 'views',
+        kind: 'layout',
+        codes: { gap: 'LAY-003 (uyarı)', flexMismatch: 'LAY-007 (uyarı)', flexInvalid: 'LAY-008 (uyarı)' },
+        title: "Layout şemasına micro-op uygula",
+        description: "page_schema_patch'in layout karşılığı: micro-op'ları platformun PATCH /layouts/{app}/{id}/schema ucuna TEK istekle yazar; sunucu sayfa ile AYNI op sözlüğünü ve doğrulama kapsamını kullanır (dokunulan düğümler tam doğrulanır, geri kalan ağaç yapısal). İstek atomiktir: bir op reddedilirse hiçbiri yazılmaz. Op sözlüğü page_schema_patch ile birebir aynıdır; farklar: kök ekleme 'root' parent'ına gider (page_container yoktur), remove_event target:'page' layout düzeyi olayları hedefler, baseVersion yoktur (son yazan kazanır — hedefleri layout_schema_get ile okuyun). Slot'u silen ya da ikinci slot ekleyen yama LAY-002/LAY-006 uyarısı alır. Layout'un adı, parametreleri ve düz JSON Patch değişiklikleri için layout_patch; tam ağaç için layout_update."
+    },
+    component: {
+        tool: 'component_schema_patch',
+        readTool: 'component_get',
+        tree: 'schema',
+        kind: 'widget',
+        codes: { gap: 'PAGE-010 (uyarı)', flexMismatch: 'PAGE-017 (uyarı)', flexInvalid: 'PAGE-018 (uyarı)' },
+        title: 'Widget şemasına micro-op uygula',
+        description: "page_schema_patch'in widget karşılığı: widget kaydının (kind:'widget') kendi ağacına micro-op'ları platformun PATCH /components/{app}/{id}/schema ucuna TEK istekle yazar; sunucu sayfa ile AYNI op sözlüğünü ve doğrulama kapsamını kullanır. İstek atomiktir: bir op reddedilirse hiçbiri yazılmaz. Op sözlüğü page_schema_patch ile aynıdır; farklar: kök ekleme 'root' parent'ına gider, widget'ın düzey olayı olmadığı için remove_event yalnız komponent hedefler, baseVersion yoktur. id widget kaydının id'sidir (component_list / component_get). component_update tam gövde PUT'tur ve slug alır; ağaçta hedefli değişiklik için bu aracı kullanın."
+    }
+};
+/**
+ * Layout ve widget ağaçlarının micro-op yazması. Sayfa hattıyla (`page_schema_patch`) aynı istek
+ * öncesi kapılar koşar; sayfaya özgü olanlar (page_container koruması, kökten page_container'a
+ * yönlendirme, baseVersion) düşer. Kayıt her yamada BİR kez okunur: PAGE-008, G-21 ve boyut/tip
+ * planlaması okunan ağaca bakar, platformda sürüm koşulu olmadığı için okuma bir kilit değildir.
+ */
+export function registerDesignSchemaPatchTool(server, platform, host) {
+    const config = platform.config;
+    const spec = HOSTS[host];
+    server.registerTool(spec.tool, {
+        title: spec.title,
+        description: spec.description,
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            id: guid.describe(host === 'layout' ? "Layout id'si" : "Widget kaydının id'si (slug değil)"),
+            ops: opsParam.optional(),
+            operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı)"),
+            allowFlowDeletion: z.boolean().optional().describe(`true: bu yama bir akışı referanssız bırakacaksa yine de uygulanır. Varsayılan false — platform ${host === 'layout' ? 'layout' : 'widget'} kaydında da referanssız akışı KALICI siler ve gateway isteği önden reddeder (G-21).`),
+            view: writeViewParam
+        },
+        annotations: updates
+    }, handle(config, async ({ project, environment, applicationId, id, ops, operations, allowFlowDeletion, view }) => {
+        const allOps = microOps(spec.tool, ops, operations).map(op => op);
+        const removeEventOps = allOps.filter(entry => entry.op === 'remove_event');
+        const resizeOps = allOps.filter(entry => entry.op === 'resize_component');
+        const propTypeOps = allOps.filter(entry => entry.op === 'set_prop_type');
+        const opRecords = allOps.filter(entry => !['remove_event', 'resize_component', 'set_prop_type'].includes(String(entry.op)));
+        const normalized = normalizeSchemaOps(opRecords);
+        assertOpBodies(opRecords, propTypeOps);
+        const record = await fetchHost(platform, host, project, environment, applicationId, id);
+        // Platform ucu kaydın türüne bakmaz: sıradan bir komponentin id'si verilirse kataloğundaki
+        // tanımın yanına bir şema yazılırdı.
+        if (host === 'component' && record.kind !== 'widget' && !record.widgetType) {
+            throw new PlatformApiError(`component_schema_patch yalnız widget kaydına yazar; '${String(record.slug ?? id)}' bir widget değil (kind: ${String(record.kind ?? 'yok')}). Komponent kaydını component_update ile güncelleyin.`, 400);
+        }
+        const nodes = (record[spec.tree] ?? []);
+        const events = host === 'layout' ? record.events : undefined;
+        if (opRecords.some(entry => entry.op === 'set_event')) {
+            const typesByElementId = new Map();
+            collectTypes(nodes, typesByElementId);
+            collectTypes(opRecords.map(entry => entry.component).filter(Boolean), typesByElementId);
+            const eventsBySlug = await fetchComponentEventNames(platform, project, environment, applicationId).catch(() => new Map());
+            const unknown = unknownEventOps(opRecords, typesByElementId, eventsBySlug);
+            if (unknown.length > 0)
+                throw new PlatformApiError(`PAGE-008 — geçersiz olay adı (istek gönderilmedi): ${unknown.join(' · ')}`, 400);
+        }
+        const deletedFlows = orphanedFlowPlan(nodes, events, [...opRecords, ...removeEventOps]);
+        if (deletedFlows.length > 0 && allowFlowDeletion !== true)
+            throw new PlatformApiError(orphanedFlowMessage(deletedFlows), 400);
+        const added = opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component);
+        assertScreenWriteGuards(spec.kind, { schema: added });
+        const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, added);
+        const flowWarnings = opRecords.some(entry => entry.op === 'remove_component')
+            ? [...orphanedFlowWarnings(nodes, events, opRecords), ...staleSetterWarnings(Array.isArray(record.flows) ? record.flows : [], opRecords, nodes)]
+            : [];
+        const simulated = structuredClone(nodes);
+        for (const entry of opRecords.filter(entry => entry.op === 'remove_component'))
+            removeNodeFromTree(simulated, String(entry.target ?? ''));
+        const touched = simulateLayoutOps(simulated, opRecords);
+        // Sayfadaki `simulatable` ile aynı küme: iç içe repeater ancak ekleme/taşıma ile doğar, kontrol
+        // her yamada koşsaydı kayıtlı ağacında zaten iç içe repeater olan layout hiç yamalanamazdı.
+        const simulatable = opRecords.some(entry => ['add_component', 'move_component'].includes(String(entry.op))
+            || (entry.op === 'replace_prop' && FLEX_LAYOUT_PROP_NAMES.has(String(entry.prop ?? ''))));
+        const nested = simulatable ? nestedRepeaterNodes(simulated) : [];
+        if (nested.length > 0)
+            throw new PlatformApiError(nestedRepeaterMessage(nested), 400);
+        const reshaped = simulatable || opRecords.some(entry => entry.op === 'remove_component');
+        const layoutWarnings = reshaped
+            ? [
+                ...verticalGapWarnings(simulated, spec.codes.gap, touched),
+                ...stringStyleWarning(stringStyleNodes(simulated)),
+                ...inertFlexPropWarning(inertFlexPropNodes(simulated)),
+                ...flexSizeWarnings(simulated, spec.codes.flexMismatch, spec.codes.flexInvalid),
+                ...(host === 'layout' ? slotWarning(simulated) : [])
+            ]
+            : [];
+        const removedEvents = planEventRemovals(removeEventOps);
+        const resized = resizeOps.length > 0 ? planResizes(nodes, resizeOps, spec.readTool) : { serverOps: [], applied: [], warnings: [] };
+        const propTypes = propTypeOps.length > 0 ? planPropTypes(nodes, propTypeOps, spec.readTool) : { serverOps: [], applied: [] };
+        const serverOps = [...removeEventOps, ...resized.serverOps, ...propTypes.serverOps, ...opRecords];
+        const response = ((await platform.tenant('PATCH', project, `${hostPath(host, applicationId, id)}/schema`, {
+            environment,
+            body: { ops: serverOps }
+        })) ?? {});
+        if (view !== 'full')
+            outlineWriteResponse(response);
+        if (removedEvents.length > 0)
+            response.removedEvents = removedEvents;
+        if (propTypes.applied.length > 0)
+            response.propTypes = propTypes.applied;
+        if (resized.applied.length > 0)
+            response.resized = resized.applied;
+        if (resized.warnings.length > 0)
+            response.resizeWarnings = resized.warnings;
+        if (deletedFlows.length > 0)
+            response.deletedFlows = deletedFlows;
+        if (flowWarnings.length > 0)
+            response.flowWarnings = flowWarnings;
+        if (layoutWarnings.length > 0)
+            response.layoutWarnings = layoutWarnings;
+        const contentOps = opRecords.filter(entry => entry.op === 'add_component' || entry.op === 'replace_prop');
+        let opDrops = [];
+        if (contentOps.length > 0) {
+            try {
+                const saved = await fetchHost(platform, host, project, environment, applicationId, id);
+                opDrops = schemaOpDrops(saved[spec.tree], contentOps);
+            }
+            catch {
+                opDrops = [];
+            }
+        }
+        return withWriteDiff(withNormalization(response, [
+            ...componentDefaultsNote(normalized.components),
+            ...validationNote(normalized.validations),
+            ...catalogNotes,
+            ...replacePropNote(normalized.props)
+        ]), opDrops);
+    }));
+}

package/dist/tools/flows.js

@@ -1,4 +1,4 @@
-import { fetchHost, flowPath, hostParam, hostUpdateBody, unwrap } from './screens.js';
+import { fetchHost, flowPath, hostParam, unwrap } from './screens.js';
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive, microOps } from './common.js';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
 import { normalizeFlowSteps, targetlessSetterWarnings, unknownSetterTargetWarnings, withNormalization } from '../knowledge/normalize.js';
@@ -42,10 +42,6 @@ function flowSummary(flow) {
         errorSteps: Array.isArray(flow.errorSteps) ? flow.errorSteps.length : 0
     };
 }
-async function hostEnvelope(platform, host, project, environment, applicationId, hostId) {
-    const record = await fetchHost(platform, host, project, environment, applicationId, hostId);
-    return { record, envelope: { [host]: hostUpdateBody(host, { ...record, applicationId }) } };
-}
 /**
  * FLOW-024'ün arayacağı düğüm kümesi. Ham kaydın TAMAMI gezilmez: kayıt kendi `flows`'unu da
  * taşıyabilir ve oradaki bayat element id'leri kümeyi kirletip aramayı sessizce boşa çıkarır.
@@ -255,7 +251,7 @@ export function registerFlowTools(server, platform) {
     }));
     server.registerTool('flow_create', {
         title: 'Akış oluştur',
-        description: "Sayfa/layout/komponent için olay akışı oluşturur. Platform bu uçta barındırıcının TAM gövdesini de ister (akış ile şemadaki olay bağı tek işlemde tutarlı kalsın diye); gateway barındırıcıyı okuyup gövdeye kendisi koyar. Akışı bir komponent olayına bağlamak ayrı adımdır: page_schema_patch ile set_event {target, event, eventValue: <flow id>}.",
+        description: "Sayfa/layout/komponent için olay akışı oluşturur. İstek yalnız akışı yazar, barındırıcının şemasına dokunmaz; gateway barındırıcıyı yalnız setter hedeflerini denetlemek için okur (FLOW-024). Akışı bir komponent olayına bağlamak ayrı adımdır ve akış kaydedildikten SONRA yapılır: set_event {target, event, eventValue: <flow id>} — sayfada page_schema_patch, layout'ta layout_schema_patch, widget'ta component_schema_patch.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -271,7 +267,7 @@ export function registerFlowTools(server, platform) {
         },
         annotations: writes
     }, handle(config, async ({ project, environment, host, applicationId, hostId, name, slug, steps, errorSteps, flowId, policyOverride }) => {
-        const { record: hostRecord, envelope } = await hostEnvelope(platform, host, project, environment, applicationId, hostId);
+        const hostRecord = await fetchHost(platform, host, project, environment, applicationId, hostId);
         const resolvedFlowId = flowId ?? randomUUID();
         const flow = {
             id: resolvedFlowId,
@@ -289,7 +285,10 @@ export function registerFlowTools(server, platform) {
             ...flowBodyWarnings(steps),
             ...unknownSetterTargetWarnings(steps, errorSteps ?? [], hostNodes(hostRecord))
         ];
-        await platform.tenant('POST', project, flowPath(host, applicationId, hostId), { environment, body: { flow, ...envelope } });
+        // Gövde yalnız akıştır (designer-partial-update K1): barındırıcı zarfı platformda hâlâ isteğe bağlı
+        // ama gönderilirse okunan tam kaydı yeniden yazar, açık Studio designer'ının kayıtlı tabanını
+        // eskitir. Kayıt yalnız FLOW-024 hedef araması için okunur.
+        await platform.tenant('POST', project, flowPath(host, applicationId, hostId), { environment, body: { flow } });
         // Diff YALNIZ çağıranın yazdığı alanları kapsar; `id` ve barındırıcı bağı (`pageId` vb.)
         // gövdeye gateway koyar, kullanıcının düzeltebileceği bir şey değildir.
         const drops = await flowWriteDrops(platform, host, project, environment, applicationId, hostId, resolvedFlowId, { name: flow.name, slug: flow.slug, steps: flow.steps, errorSteps: flow.errorSteps });
@@ -298,12 +297,12 @@ export function registerFlowTools(server, platform) {
             hostId,
             flow: { id: resolvedFlowId, name, slug, steps: steps.length },
             ...(parameterWarnings.length > 0 ? { parameterWarnings } : {}),
-            hint: "Akışı bir olaya bağlamak için: page_schema_patch ops:[{op:'set_event', target:<elementId>, event:'<component_get events listesindeki ad>', eventValue:<flow id>}]. Olay adları komponente özeldir ve 'on' ÖNEKİ ALMAZ (button → 'click', form → 'submit', table → 'mount'/'select'/'sort'…); uydurma ad 200 döner ama bağ sessizce ölü kalır — gateway PAGE-008 ile yakalar."
+            hint: "Akışı bir olaya bağlamak için: page_schema_patch (layout'ta layout_schema_patch, widget'ta component_schema_patch) ops:[{op:'set_event', target:<elementId>, event:'<component_get events listesindeki ad>', eventValue:<flow id>}]. Olay adları komponente özeldir ve 'on' ÖNEKİ ALMAZ (button → 'click', form → 'submit', table → 'mount'/'select'/'sort'…); uydurma ad 200 döner ama bağ sessizce ölü kalır — gateway PAGE-008 ile yakalar."
         }, normalized), drops), findings);
     }));
     server.registerTool('flow_update', {
         title: 'Akış güncelle',
-        description: 'Akışın adını/adımlarını değiştirir. Gövde replace\'tir: verilen steps listesi akışın yeni tam hâlidir. Barındırıcı gövdesini gateway ekler.',
+        description: 'Akışın adını/adımlarını değiştirir. Gövde replace\'tir: verilen steps listesi akışın yeni tam hâlidir. Yalnız akış yazılır; barındırıcının şeması değişmez.',
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -322,7 +321,7 @@ export function registerFlowTools(server, platform) {
         const current = unwrap(await platform.tenant('GET', project, flowPath(host, applicationId, hostId, flowId), { environment }));
         if (!current.id)
             throw new PlatformApiError(`'${flowId}' id'li akış bulunamadı; flow_list ile doğrulayın.`);
-        const { record: hostRecord, envelope } = await hostEnvelope(platform, host, project, environment, applicationId, hostId);
+        const hostRecord = await fetchHost(platform, host, project, environment, applicationId, hostId);
         const flow = {
             id: flowId,
             name: name ?? current.name,
@@ -342,7 +341,7 @@ export function registerFlowTools(server, platform) {
             ...flowBodyWarnings(flow.steps),
             ...unknownSetterTargetWarnings(flow.steps, flow.errorSteps, hostNodes(hostRecord))
         ];
-        await platform.tenant('PUT', project, flowPath(host, applicationId, hostId, flowId), { environment, body: { flow, ...envelope } });
+        await platform.tenant('PUT', project, flowPath(host, applicationId, hostId, flowId), { environment, body: { flow } });
         // Kısmi güncellemede yalnız GÖNDERİLEN alanlar karşılaştırılır; verilmeyen alan için
         // "düştü" demek yanlış alarm olurdu.
         const drops = await flowWriteDrops(platform, host, project, environment, applicationId, hostId, flowId, {
@@ -376,7 +375,7 @@ export function registerFlowTools(server, platform) {
         const document = structuredClone(current);
         const resolved = resolvePatchOperations(document, operations, 'flow_get');
         const patched = fastJsonPatch.applyPatch(document, resolved.operations, true, false).newDocument;
-        const { record: hostRecord } = await hostEnvelope(platform, host, project, environment, applicationId, hostId);
+        const hostRecord = await fetchHost(platform, host, project, environment, applicationId, hostId);
         const flow = {
             ...patched,
             id: flowId,
@@ -392,8 +391,7 @@ export function registerFlowTools(server, platform) {
             ...flowBodyWarnings(flow.steps),
             ...unknownSetterTargetWarnings(flow.steps, flow.errorSteps, hostNodes(hostRecord))
         ];
-        // Gövde değil FARK gönderilir: barındırıcı zarfı (envelope) yazma yolunda gerekmez, platform
-        // PATCH ucu akışı tek başına yazar. Net diff okunan kayıt ile son hâl arasından hesaplanır.
+        // Gövde değil FARK gönderilir; platform PATCH ucu akışı tek başına yazar. Net diff okunan kayıt ile son hâl arasından hesaplanır.
         const netOps = fastJsonPatch.compare(current, flow);
         const saved = await platform.tenant('PATCH', project, flowPath(host, applicationId, hostId, flowId), {
             environment,
@@ -413,12 +411,11 @@ export function registerFlowTools(server, platform) {
     }));
     server.registerTool('flow_delete', {
         title: 'Akış sil',
-        description: "Akışı siler. Bu uç GÖVDE ister (barındırıcı komutu) — gövdesiz silme şemadaki olay bağını sarkıtır; gateway gövdeyi kendisi kurar. Olay bağını da temizlemek için ayrıca page_schema_patch set_event ile eventValue'yu boşaltın.",
+        description: "Akışı siler; gövde yalnız akış id'sidir ve barındırıcının şemasına dokunmaz, yani olay bağı kendiliğinden KALKMAZ. Doğru sıra: önce bağı remove_event ile kaldırın (sayfada page_schema_patch, layout'ta layout_schema_patch, widget'ta component_schema_patch). Bağı kalmayan akışı platform o yamada zaten kalıcı siler (yama allowFlowDeletion:true ister); ardından flow_delete no-op'tur. Önce flow_delete çağırırsanız şemada ölü bağ kalır.",
         inputSchema: { project: projectParam, environment: environmentParam, host: hostParam, applicationId: guid, hostId: guid, flowId: flowIdParam },
         annotations: destructive
     }, handle(config, async ({ project, environment, host, applicationId, hostId, flowId }) => {
-        const { envelope } = await hostEnvelope(platform, host, project, environment, applicationId, hostId);
-        await platform.tenant('DELETE', project, flowPath(host, applicationId, hostId, flowId), { environment, body: { id: flowId, ...envelope } });
+        await platform.tenant('DELETE', project, flowPath(host, applicationId, hostId, flowId), { environment, body: { id: flowId } });
         return { deleted: flowId, host, hostId };
     }));
 }

package/dist/tools/layouts.js

@@ -12,7 +12,7 @@ import { handle } from '../platform/responses.js';
 import { z } from 'zod';
 const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
     .describe("JSON Patch listesi (RFC 6902): { op, path, value }. Yol seçici alabilir — '/views/0/children[elementId=baslik]/props/content/data'.");
-const viewsParam = schemaParam.describe("Layout'un komponent ağacı. DİKKAT: layout'ta şema alanının adı 'schema' değil 'views'tir ve sayfa micro-op hattı (page_schema_patch) layout'a uygulanmaz. İçinde MUTLAKA bir { type: 'slot' } komponenti olmalı — sayfa içeriği YALNIZ slot'un içine render edilir, slot'suz layout'a bağlanan sayfalar boş görünür. 2026-09-08'den beri views, page_schema_patch'in doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile REDDEDİLİR (kabul edilen değer listesiyle) ve hiçbir şey kaydedilmez — eskiden sessizce kaydediliyordu (P1-2).");
+const viewsParam = schemaParam.describe("Layout'un komponent ağacı. DİKKAT: layout'ta şema alanının adı 'schema' değil 'views'tir; ağaçta hedefli değişiklik için tam ağaç yerine layout_schema_patch micro-op'larını kullanın. İçinde MUTLAKA bir { type: 'slot' } komponenti olmalı — sayfa içeriği YALNIZ slot'un içine render edilir, slot'suz layout'a bağlanan sayfalar boş görünür. 2026-09-08'den beri views, page_schema_patch'in doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile REDDEDİLİR (kabul edilen değer listesiyle) ve hiçbir şey kaydedilmez — eskiden sessizce kaydediliyordu (P1-2).");
 function countSlots(nodes) {
     if (!Array.isArray(nodes))
         return 0;
@@ -23,7 +23,7 @@ function countSlots(nodes) {
         return total + (record.type === 'slot' ? 1 : 0) + countSlots(record.children);
     }, 0);
 }
-function slotWarning(views) {
+export function slotWarning(views) {
     const slots = countSlots(views);
     if (slots === 0) {
         return ["LAY-002: layout'ta 'slot' tipli komponent YOK — Studio ve runtime, sayfa şemasını yalnız layout'taki slot'un içine yerleştirir (page.mappers: layout varsa render şeması layout views'üdür); bu layout'a bağlanan her sayfanın içeriği görünmez olur. views'e bir { type: 'slot' } komponenti ekleyin ve page_state.layoutSlots ile doğrulayın."];
@@ -49,7 +49,7 @@ export function registerLayoutTools(server, platform) {
     }, handle(config, ({ project, environment, applicationId, id }) => platform.tenant('GET', project, `/layouts/${applicationId}/${id}`, { environment })));
     server.registerTool('layout_schema_get', {
         title: "Layout komponent ağacını oku",
-        description: "Layout'un komponent ağacını (views) okur — page_schema_get'in layout karşılığı. Platformda layout micro-op ucu (sayfadaki PATCH /pages/.../schema karşılığı) yoktur, ama PATCH /layouts/{app}/{id} vardır: hedefli değişiklik için layout_patch kullanın — gateway okur, JSON Patch'i çözer ve FARKI `{ baseVersion, ops }` olarak platforma yazar; tam gövde PUT'u atılmaz. Buradaki updatedAt'i ayrıca expectedUpdatedAt olarak kabul eder. Tam ağacı kendiniz yazacaksanız layout_update.",
+        description: "Layout'un komponent ağacını (views) okur — page_schema_get'in layout karşılığı. Ağaçta hedefli değişiklik için layout_schema_patch (sayfa ile aynı micro-op sözlüğü, PATCH /layouts/{app}/{id}/schema). Ad/parametre/olay alanlarında ya da düz JSON Patch yolu gerektiğinde layout_patch — o araç buradaki updatedAt'i expectedUpdatedAt olarak kabul eder. Tam ağacı kendiniz yazacaksanız layout_update.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -134,7 +134,7 @@ export function registerLayoutTools(server, platform) {
     }));
     server.registerTool('layout_patch', {
         title: "Layout'a patch uygula",
-        description: "Tam ağacı bağlama almadan hedefli değişiklik: gateway layout'u çeker, JSON Patch'i ve kendi normalizasyonlarını uygular, doğrulamadan geçirir ve FARKI platformun PATCH /layouts/{app}/{id} ucuna `{ baseVersion, ops }` olarak yazar — tek başlık düzeltmesi için 12 düğümlük ağacı yeniden göndermeniz gerekmez (09-04 Y-25) ve tam gövde PUT'u ATILMAZ. Yol İNDEKS yerine SEÇİCİ alabilir: '/views/0/children[elementId=baslik]/props/content/data'. Sürüm kontrolü platformda: okunan kaydın `version` değeri `baseVersion` olarak gider, araya başka bir yazma girdiyse 409 döner ve HİÇBİR op uygulanmaz. expectedUpdatedAt verirseniz gateway ayrıca istek gitmeden önce yerel kontrol yapar. Ayrıca 'set_prop_type' micro-op'unu tanır ({target, prop, propType: 'static'|'code'|'translation', ref?, data?}) — layout header/sidebar etiketini çeviriye bağlamanın yolu budur; JSON Patch ile aynı listede karışık verilebilir, micro-op'lar önce uygulanır.",
+        description: "RFC 6902 JSON Patch ile hedefli değişiklik: gateway layout'u çeker, JSON Patch'i ve kendi normalizasyonlarını uygular, doğrulamadan geçirir ve FARKI platformun PATCH /layouts/{app}/{id} ucuna `{ baseVersion, ops }` olarak yazar — tam gövde PUT'u ATILMAZ (09-04 Y-25). Ağaçta düğüm ekleme/silme/taşıma, prop, olay ve boyut değişikliği için önce layout_schema_patch'i düşünün: sayfa ile aynı micro-op sözlüğüdür ve dokunulan düğümleri platform doğrular; bu araç ad/parametre/olay alanları ve düz yol gerektiren durumlar içindir. Yol İNDEKS yerine SEÇİCİ alabilir: '/views/0/children[elementId=baslik]/props/content/data'. Sürüm kontrolü platformda: okunan kaydın `version` değeri `baseVersion` olarak gider, araya başka bir yazma girdiyse 409 döner ve HİÇBİR op uygulanmaz. expectedUpdatedAt verirseniz gateway ayrıca istek gitmeden önce yerel kontrol yapar. Ayrıca 'set_prop_type' micro-op'unu tanır ({target, prop, propType: 'static'|'code'|'translation', ref?, data?}); JSON Patch ile aynı listede karışık verilebilir, micro-op'lar önce uygulanır. Yalnız etiket çeviriye bağlanacaksa aynı op layout_schema_patch'te platformun kendi op'u olarak çalışır.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,

package/dist/tools/microservices.js

@@ -385,7 +385,7 @@ export function registerMicroserviceTools(server, platform) {
     }));
     server.registerTool('microservice_debug', {
         title: 'Microservice debug',
-        description: "Microservice'i debug modunda çalıştırır; yanıtta adım adım executionItems ağacı döner (her adımın girdi/çıktısı). executionItems YALNIZ ucun kendi adımlarını kapsar — ucun ÖNÜNDE koşan middleware'ler ayrıca 'middlewares' alanında adım özetiyle listelenir (09-04 Y-04). Değeri NULL bağlanan query parametreleri 'unboundParameters' alanında adıyla listelenir (ağaçta bu satırların value anahtarı görünmez).",
+        description: "Microservice'i debug modunda çalıştırır; yanıtta adım adım executionItems ağacı döner (her adımın girdi/çıktısı). executionItems YALNIZ ucun kendi adımlarını kapsar — ucun ÖNÜNDE koşan middleware'ler ayrıca 'middlewares' alanında adım özetiyle listelenir (09-04 Y-04). Değeri NULL bağlanan query parametreleri 'unboundParameters' alanında adıyla listelenir (ağaçta bu satırların value anahtarı görünmez). Preview semantiğiyle koşar: tek transaction + sonunda rollback, kalıcı satır yazmaz. httpStatus akışın kendi sonucudur (4xx/5xx'te runtimeErrors eklenir); ağaç düğümlerinde hata bayrağı YOKTUR — patlayan adımın output'u boştur, hata gövdesi hata dalındaki response adımının çıktısındadır. Zamanlanmış (schedule-job) uçlar da slug yoluyla debug edilir (method: 'POST', parametresiz): job geçmişi hatayı yalnız mesaj olarak yazar, adım adım girdi/çıktı burada görülür (platform_guide('microservice') §Zamanlanmış işin gerçek sonucunu görmek).",
         inputSchema: executeInput,
         annotations: writes
     }, handle(config, async ({ project, environment, application, microservice, method, routeParams, query, body, parameters, headers, anonymous, asUser, cookies, language }) => {
@@ -407,7 +407,7 @@ export function registerMicroserviceTools(server, platform) {
     }));
     server.registerTool('microservice_preview', {
         title: 'Microservice önizle',
-        description: "Microservice tanımını çalıştırır: kaydedilmemiş gövde için definition, KAYITLI bir uç için yalnız id verin (gateway tanımı kendisi çeker — tam gövdeyi bağlama almanız gerekmez). previewParameters ayrı alandır ve ikisiyle de çalışır. Preview tek transaction'da koşar ve sonunda ROLLBACK edilir — kalıcı satır yazmaz; code step'teki dış HTTP çağrıları istisnadır. Davranış kuralları: platform_guide('microservice').",
+        description: "Microservice tanımını çalıştırır: kaydedilmemiş gövde için definition, KAYITLI bir uç için yalnız id verin (gateway tanımı kendisi çeker — tam gövdeyi bağlama almanız gerekmez). previewParameters ayrı alandır ve ikisiyle de çalışır. Preview tek transaction'da koşar ve sonunda ROLLBACK edilir — kalıcı satır yazmaz; code step'teki dış HTTP çağrıları istisnadır. Yanıt httpStatus (akışın KENDİ sonucu; 4xx/5xx'te gateway runtimeErrors ekler) + gövdeden ibarettir, adım ağacı DÖNMEZ — adım adım girdi/çıktı için microservice_debug, adım başına hata alanı için workflow_preview. Zamanlanmış (schedule-job) ucu id ile parametresiz önizleyin: zamanlanmış koşu da girdisiz koşar. Davranış kuralları: platform_guide('microservice').",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -447,7 +447,7 @@ export function registerMicroserviceTools(server, platform) {
     }));
     server.registerTool('microservice_job_history', {
         title: 'Job geçmişi',
-        description: 'Zamanlanmış (job tipli) microservice\'in çalışma geçmişini listeler. status ile yalnız running | completed | failed koşular süzülür; order TriggeredAt | CompletedAt | ExecutionStatus | DurationMs.',
+        description: "Zamanlanmış (schedule-job) microservice'in çalışma geçmişini listeler: satır başına { status: running | completed | failed, triggeredAt, completedAt, durationMs, errorMessage }. failed satırın errorMessage'ı patlayan adımı ve sebebini taşır: bağlanmamış fail dalında \"Step 'x' failed: <sebep>\", bağlı global-error dalıyla 2xx dışı sonuçta \"The job's workflow returned 500 (<code>): <mesaj>\"; iki durumda da yazmalar geri alınmıştır (2026-09-16 öncesi imajlar bu ikisini completed yazardı). completed = akış 2xx ile bitti ve yazmalar commit edildi. Adım adım girdi/çıktı burada YOK: aynı akışı workflow_preview (adım başına hata alanı) ya da microservice_debug (executionItems) ile koşturun — platform_guide('microservice') §Zamanlanmış işin gerçek sonucunu görmek. status ile yalnız running | completed | failed koşular süzülür; order TriggeredAt | CompletedAt | ExecutionStatus | DurationMs.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -459,7 +459,7 @@ export function registerMicroserviceTools(server, platform) {
     }, handle(config, ({ project, environment, id, ...query }) => platform.tenant('GET', project, `/microservices/${id}/job-history`, { environment, query })));
     server.registerTool('microservice_schedule_get', {
         title: 'Zamanlama durumu',
-        description: 'Zamanlanmış (schedule-job) microservice\'in canlı zamanlama durumunu döner: state (scheduled | paused | notScheduled | error | ended), isRunning, nextFireTimeUtc, previousFireTimeUtc, sıradaki 5 koşu (upcomingFireTimesUtc), cron + timeZoneId, serverTimeUtc ve son koşunun özeti (lastExecution). "Bir sonraki sefer ne zaman koşacak?" sorusunu cron\'u yorumlamadan buradan cevaplayın. paused iken nextFireTimeUtc null ve upcoming boştur. notScheduled: kayıt var ama zamanlayıcıda trigger yok — en geç 5 dk içinde uzlaştırma kurar ya da servisi kaydedin (microservice_update). ended: tanımın sonraki koşusu yok (once geçti, end on/after doldu). schedule alanı tanımın kendisidir. Schedule tipli olmayan servis 400 döner.',
+        description: 'Zamanlanmış (schedule-job) microservice\'in canlı zamanlama durumunu döner: state (scheduled | paused | notScheduled | error | ended), isRunning, nextFireTimeUtc, previousFireTimeUtc, sıradaki 5 koşu (upcomingFireTimesUtc), cron + timeZoneId, serverTimeUtc ve son koşunun özeti (lastExecution — geçmiş satırının aynısı: failed ise errorMessage patlayan adımı ve sebebini taşır; bkz. microservice_job_history). "Bir sonraki sefer ne zaman koşacak?" sorusunu cron\'u yorumlamadan buradan cevaplayın. paused iken nextFireTimeUtc null ve upcoming boştur. notScheduled: kayıt var ama zamanlayıcıda trigger yok — en geç 5 dk içinde uzlaştırma kurar ya da servisi kaydedin (microservice_update). ended: tanımın sonraki koşusu yok (once geçti, end on/after doldu). schedule alanı tanımın kendisidir. Schedule tipli olmayan servis 400 döner.',
         inputSchema: { project: projectParam, environment: environmentParam, id: guid },
         annotations: readOnly
     }, handle(config, ({ project, environment, id }) => platform.tenant('GET', project, `/microservices/${id}/schedule`, { environment })));
@@ -475,7 +475,7 @@ export function registerMicroserviceTools(server, platform) {
     }, handle(config, ({ project, environment, schedule }) => platform.tenant('POST', project, '/microservices/schedule/preview', { environment, body: { schedule } })));
     server.registerTool('microservice_schedule_control', {
         title: 'Zamanlamayı yönet',
-        description: 'Zamanlanmış microservice\'i duraklatır (pause), sürdürür (resume) ya da cron\'u beklemeden bir kez koşturur (trigger). pause/resume yalnız zamanlayıcıdaki durumu değiştirir, tanımı değil; duraklatma cron güncellemesi ve deployment senkronundan sonra da korunur. resume: duraklatılmışken bir koşu kaçırıldıysa iş bir kez hemen koşar. trigger KUYRUĞA ALIR, sonucu beklemez: deployment ya da template kurulumu sürüyorsa koşu veto edilir ve geçmişe hiç düşmez — sonucu microservice_job_history ile doğrulayın. Zamanlayıcıda kaydı olmayan iş 400 (ScheduleJobNotRegisteredException) döner. Production ortamında üç eylem de 400 CantWriteInProductionException ile reddedilir; trigger ayrıca deployment/template kurulumu sürerken reddedilir.',
+        description: 'Zamanlanmış microservice\'i duraklatır (pause), sürdürür (resume) ya da cron\'u beklemeden bir kez koşturur (trigger). pause/resume yalnız zamanlayıcıdaki durumu değiştirir, tanımı değil; duraklatma cron güncellemesi ve deployment senkronundan sonra da korunur. resume: duraklatılmışken bir koşu kaçırıldıysa iş bir kez hemen koşar. trigger KUYRUĞA ALIR, sonucu beklemez: deployment ya da template kurulumu sürüyorsa koşu veto edilir ve geçmişe hiç düşmez — sonucu microservice_job_history ile doğrulayın. Geçmiş failed satırında patlayan adımı ve sebebini yazar ama adım izi vermez; tetiklemeden ÖNCE akışı workflow_preview / microservice_debug ile koşturun. Zamanlayıcıda kaydı olmayan iş 400 (ScheduleJobNotRegisteredException) döner. Production ortamında üç eylem de 400 CantWriteInProductionException ile reddedilir; trigger ayrıca deployment/template kurulumu sürerken reddedilir.',
         inputSchema: {
             project: projectParam,
             environment: environmentParam,