@appaflytech/zeyrek-ai-mcp 0.0.21 → 0.0.22

package/dist/tools/components.js

@@ -1,25 +1,40 @@
 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 { normalizeComponentDefaults, componentDefaultsNote, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, normalizeDroppableStates, withNormalization } from '../knowledge/normalize.js';
 import { eventContractsFor, eventPayloadNote } from '../knowledge/componentEvents.js';
 import { componentPresetDefaults, readProjectTheme } from '../knowledge/themeSchema.js';
 import { knowledgeFor, knowledgeNote, APPEARANCE_TOKEN_SETS, STATE_FLAG_NOTES, INTERNAL_ROLES_BY_TYPE } from '../knowledge/componentCatalog.js';
+import { MOBILE_STATE_FLAG_NOTES, mobileComponentKnowledge } from '../knowledge/mobileComponentCatalog.js';
+import { mobileComponentEventContracts } from '../knowledge/mobileComponentEvents.js';
 import { componentUpdateBody, fetchHost, schemaParam, unwrap } from './screens.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
+import { applicationTypeField, resolveProfile } from '../knowledge/platform/resolve.js';
+import { mobileComponentNotes } from '../knowledge/platform/mobileRules.js';
 import { z } from 'zod';
-const typeParam = z.enum(['web', 'mobile']).optional().describe('Hedef platform; varsayılan web');
+const typeParam = z.enum(['web', 'mobile']).optional().describe('Hedef platform (ComponentType); verilmezse uygulamanın tipi — mobil uygulamada mobile');
 const kindParam = z.enum(['component', 'widget']).optional()
     .describe("component: sayfaya konan tekil eleman. widget: kendi şeması olan kapsayıcı (container/modal/drawer)");
 const widgetTypeParam = z.enum(['container', 'modal', 'drawer']).optional()
     .describe("kind:'widget' iken zorunlu");
+/**
+ * Uç `type` verilmezse WEB kataloğunu döner (`GetComponentsQuery` `Type ?? Web`); mobil uygulamanın
+ * paleti, doğrulayıcısı ve widget'ları `type=mobile` satırlarıdır. Profil mobil derse sorgu tipi
+ * taşır; web'de sorgu profil öncesiyle aynıdır (G1 kilidi).
+ */
 async function listComponents(platform, project, environment, applicationId, scope) {
     const path = scope === 'all' ? `/components/${applicationId}/all` : `/components/${applicationId}`;
+    const catalogType = scope === 'all' ? 'web' : (await resolveProfile(platform, applicationId)).profile.catalogType;
     const response = await platform.tenant('GET', project, path, {
         environment,
-        query: scope === 'all' ? undefined : { pageIndex: 0, pageLength: 999 }
+        query: scope === 'all' ? undefined : { pageIndex: 0, pageLength: 999, ...(catalogType === 'mobile' ? { type: 'mobile' } : {}) }
     });
     return response?.data ?? [];
 }
