@appaflytech/zeyrek-ai-mcp 0.0.7 → 0.0.9

package/dist/server.js

@@ -1,41 +1,44 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { registerMicroserviceTools } from './tools/microservices.js';
-import { registerMicrofunctionTools } from './tools/microfunctions.js';
-import { registerApplicationTools } from './tools/applications.js';
-import { registerDeploymentTools } from './tools/deployments.js';
-import { registerDatasourceTools } from './tools/datasources.js';
-import { registerAutomationTools } from './tools/automations.js';
-import { registerOrganizationTools } from './tools/organizations.js';
-import { registerExternalComponentTools } from './tools/externalComponents.js';
-import { registerComponentTools } from './tools/components.js';
-import { registerPlatformTools } from './tools/platformInfo.js';
-import { registerTemplateTools } from './tools/templates.js';
-import { registerWorkflowTools } from './tools/workflows.js';
-import { registerLayoutTools } from './tools/layouts.js';
-import { registerAccessTools } from './tools/access.js';
-import { registerTranslationTools } from './tools/translations.js';
-import { registerFlowTools } from './tools/flows.js';
-import { registerKnowledgeResources } from './resources/knowledge.js';
-import { registerSchemaResources } from './resources/schemas.js';
-import { registerRuleResources } from './resources/rules.js';
-import { instrumentServer } from './observability/trace.js';
-import { registerProjectTools } from './tools/projects.js';
-import { registerEntityTools } from './tools/entities.js';
-import { registerDependencyTools } from './tools/dependencies.js';
-import { registerVariableTools } from './tools/variables.js';
-import { registerFunctionTools } from './tools/functions.js';
-import { registerFolderTools } from './tools/folders.js';
-import { registerQueryTools } from './tools/queries.js';
-import { registerViewTools } from './tools/views.js';
-import { registerPageTools } from './tools/pages.js';
-import { registerFileTools } from './tools/files.js';
-import { registerRowTools } from './tools/rows.js';
-import { registerImportTools } from './tools/imports.js';
-import { registerEnvironmentTools } from './tools/environments.js';
-import { registerMergeTools } from './tools/merges.js';
-import { registerRevisionTools } from './tools/revisions.js';
-import { registerActivityTools } from './tools/activities.js';
-import { registerDtoTools } from './tools/dtos.js';
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerMicroserviceTools } from "./tools/microservices.js";
+import { registerMicrofunctionTools } from "./tools/microfunctions.js";
+import { registerApplicationTools } from "./tools/applications.js";
+import { registerDeploymentTools } from "./tools/deployments.js";
+import { registerDatasourceTools } from "./tools/datasources.js";
+import { registerAutomationTools } from "./tools/automations.js";
+import { registerOrganizationTools } from "./tools/organizations.js";
+import { registerExternalComponentTools } from "./tools/externalComponents.js";
+import { registerComponentTools } from "./tools/components.js";
+import { registerPlatformTools } from "./tools/platformInfo.js";
+import { registerTemplateTools } from "./tools/templates.js";
+import { registerWorkflowTools } from "./tools/workflows.js";
+import { registerLayoutTools } from "./tools/layouts.js";
+import { registerDesignSchemaPatchTool } from "./tools/designSchemaPatch.js";
+import { registerAccessTools } from "./tools/access.js";
+import { registerTranslationTools } from "./tools/translations.js";
+import { registerFlowTools } from "./tools/flows.js";
+import { registerKnowledgeResources } from "./resources/knowledge.js";
+import { registerSchemaResources } from "./resources/schemas.js";
+import { registerRuleResources } from "./resources/rules.js";
+import { instrumentServer } from "./observability/trace.js";
+import { rejectUnknownArguments } from "./platform/strictArguments.js";
+import { registerProjectTools } from "./tools/projects.js";
+import { registerEntityTools } from "./tools/entities.js";
+import { registerDependencyTools } from "./tools/dependencies.js";
+import { registerVariableTools } from "./tools/variables.js";
+import { registerFunctionTools } from "./tools/functions.js";
+import { registerFolderTools } from "./tools/folders.js";
+import { registerQueryTools } from "./tools/queries.js";
+import { registerViewTools } from "./tools/views.js";
+import { registerPageTools } from "./tools/pages.js";
+import { registerThemeTools } from "./tools/themes.js";
+import { registerFileTools } from "./tools/files.js";
+import { registerRowTools } from "./tools/rows.js";
+import { registerImportTools } from "./tools/imports.js";
+import { registerEnvironmentTools } from "./tools/environments.js";
+import { registerMergeTools } from "./tools/merges.js";
+import { registerRevisionTools } from "./tools/revisions.js";
+import { registerActivityTools } from "./tools/activities.js";
+import { registerDtoTools } from "./tools/dtos.js";
 const moduleRegistrations = {
     platform: registerPlatformTools,
     project: registerProjectTools,
@@ -52,10 +55,17 @@ const moduleRegistrations = {
     dto: registerDtoTools,
     view: registerViewTools,
     page: registerPageTools,
-    component: registerComponentTools,
+    theme: registerThemeTools,
+    component: (server, platform) => {
+        registerComponentTools(server, platform);
+        registerDesignSchemaPatchTool(server, platform, "component");
+    },
     externalComponent: registerExternalComponentTools,
     flow: registerFlowTools,
-    layout: registerLayoutTools,
+    layout: (server, platform) => {
+        registerLayoutTools(server, platform);
+        registerDesignSchemaPatchTool(server, platform, "layout");
+    },
     variable: registerVariableTools,
     function: registerFunctionTools,
     folder: registerFolderTools,
@@ -69,10 +79,10 @@ const moduleRegistrations = {
     environment: registerEnvironmentTools,
     merge: registerMergeTools,
     activity: registerActivityTools,
-    revision: registerRevisionTools
+    revision: registerRevisionTools,
 };
 export function createGatewayServer(platform) {
-    const server = instrumentServer(new McpServer({ name: 'ngapps', version: '0.1.0' }), platform.config);
+    const server = rejectUnknownArguments(instrumentServer(new McpServer({ name: "ngapps", version: "0.1.0" }), platform.config));
     for (const moduleName of platform.config.modules) {
         moduleRegistrations[moduleName](server, platform);
     }

package/dist/tools/components.js

@@ -1,6 +1,7 @@
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
 import { normalizeComponentDefaults, componentDefaultsNote, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, withNormalization } from '../knowledge/normalize.js';
 import { eventContractsFor, eventPayloadNote } from '../knowledge/componentEvents.js';
+import { componentPresetDefaults, readProjectTheme } from '../knowledge/themeSchema.js';
 import { knowledgeFor, knowledgeNote, APPEARANCE_TOKEN_SETS, STATE_FLAG_NOTES, INTERNAL_ROLES_BY_TYPE } from '../knowledge/componentCatalog.js';
 import { componentUpdateBody, fetchHost, schemaParam, unwrap } from './screens.js';
 import { PlatformApiError } from '../platform/errors.js';
@@ -160,6 +161,12 @@ export function registerComponentTools(server, platform) {
             : [];
         const componentSlug = typeof component.slug === 'string' ? component.slug : undefined;
         const knowledge = knowledgeFor(componentSlug);
+        // S-3 — `defaults` HAM katalogdur; Studio'da bırakılan düğüm ise temanın bileşen preseti
+        // kaplanmış katalogdan kurulur (`withThemeComponentDefaults`). Tema okunamazsa (uç düşer,
+        // yetki yoksa) alan yanıta HİÇ girmez: uydurulmuş bir varsayılan yanlış bilgidir.
+        const themeDefaults = componentSlug === undefined
+            ? undefined
+            : componentPresetDefaults(readProjectTheme(await platform.org('GET', `/p/${platform.resolveProject(project)}`).catch(() => undefined)), componentSlug);
         return {
             id: component.id,
             slug: component.slug,
@@ -188,6 +195,7 @@ export function registerComponentTools(server, platform) {
                     internalRolesNote: "Bu komponentin İÇ kontrolleri dışarıdan adreslenebilir: page_screenshot actions hedefine '<elementId>__<rol>' yazın (ör. 'tbl_vacancy__pager-next'). Kimlikler runtime'ın data-element-id özniteliğidir; ikinci bir mekanizma yoktur."
                 }
                 : {}),
+            ...(themeDefaults ? { themeDefaults } : {}),
             appearanceValues: APPEARANCE_TOKEN_SETS,
             stateFlags: STATE_FLAG_NOTES,
             validations: definition.validations,

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,7 +1,7 @@
-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, unknownSetterTargetWarnings, withNormalization } from '../knowledge/normalize.js';
+import { normalizeFlowSteps, targetlessSetterWarnings, unknownSetterTargetWarnings, withNormalization } from '../knowledge/normalize.js';
 import { flowBodyWarnings } from '../knowledge/coverage.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.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.
@@ -243,13 +239,19 @@ export function registerFlowTools(server, platform) {
     }));
     server.registerTool('flow_get', {
         title: 'Akış getir',
-        description: 'Tek akışı adımlarıyla getirir; yeni akış yazarken en iyi şablon budur.',
+        description: "Tek akışı adımlarıyla getirir; yeni akış yazarken en iyi şablon budur. Hedefi silinmiş (element'siz) setter iteratee'si varsa yanıttaki flowWarnings söyler — o adım koşar ama hiçbir şeye yazmaz.",
         inputSchema: { project: projectParam, environment: environmentParam, host: hostParam, applicationId: guid, hostId: guid, flowId: flowIdParam },
         annotations: readOnly
-    }, handle(config, ({ project, environment, host, applicationId, hostId, flowId }) => platform.tenant('GET', project, flowPath(host, applicationId, hostId, flowId), { environment })));
+    }, handle(config, async ({ project, environment, host, applicationId, hostId, flowId }) => {
+        const response = await platform.tenant('GET', project, flowPath(host, applicationId, hostId, flowId), { environment });
+        const warnings = targetlessSetterWarnings(response);
+        if (warnings.length === 0 || !response || typeof response !== 'object' || Array.isArray(response))
+            return response;
+        return { ...response, flowWarnings: warnings };
+    }));
     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,