+/** Uygulamanın kayıtlı bileşen slug'ları (mobil profilin MOB-003 denetimi). */
+export async function fetchCatalogSlugs(platform, project, environment, applicationId) {
+    const components = await listComponents(platform, project, environment, applicationId);
+    return new Set(components.map(component => String(component.slug ?? '')).filter(slug => slug.length > 0));
+}
 /**
  * Yerleşim normalizasyonlarının ikisi de aynı katalog listesinden beslenir; tek okumada
  * çıkarılır ki yazma yolları fazladan istek atmasın. Uygulamanın kendi sözlüğü okunur
@@ -38,12 +53,17 @@ export async function fetchComponentLayoutRules(platform, project, environment,
 export function componentLayoutRules(components) {
     const maxSizes = new Map();
     const autoHeights = new Map();
+    const droppable = new Map();
     for (const component of components) {
         const slug = typeof component.slug === 'string' ? component.slug : undefined;
         if (!slug)
             continue;
         if (typeof component.isDefaultAutoHeight === 'boolean')
             autoHeights.set(slug, component.isDefaultAutoHeight);
+        // Kap bilgisi sözlükten gelir; düğümün `states.isDroppable`ı onu izler (Studio paleti de
+        // aynı alanı katalogdan yazar). `true` gören tip kap sayılır.
+        if (typeof component.isDroppable === 'boolean')
+            droppable.set(slug, component.isDroppable);
         const blocks = (component.definition ?? {}).blocks;
         if (!Array.isArray(blocks))
             continue;
@@ -58,7 +78,7 @@ export function componentLayoutRules(components) {
             });
         }
     }
-    return { maxSizes, autoHeights };
+    return { maxSizes, autoHeights, droppable };
 }
 /**
  * Katalog okuması başarısız olsa da yazma isteği gitmeli, ama iki normalizasyonun düşüş davranışı
@@ -69,14 +89,21 @@ export function componentLayoutRules(components) {
  *   varsayılanını (`fixed`, `DesignComponentManagementSchema.cs:24`) kabul etmek demektir; en fazla
  *   sekiz tipte (auth-layout/html/image/layout/qrcode/table/text-editor/video) fazladan yükseklik
  *   üretir, atlamak ise her tipte içerik kırpar.
+ * - `states.isDroppable` atlanır — katalog okunamadığında hangi tipin kap olduğu bilinmez ve
+ *   uydurulmaz; düğüm bugünkü hâliyle yazılır.
  */
 export async function applyCatalogLayoutRules(platform, project, environment, applicationId, nodes) {
     try {
         const rules = await fetchComponentLayoutRules(platform, project, environment, applicationId);
-        return { clamped: clampBlockSizes(nodes, rules.maxSizes), heights: normalizeHeightTypes(nodes, rules.autoHeights), sizes: normalizeSizeStrings(nodes) };
+        return {
+            clamped: clampBlockSizes(nodes, rules.maxSizes),
+            heights: normalizeHeightTypes(nodes, rules.autoHeights),
+            sizes: normalizeSizeStrings(nodes),
+            states: normalizeDroppableStates(nodes, rules.droppable)
+        };
     }
     catch {
-        return { clamped: [], heights: normalizeHeightTypes(nodes, new Map()), sizes: normalizeSizeStrings(nodes) };
+        return { clamped: [], heights: normalizeHeightTypes(nodes, new Map()), sizes: normalizeSizeStrings(nodes), states: [] };
     }
 }
 /**
@@ -116,6 +143,7 @@ export function registerComponentTools(server, platform) {
     }, handle(config, async ({ project, environment, applicationId, scope, includeHidden }) => {
         const components = await listComponents(platform, project, environment, applicationId, scope);
         return {
+            ...applicationTypeField(await resolveProfile(platform, applicationId)),
             components: components
                 .filter(component => includeHidden === true || component.isHide !== true)
                 .map(component => ({
@@ -161,6 +189,15 @@ export function registerComponentTools(server, platform) {
             : [];
         const componentSlug = typeof component.slug === 'string' ? component.slug : undefined;
         const knowledge = knowledgeFor(componentSlug);
+        // Mobil uygulamada kayıt mobil kataloğun satırıdır (`listComponents` type=mobile); davranış
+        // notları web runtime'ından gelir (`knowledge` — mobil şema web sınıfını genişletir), bileşenin
+        // mobil farkları `mobileKnowledge`'ta, bütün mobil bileşenlere geçen notlar `mobileNotes`'ta (G4).
+        // Web ikizi olmayan bileşende (`app-bar`, `tooltip`…) bilgi yalnız `mobileKnowledge`'tadır; olay
+        // yükleri de önce mobil sözlükten okunur (`mobileComponentEvents.ts`).
+        const mobile = (await resolveProfile(platform, applicationId)).profile.platform === 'mobile';
+        const mobileKnowledge = mobile && componentSlug !== undefined && Object.hasOwn(mobileComponentKnowledge, componentSlug)
+            ? mobileComponentKnowledge[componentSlug]
+            : undefined;
         // 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.
@@ -177,7 +214,7 @@ export function registerComponentTools(server, platform) {
             isDroppable: component.isDroppable,
             props: definition.props,
             defaults: definition.defaults,
-            events: eventContractsFor(componentSlug, eventNames),
+            events: eventContractsFor(componentSlug, eventNames, mobile ? mobileComponentEventContracts : undefined),
             eventPayloadNote,
             ...(knowledge
                 ? {
@@ -188,7 +225,7 @@ export function registerComponentTools(server, platform) {
                     },
                     ...(knowledge.guide ? { guide: knowledge.guide } : {})
                 }
-                : { knowledgeNote }),
+                : mobileKnowledge ? {} : { knowledgeNote }),
             ...(componentSlug && INTERNAL_ROLES_BY_TYPE[componentSlug]
                 ? {
                     internalRoles: INTERNAL_ROLES_BY_TYPE[componentSlug],
@@ -196,8 +233,9 @@ export function registerComponentTools(server, platform) {
                 }
                 : {}),
             ...(themeDefaults ? { themeDefaults } : {}),
+            ...(mobile ? { platform: 'mobile', ...(mobileKnowledge ? { mobileKnowledge } : {}), mobileNotes: mobileComponentNotes(componentSlug) } : {}),
             appearanceValues: APPEARANCE_TOKEN_SETS,
-            stateFlags: STATE_FLAG_NOTES,
+            stateFlags: mobile ? { ...STATE_FLAG_NOTES, ...MOBILE_STATE_FLAG_NOTES } : STATE_FLAG_NOTES,
             validations: definition.validations,
             sizes: definition.blocks
         };
@@ -234,11 +272,13 @@ export function registerComponentTools(server, platform) {
         const catalog = (body.schema ?? []).length > 0
             ? await applyCatalogLayoutRules(platform, project, environment, applicationId, body.schema)
             : { clamped: [], heights: [], sizes: [] };
+        // Mobil uygulamanın widget'ı mobil katalog satırıdır; tip verilmezse uygulamanın tipi.
+        const defaultType = body.type ?? (await resolveProfile(platform, applicationId)).profile.catalogType;
         return platform.tenant('POST', project, `/components/${applicationId}`, {
             environment,
             body: {
                 kind: 'component',
-                type: 'web',
+                type: defaultType,
                 categories: [],
                 definition: {},
                 schema: [],

package/dist/tools/designSchemaPatch.js

@@ -8,6 +8,8 @@ import { fetchComponentEventNames } from './components.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
 import { slotWarning } from './layouts.js';
+import { applicationTypeField, resolveProfile } from '../knowledge/platform/resolve.js';
+import { boundFlowSteps, screenProfileWarnings } from './profileWrite.js';
 import { z } from 'zod';
 const HOSTS = {
     layout: {
@@ -101,12 +103,18 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         const nested = simulatable ? nestedRepeaterNodes(simulated) : [];
         if (nested.length > 0)
             throw new PlatformApiError(nestedRepeaterMessage(nested), 400);
+        const resolved = await resolveProfile(platform, applicationId);
         const reshaped = simulatable || opRecords.some(entry => entry.op === 'remove_component');
+        const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, {
+            kind: spec.kind,
+            ops: [...opRecords, ...propTypeOps],
+            steps: await boundFlowSteps(platform, resolved, project, environment, host, applicationId, id, opRecords)
+        });
         const layoutWarnings = reshaped
             ? [
-                ...verticalGapWarnings(simulated, spec.codes.gap, touched),
+                ...(resolved.profile.layout.blocksMeaningful ? verticalGapWarnings(simulated, spec.codes.gap, touched) : []),
                 ...stringStyleWarning(stringStyleNodes(simulated)),
-                ...inertFlexPropWarning(inertFlexPropNodes(simulated)),
+                ...(resolved.profile.layout.modes.has('grid') ? inertFlexPropWarning(inertFlexPropNodes(simulated)) : []),
                 ...flexSizeWarnings(simulated, spec.codes.flexMismatch, spec.codes.flexInvalid),
                 ...(host === 'layout' ? slotWarning(simulated) : [])
             ]
@@ -133,8 +141,9 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
             response.deletedFlows = deletedFlows;
         if (flowWarnings.length > 0)
             response.flowWarnings = flowWarnings;
-        if (layoutWarnings.length > 0)
-            response.layoutWarnings = layoutWarnings;
+        if (layoutWarnings.length > 0 || profileWarnings.length > 0)
+            response.layoutWarnings = [...layoutWarnings, ...profileWarnings];
+        Object.assign(response, applicationTypeField(resolved));
         const contentOps = opRecords.filter(entry => entry.op === 'add_component' || entry.op === 'replace_prop');
         let opDrops = emptyWriteDiff();
         if (contentOps.length > 0) {

package/dist/tools/externalComponents.js

@@ -7,6 +7,23 @@ import { z } from 'zod';
 import { evaluatePolicy, enforcePolicy } from '../knowledge/policy.js';
 import { policyRules } from '../knowledge/rules.js';
 import { EXTERNAL_COMPONENT_PROTOCOL_VERSION } from '../knowledge/backendConstraints.js';
+import { resolveProfile } from '../knowledge/platform/resolve.js';
+import { findingLine } from '../knowledge/platform/profile.js';
+/**
+ * MOB-006 — harici bileşen protokolü v1 tarayıcıda koşan `.mjs` custom element'tir; mobil
+ * uygulamanın native çizeri onu yükleyemez (mobil protokol v2 Faz 3). Profil kapalı derse çağrı
+ * platforma GİTMEZ: yüklenen paket hiçbir ekranda çizilmeyecekti.
+ */
+async function assertExternalComponentsAllowed(platform, applicationId, tool) {
+    const resolved = await resolveProfile(platform, applicationId);
+    if (resolved.profile.externalComponents)
+        return;
+    throw new PlatformApiError(`${tool}: ${findingLine({
+        code: 'MOB-006',
+        severity: 'warn',
+        message: "harici bileşen mobil uygulamada desteklenmiyor — protokol v1 tarayıcıda koşan .mjs custom element'tir, native çizer onu yükleyemez (mobil protokol v2 Faz 3). Çağrı platforma gönderilmedi; mobil ekranı katalog bileşenleriyle kurun (component_list)."
+    })}`, 400);
+}
 /** Platformun köprü protokolü; scaffold ve publish bu sürüme göre üretir/doğrular (backend ExternalComponentRules.CurrentProtocolVersion) */
 const PROTOCOL_VERSION = EXTERNAL_COMPONENT_PROTOCOL_VERSION;
 /** Backend `ExternalComponentRules.MaxBundleSizeBytes` ile aynı sınır */
@@ -199,6 +216,7 @@ export function registerExternalComponentTools(server, platform) {
         },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, bundlePath, manifestPath, version }) => {
+        await assertExternalComponentsAllowed(platform, applicationId, 'external_component_publish');
         const manifestFile = resolve(manifestPath);
         const bundleFile = resolve(bundlePath);
         let manifest;
@@ -262,10 +280,13 @@ export function registerExternalComponentTools(server, platform) {
             acknowledgeWarnings: z.boolean().optional().describe('Doğrulama uyarılarını okuyup kabul ettiğinizi bildirir; uyarısı olan sürümlerde zorunlu')
         },
         annotations: updates
-    }, handle(config, ({ project, environment, applicationId, slug, version, acknowledgeWarnings }) => platform.tenant('POST', project, `/components/${applicationId}/external/${slug}/activate`, {
-        environment,
-        body: { version, acknowledgeWarnings: acknowledgeWarnings === true }
-    })));
+    }, handle(config, async ({ project, environment, applicationId, slug, version, acknowledgeWarnings }) => {
+        await assertExternalComponentsAllowed(platform, applicationId, 'external_component_activate');
+        return platform.tenant('POST', project, `/components/${applicationId}/external/${slug}/activate`, {
+            environment,
+            body: { version, acknowledgeWarnings: acknowledgeWarnings === true }
+        });
+    }));
     server.registerTool('external_component_versions', {
         title: 'Paket sürümlerini listele',
         description: 'Bir harici komponentin yayınlanmış paket sürümlerini, hangisinin aktif olduğunu ve her sürümün doğrulama raporunu listeler. Geri alınacak sürümü buradan seçin.',

package/dist/tools/flows.js

@@ -13,6 +13,7 @@ import { policyRules, flowExpressionSites } from '../knowledge/rules.js';
 import { functionCallRefs } from '../knowledge/functionGuards.js';
 import { existingMatch, ifExistsParam, platformRename, withRename } from '../platform/ifExists.js';
 import { randomUUID } from 'node:crypto';
+import { flowProfileWarnings } from './profileWrite.js';
 import { z } from 'zod';
 /**
  * Akış yazması yanıtında gövdeyi geri döndürmüyor, bu yüzden diff için akışı bir kez okuruz.
@@ -382,6 +383,7 @@ export function registerFlowTools(server, platform) {
         // 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, writtenFlowId, { name: flow.name, slug: flow.slug, steps: flow.steps, errorSteps: flow.errorSteps }, ifExists === 'duplicate');
+        const platformWarnings = await flowProfileWarnings(platform, applicationId, [...(flow.steps ?? []), ...(flow.errorSteps ?? [])]);
         return attachFindings(withWriteDiff(withRename(withNormalization({
             host,
             hostId,
@@ -393,6 +395,7 @@ export function registerFlowTools(server, platform) {
                 steps: steps.length
             },
             ...(parameterWarnings.length > 0 ? { parameterWarnings } : {}),
+            ...(platformWarnings.length > 0 ? { platformWarnings } : {}),
             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>}]; olayda zaten akış bağlıysa ikinciyi add_event ile ekleyin (set_event bağlı akışı değiştirir, PAGE-034). 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.renamed), drops), findings);
     }));
@@ -446,7 +449,9 @@ export function registerFlowTools(server, platform) {
             ...(steps === undefined ? {} : { steps }),
             ...(errorSteps === undefined ? {} : { errorSteps })
         });
-        return attachFindings(withWriteDiff(withNormalization({ host, hostId, flow: flowSummary(flow), ...(parameterWarnings.length > 0 ? { parameterWarnings } : {}) }, normalized), drops), findings);
+        const platformWarnings = await flowProfileWarnings(platform, applicationId, [...(flow.steps ?? []), ...(flow.errorSteps ?? [])]);
+        return attachFindings(withWriteDiff(withNormalization({ host, hostId, flow: flowSummary(flow), ...(parameterWarnings.length > 0 ? { parameterWarnings } : {}),
+            ...(platformWarnings.length > 0 ? { platformWarnings } : {}) }, normalized), drops), findings);
     }));
     server.registerTool('flow_patch', {
         title: "Akışa patch uygula",
@@ -495,6 +500,7 @@ export function registerFlowTools(server, platform) {
         });
         const written = patchResult(saved, flow);
         const drops = await flowWriteDrops(platform, host, project, environment, applicationId, hostId, flowId, { steps: flow.steps, errorSteps: flow.errorSteps });
+        const platformWarnings = await flowProfileWarnings(platform, applicationId, [...(flow.steps ?? []), ...(flow.errorSteps ?? [])]);
         return attachFindings(withWriteDiff(withNormalization({
             host,
             hostId,
@@ -502,7 +508,8 @@ export function registerFlowTools(server, platform) {
             newVersion: written.newVersion,
             patchTargets: resolved.targets,
             flow: flowSummary(written.data),
-            ...(parameterWarnings.length > 0 ? { parameterWarnings } : {})
+            ...(parameterWarnings.length > 0 ? { parameterWarnings } : {}),
+            ...(platformWarnings.length > 0 ? { platformWarnings } : {})
         }, [...normalized, ...resolved.notes.map(note => `patch yolu seçiciden indekse çözüldü: ${note}`)]), drops), findings);
     }));
     server.registerTool('flow_delete', {

package/dist/tools/layouts.js

@@ -9,6 +9,8 @@ import { applyPropTypesToSchema, isSetPropTypeOp, setPropTypeErrors } from '../k
 import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
+import { applicationTypeField, resolveProfile } from '../knowledge/platform/resolve.js';
+import { screenProfileWarnings } from './profileWrite.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'.");
@@ -46,7 +48,13 @@ export function registerLayoutTools(server, platform) {
         description: "Layout'u komponent ağacı (views), widget'ları, akışları ve olaylarıyla getirir.",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid },
         annotations: readOnly
-    }, handle(config, ({ project, environment, applicationId, id }) => platform.tenant('GET', project, `/layouts/${applicationId}/${id}`, { environment })));
+    }, handle(config, async ({ project, environment, applicationId, id }) => {
+        const response = await platform.tenant('GET', project, `/layouts/${applicationId}/${id}`, { environment });
+        const typeField = applicationTypeField(await resolveProfile(platform, applicationId));
+        return response && typeof response === 'object' && !Array.isArray(response) && Object.keys(typeField).length > 0
+            ? { ...response, ...typeField }
+            : response;
+    }));
     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ığı. 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.",
@@ -61,20 +69,21 @@ export function registerLayoutTools(server, platform) {
         annotations: readOnly
     }, handle(config, async ({ project, environment, applicationId, id, mode, componentId }) => {
         const layout = await fetchHost(platform, 'layout', project, environment, applicationId, id);
+        const typeField = applicationTypeField(await resolveProfile(platform, applicationId));
         const audit = layout.audit;
         const updatedAt = audit?.updatedAt ?? audit?.createdAt;
         const views = (layout.views ?? []);
         if (mode === 'full')
-            return { updatedAt, views };
+            return { updatedAt, ...typeField, views };
         if (mode === 'subtree') {
             if (!componentId)
                 throw new PlatformApiError("mode='subtree' için componentId zorunludur.");
             const subtree = findNode(views, componentId);
             if (!subtree)
                 throw new PlatformApiError(`Layout'ta '${componentId}' id'li bir komponent yok; layout_schema_get'i summary kipinde çağırıp hedefi doğrulayın.`);
-            return { updatedAt, views: subtree };
+            return { updatedAt, ...typeField, views: subtree };
         }
-        return { updatedAt, views: views.map(node => summarize(node)) };
+        return { updatedAt, ...typeField, views: views.map(node => summarize(node)) };
     }));
     server.registerTool('layout_create', {
         title: 'Layout oluştur',
@@ -91,18 +100,27 @@ export function registerLayoutTools(server, platform) {
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, name, views, events, parameters }) => {
         assertScreenWriteGuards('layout', { schema: views, events });
+        const resolved = await resolveProfile(platform, applicationId);
         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ı)'), ...spacingLayerWarnings(views ?? [], 'LAY-010 (uyarı)', 'LAY-011 (uyarı)')];
+        const gaps = [
+            ...(resolved.profile.layout.blocksMeaningful ? verticalGapWarnings(views ?? [], 'LAY-003 (uyarı)') : []),
+            ...flexSizeWarnings(views ?? [], 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'),
+            ...spacingLayerWarnings(views ?? [], 'LAY-010 (uyarı)', 'LAY-011 (uyarı)'),
+            ...await screenProfileWarnings(platform, resolved, project, environment, applicationId, { kind: 'layout', nodes: views ?? [] })
+        ];
         const response = await platform.tenant('POST', project, `/layouts/${applicationId}`, {
             environment,
             body: { name, views: views ?? [], events: events ?? [], parameters: parameters ?? null }
         });
         const drops = writeDiff({ name, views: views ?? [], events: events ?? [] }, response);
         const normalized = withWriteDiff(withNormalization(response, [...componentDefaultsNote(fixed), ...catalogNotes, ...slotWarning(views)]), drops);
-        if (gaps.length === 0 || !normalized || typeof normalized !== 'object')
+        const typeField = applicationTypeField(resolved);
+        if (!normalized || typeof normalized !== 'object')
             return normalized;
-        return { ...normalized, layoutWarnings: gaps };
+        if (gaps.length === 0)
+            return Object.keys(typeField).length === 0 ? normalized : { ...normalized, ...typeField };
+        return { ...normalized, ...typeField, layoutWarnings: gaps };
     }));
     server.registerTool('layout_update', {
         title: 'Layout güncelle',
@@ -126,7 +144,15 @@ 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ı)'), ...spacingLayerWarnings(body.views, 'LAY-010 (uyarı)', 'LAY-011 (uyarı)')];
+        const resolved = overrides.views === undefined ? undefined : await resolveProfile(platform, applicationId);
+        const gaps = overrides.views === undefined || !resolved
+            ? []
+            : [
+                ...(resolved.profile.layout.blocksMeaningful ? verticalGapWarnings(body.views, 'LAY-003 (uyarı)') : []),
+                ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'),
+                ...spacingLayerWarnings(body.views, 'LAY-010 (uyarı)', 'LAY-011 (uyarı)'),
+                ...await screenProfileWarnings(platform, resolved, project, environment, applicationId, { kind: 'layout', nodes: body.views })
+            ];
         const summary = { id, changed: Object.keys(overrides), preserved: { viewNodes: body.views.length } };
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
@@ -193,7 +219,13 @@ 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ı)'), ...spacingLayerWarnings(body.views, 'LAY-010 (uyarı)', 'LAY-011 (uyarı)')];
+        const profile = await resolveProfile(platform, applicationId);
+        const gaps = [
+            ...(profile.profile.layout.blocksMeaningful ? verticalGapWarnings(body.views, 'LAY-003 (uyarı)') : []),
+            ...flexSizeWarnings(body.views, 'LAY-007 (uyarı)', 'LAY-008 (uyarı)'),
+            ...spacingLayerWarnings(body.views, 'LAY-010 (uyarı)', 'LAY-011 (uyarı)'),
+            ...await screenProfileWarnings(platform, profile, project, environment, applicationId, { kind: 'layout', nodes: body.views })
+        ];
         const summary = {
             id,
             applied: patchOps.length,

package/dist/tools/mobile.js

@@ -0,0 +1,203 @@
+import { z } from 'zod';
+import { environmentParam, guid, projectParam, writes } from './common.js';
+import { fetchHost, pageUpdateBody, unwrap } from './screens.js';
+import { fetchCatalogSlugs } from './components.js';
+import { mobileTabsWarnings } from './applications.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { handle } from '../platform/responses.js';
+import { ensurePageContainer } from '../knowledge/normalize.js';
+import { mobileProfile } from '../knowledge/platform/mobile.js';
+import { MAX_MOBILE_TABS } from '../knowledge/platform/mobileTabs.js';
+import { forgetApplication } from '../knowledge/platform/resolve.js';
+import { readKnowledgeFile } from '../resources/knowledge.js';
+/** Ana sayfa: açıkça verilen, yoksa ilk sekme, yoksa ilk sayfa. */
+function homepageSlug(input) {
+    return input.homepage ?? input.tabs?.[0]?.pageSlug ?? input.pages[0].pageSlug;
+}
+export function mobileAppInputErrors(input) {
+    const errors = [];
+    const slugs = input.pages.map(page => page.pageSlug);
+    const repeated = slugs.filter((slug, index) => slugs.indexOf(slug) !== index);
+    if (input.pages.length === 0)
+        errors.push('pages en az bir sayfa ister');
+    if (repeated.length > 0)
+        errors.push(`pages içinde tekrar eden slug var: ${[...new Set(repeated)].join(', ')}`);
+    if (input.tabs !== undefined) {
+        const tabSlugs = input.tabs.map(tab => tab.pageSlug);
+        if (input.tabs.length === 0)
+            errors.push("tabs verildiyse en az bir öğe taşır; sekme istemiyorsan alanı hiç gönderme (yığın)");
+        if (input.tabs.length > MAX_MOBILE_TABS)
+            errors.push(`tabs en fazla ${MAX_MOBILE_TABS} öğe taşır (${input.tabs.length} verildi) — fazlası yığına açılan sayfa olarak kalmalı`);
+        for (const slug of tabSlugs.filter(slug => !slugs.includes(slug)))
+            errors.push(`tabs '${slug}' pages içinde yok — sekme yalnız kurulan bir sayfayı gösterebilir`);
+        if (tabSlugs.some((slug, index) => tabSlugs.indexOf(slug) !== index))
+            errors.push('tabs içinde tekrar eden sayfa var');
+    }
+    if (input.homepage !== undefined && !slugs.includes(input.homepage))
+        errors.push(`homepage '${input.homepage}' pages içinde yok`);
+    return errors;
+}
+export function buildMobileAppPlan(input) {
+    const home = homepageSlug(input);
+    const others = input.pages.filter(page => page.pageSlug !== home);
+    return [
+        { step: 'application_create', tool: 'application_create', summary: "type:'mobile' uygulama; backend ana sayfayı kendisi açar" },
+        { step: 'layout_create', tool: 'layout_create', summary: `kabuk: app-bar + slot${input.drawer ? ' + drawer widget (app-bar.menuTarget)' : ''}` },
+        ...others.map((page, index) => ({ step: `page_create#${index + 1}`, tool: 'page_create', summary: `'${page.pageSlug}' (${page.pageName}), layoutId ile` })),
+        { step: 'page_update#homepage', tool: 'page_update', summary: `backend'in ana sayfası → '${home}' (ad, slug, layoutId)` },
+        ...(input.tabs ? [{ step: 'application_update', tool: 'application_update', summary: `properties.mobile.tabs: ${input.tabs.map(tab => tab.pageSlug).join(' · ')}` }] : [])
+    ];
+}
+/** Kabuk ağacı örnek dosyasından okunur — örnek ile aracın kurduğu layout tek kaynaktır. */
+function shellViews(input) {
+    const example = JSON.parse(readKnowledgeFile('examples', input.drawer ? 'mobile-app-shell-drawer.json' : 'mobile-app-shell-stack.json'));
+    const views = structuredClone(example.layoutCreate.views);
+    const appBar = views[0]?.children?.find(node => node.type === 'app-bar');
+    if (appBar && input.title)
+        appBar.props.title = { type: 'static', ref: null, data: input.title };
+    return views;
+}
+const SHELL_TYPES = ['app-bar', 'slot'];
+export function registerMobileTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('mobile_app_create', {
+        title: 'Mobil uygulamayı kabuğuyla kur',
+        description: "Mobil uygulamayı (type:'mobile'), kabuk layout'unu (app-bar + slot; drawer:true ise çekmece widget'ı), sayfalarını ve isteğe bağlı sekme ayarını (properties.mobile.tabs) TEK çağrıda kurar. Sıra: application_create → layout_create → page_create (sayfalar layoutId ile doğar) → backend'in açtığı ana sayfa seçilen ana sayfaya dönüştürülür (yetim sayfa kalmaz) → application_update (yalnız tabs verildiyse). tabs yoksa gezinme yığındır. dryRun:true planı döner, hiçbir şey yazmaz. Platformda işlem yoktur: hata olursa yanıt completed (kurulanlar), failed (düşen adım) ve remaining (kalanlar) taşır — kalanları tekil araçlarla tamamlayın. Kabuk bileşenleri (app-bar, slot) mobil katalogda yoksa layout atlanır ve uyarı döner. Rehber: platform_guide('mobile').",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            projectId: guid,
+            slug: z.string().min(1),
+            name: z.string().min(1),
+            color: z.string().optional(),
+            pages: z.array(z.object({ pageSlug: z.string().min(1), pageName: z.string().min(1) })).min(1),
+            tabs: z.array(z.object({ pageSlug: z.string().min(1), label: z.string().optional(), icon: z.string().optional() })).optional()
+                .describe(`1-${MAX_MOBILE_TABS} sekme; her pageSlug pages içinden. Verilmezse sekme çubuğu yok (yığın). label 't:<anahtar>' ile yazılırsa çeviri sözlüğünden çözülür (platform_guide('mobile') §Çok dil).`),
+            drawer: z.boolean().optional().describe("true: layout'a drawer widget'ı + app-bar.menuTarget (çekmece)"),
+            title: z.string().optional().describe('app-bar başlığı; boşsa her sayfanın adı yazılır'),
+            homepage: z.string().optional().describe('Ana sayfanın pageSlug\'ı; varsayılan ilk sekme, sekme yoksa ilk sayfa'),
+            dryRun: z.boolean().optional()
+        },
+        annotations: writes
+    }, handle(config, async ({ project, environment, projectId, slug, name, color, pages, tabs, drawer, title, homepage, dryRun }) => {
+        const input = { pages, ...(tabs ? { tabs } : {}), ...(drawer ? { drawer } : {}), ...(homepage ? { homepage } : {}), ...(title ? { title } : {}) };
+        const errors = mobileAppInputErrors(input);
+        if (errors.length > 0)
+            throw new PlatformApiError(`mobile_app_create: ${errors.join(' · ')}. Hiçbir şey yazılmadı.`, 400);
+        const plan = buildMobileAppPlan(input);
+        if (dryRun)
+            return { dryRun: true, plan };
+        const completed = [];
+        const skipped = new Set();
+        const warnings = [];
+        const home = homepageSlug(input);
+        const pageIds = new Map();
+        let applicationId;
+        let homepageId;
+        let layoutId;
+        let current = 'application_create';
+        try {
+            const created = unwrap(await platform.org('POST', `/applications/${projectId}`, {
+                environment,
+                body: { slug, name, type: 'mobile', ...(color ? { color } : {}) }
+            }));
+            applicationId = String(created.id ?? '');
+            homepageId = typeof created.homepageId === 'string'
+                ? created.homepageId
+                : String(created.homepage?.id ?? '');
+            forgetApplication(platform);
+            if (!applicationId || !homepageId)
+                throw new PlatformApiError('application_create yanıtı uygulama ya da ana sayfa kimliği taşımıyor — application_get ile kontrol edin.');
+            completed.push({ step: 'application_create', id: applicationId });
+            current = 'layout_create';
+            const catalog = await fetchCatalogSlugs(platform, project, environment, applicationId);
+            const missing = SHELL_TYPES.filter(type => !catalog.has(type));
+            if (missing.length > 0) {
+                skipped.add('layout_create');
+                warnings.push(`MOB-003 (uyarı) — kabuk bileşenleri mobil katalogda yok (${missing.join(', ')}): layout KURULMADI, sayfalar layout'suz açıldı. Katalog yazıldıktan sonra kabuğu ngapps://examples/mobile-app-shell-${input.drawer ? 'drawer' : input.tabs ? 'tab' : 'stack'} ile layout_create + page_update(layoutId) olarak kurun.`);
+            }
+            else {
+                const layout = unwrap(await platform.tenant('POST', project, `/layouts/${applicationId}`, {
+                    environment,
+                    body: { name: `${name} kabuğu`, views: shellViews(input), events: [], parameters: null }
+                }));
+                layoutId = String(layout.id ?? '');
+                completed.push({ step: 'layout_create', id: layoutId });
+            }
+            const others = pages.filter(page => page.pageSlug !== home);
+            for (const [index, page] of others.entries()) {
+                current = `page_create#${index + 1}`;
+                const saved = unwrap(await platform.tenant('POST', project, `/pages/${applicationId}`, {
+                    environment,
+                    body: {
+                        name: page.pageName,
+                        slug: page.pageSlug,
+                        browserTitle: '',
+                        browserTitleKey: '',
+                        layoutId: layoutId ?? null,
+                        roleIds: [],
+                        middlewareIds: [],
+                        events: [],
+                        schema: ensurePageContainer([], mobileProfile.layout.rootContainer).schema
+                    }
+                }));
+                pageIds.set(page.pageSlug, String(saved.id ?? ''));
+                completed.push({ step: current, id: String(saved.id ?? '') });
+            }
+            current = 'page_update#homepage';
+            const homePage = pages.find(page => page.pageSlug === home);
+            const existing = await fetchHost(platform, 'page', project, environment, applicationId, homepageId);
+            await platform.tenant('PUT', project, `/pages/${applicationId}/${homepageId}`, {
+                environment,
+                body: pageUpdateBody(existing, { name: homePage.pageName, slug: homePage.pageSlug, layoutId: layoutId ?? null })
+            });
+            pageIds.set(home, homepageId);
+            completed.push({ step: current, id: homepageId });
+            if (tabs) {
+                current = 'application_update';
+                const properties = {
+                    mobile: {
+                        tabs: {
+                            enabled: true,
+                            style: 'default',
+                            showLabels: true,
+                            items: tabs.map(tab => ({ page: pageIds.get(tab.pageSlug), ...(tab.label ? { label: tab.label } : {}), ...(tab.icon ? { icon: tab.icon } : {}) }))
+                        }
+                    }
+                };
+                warnings.push(...await mobileTabsWarnings(platform, applicationId, platform.resolveProject(project), homepageId, properties));
+                await platform.org('PUT', `/applications/${applicationId}`, {
+                    environment,
+                    body: { slug, name, homepageId, ...(color ? { color } : {}), properties }
+                });
+                forgetApplication(platform, applicationId);
+                completed.push({ step: current });
+            }
+        }
+        catch (error) {
+            if (completed.length === 0)
+                throw error;
+            const done = new Set(completed.map(entry => entry.step));
+            return {
+                applicationId,
+                ...(layoutId ? { layoutId } : {}),
+                completed,
+                failed: { step: current, error: error instanceof Error ? error.message : String(error) },
+                remaining: plan.map(step => step.step).filter(step => !done.has(step) && !skipped.has(step) && step !== current),
+                ...(warnings.length > 0 ? { warnings } : {}),
+                note: 'Kurulum yarıda kaldı: completed kurulanları, remaining eksik adımları söyler. Kalanları tekil araçlarla tamamlayın (page_create, page_update, application_update) — mobile_app_create aynı slug ile tekrar çağrılırsa uygulamayı ikinci kez açmaya çalışır.'
+            };
+        }
+        return {
+            applicationId,
+            homepageId,
+            ...(layoutId ? { layoutId } : {}),
+            applicationType: 'mobile',
+            pages: pages.map(page => ({ slug: page.pageSlug, name: page.pageName, id: pageIds.get(page.pageSlug), ...(page.pageSlug === home ? { homepage: true } : {}) })),
+            ...(tabs ? { tabs: tabs.map(tab => tab.pageSlug) } : {}),
+            completed,
+            ...(warnings.length > 0 ? { warnings } : {}),
+            next: "Ekranları page_schema_patch ile doldurun; doğrulama page_screenshot (mobilde varsayılan device: 'phone'). platform_guide('mobile')."
+        };
+    }));
+}