@@ -265,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,
@@ -283,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 });
@@ -292,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,
@@ -316,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,
@@ -336,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, {
@@ -370,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,
@@ -386,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,
@@ -407,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

@@ -2,7 +2,7 @@ import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, u
 import { resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import fastJsonPatch from 'fast-json-patch';
-import { normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
+import { normalizeComponentDefaults, componentDefaultsNote, flexSizeWarnings, spacingLayerWarnings, verticalGapWarnings, withNormalization } from '../knowledge/normalize.js';
 import { fetchHost, layoutUpdateBody, schemaParam, eventsParam, modeParam, summarize, findNode } from './screens.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
 import { applyPropTypesToSchema, isSetPropTypeOp, setPropTypeErrors } from '../knowledge/propTypes.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,
@@ -93,7 +93,7 @@ export function registerLayoutTools(server, platform) {
         assertScreenWriteGuards('layout', { schema: views, events });
         const fixed = normalizeComponentDefaults(views);
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, views);
-        const gaps = [...verticalGapWarnings(views ?? [], 'LAY-003 (uyarı)'), ...flexSizeWarnings(views ?? [], 'LAY-007 (uyarı)', 'LAY-008 (uyarı)')];
+        const gaps = [...verticalGapWarnings(views ?? [], 'LAY-003 (uyarı)'), ...flexSizeWarnings(views ?? [], 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'), ...spacingLayerWarnings(views ?? [], 'LAY-010 (uyarı)', 'LAY-011 (uyarı)')];
         const response = await platform.tenant('POST', project, `/layouts/${applicationId}`, {
             environment,
             body: { name, views: views ?? [], events: events ?? [], parameters: parameters ?? null }
@@ -126,7 +126,7 @@ export function registerLayoutTools(server, platform) {
         const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, overrides.views);
         const body = layoutUpdateBody({ ...current, applicationId }, overrides);
         await platform.tenant('PUT', project, `/layouts/${applicationId}/${id}`, { environment, body });
-        const gaps = overrides.views === undefined ? [] : [...verticalGapWarnings(body.views, 'LAY-003 (uyarı)'), ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)')];
+        const gaps = overrides.views === undefined ? [] : [...verticalGapWarnings(body.views, 'LAY-003 (uyarı)'), ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'), ...spacingLayerWarnings(body.views, 'LAY-010 (uyarı)', 'LAY-011 (uyarı)')];
         const summary = { id, changed: Object.keys(overrides), preserved: { viewNodes: body.views.length } };
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
@@ -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,
@@ -193,7 +193,7 @@ export function registerLayoutTools(server, platform) {
             body: { baseVersion: baseVersionOf(document, 'layout_get'), ops: netOps }
         });
         const written = patchResult(saved, finalDocument);
-        const gaps = [...verticalGapWarnings(body.views, 'LAY-003 (uyarı)'), ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)')];
+        const gaps = [...verticalGapWarnings(body.views, 'LAY-003 (uyarı)'), ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'), ...spacingLayerWarnings(body.views, 'LAY-010 (uyarı)', 'LAY-011 (uyarı)')];
         const summary = {
             id,
             applied: patchOps.length,