@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.7

package/dist/tools/screenWrite.js

@@ -0,0 +1,68 @@
+import { invalidScreenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, blockSizeNote, heightTypeNote, sizeStringNote } from '../knowledge/normalize.js';
+import { FUNCTIONS_NAMESPACE } from '../knowledge/functionGuards.js';
+import { applyCatalogLayoutRules } from './components.js';
+import { PlatformApiError } from '../platform/errors.js';
+const GUARD_CODES = {
+    page: { events: 'PAGE-011', widgets: 'PAGE-012', noun: 'sayfa', tree: 'schema' },
+    layout: { events: 'LAY-004', widgets: 'LAY-005', noun: 'layout', tree: 'views' }
+};
+/**
+ * JS tanımlayıcısı olmayan ya da AYRILMIŞ `name` alanlarını toplar; ad
+ * `const <ad> = Components["<ad>"]` üretimine girer.
+ */
+export function invalidComponentNames(nodes) {
+    const found = [];
+    for (const node of nodes ?? []) {
+        const name = node.name;
+        if (typeof name === 'string' && name.length > 0 && !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name.replace(/-/g, ''))) {
+            found.push(`'${name}' (${node.elementId ?? '?'})`);
+        }
+        else if (typeof name === 'string' && name.replace(/-/g, '') === FUNCTIONS_NAMESPACE) {
+            // K1: preamble her komponent için `const <ad> = Components["<ad>"]` üretir; `Functions` adlı
+            // komponent kullanıcı fonksiyonlarının ad alanını ezer ve sayfadaki her Functions.x() ölür.
+            found.push(`'${name}' (${node.elementId ?? '?'}) — ayrılmış ad: ${FUNCTIONS_NAMESPACE} kullanıcı fonksiyonlarının ad alanıdır (K1)`);
+        }
+        found.push(...invalidComponentNames(node.children));
+    }
+    return found;
+}
+/**
+ * Sayfa ve layout yazma yollarının ORTAK kapısı: olay adı (PAGE-011 · LAY-004), widget düğümü
+ * (PAGE-012 · LAY-005), komponent adı (PAGE-009) ve iç içe repeater (PAGE-013) denetimleri —
+ * hepsi istek gitmeden 400.
+ *
+ * PAGE-009 ve PAGE-013'ün layout ayağı 2026-09-09'da eklendi: ikisi de yalnız sayfa yollarında
+ * koşuyordu, oysa layout `views`'ü aynı runtime'dan geçer — bozuk ad o layout'a bağlı HER
+ * sayfanın ifadelerini öldürür, iç içe repeater'ın geri yazma kırılması ise yapısaldır ve
+ * barındıranın sayfa mı layout mu olduğuna bakmaz.
+ */
+export function assertScreenWriteGuards(kind, screen) {
+    const codes = GUARD_CODES[kind];
+    const badEvents = invalidScreenEventNames(screen.events, codes.events);
+    if (badEvents.length > 0)
+        throw new PlatformApiError(`Geçersiz ${codes.noun} olayı (istek gönderilmedi): ${badEvents.join(' · ')}`, 400);
+    const badWidgets = invalidWidgetTypeNodes(screen.schema, codes.widgets);
+    if (badWidgets.length > 0)
+        throw new PlatformApiError(`Geçersiz widget düğümü (istek gönderilmedi): ${badWidgets.join(' · ')}`, 400);
+    const badNames = invalidComponentNames(screen.schema);
+    if (badNames.length > 0) {
+        throw new PlatformApiError(`PAGE-009 — komponent adı JS tanımlayıcısı değil ya da ayrılmış (istek gönderilmedi): ${badNames.join(' · ')}. `
+            + 'Runtime her komponent için `const <ad> = Components["<ad>"]` üretir; boşluklu ya da geçersiz bir ad '
+            + 'SAYFADAKİ TÜM ifadeleri "Missing initializer in const declaration" ile öldürür (layout adları her sayfaya sızar). '
+            + `name alanını elementId ile aynı yaz; okunabilir Türkçe başlık için props.title / props.text / props.label kullan (${codes.noun} ${codes.tree}).`, 400);
+    }
+    const nested = nestedRepeaterNodes(screen.schema);
+    if (nested.length > 0)
+        throw new PlatformApiError(nestedRepeaterMessage(nested), 400);
+}
+/**
+ * Katalog kurallarını (blok sınırı · auto-height · boyut string'i) ağaca uygular ve
+ * `withNormalization` kuyruğuna giren üç notu döndürür. Boş/verilmemiş ağaçta katalog
+ * okunmaz — uygulanacak düğüm yoktur, notlar da boş çıkardı.
+ */
+export async function screenCatalogNotes(platform, project, environment, applicationId, nodes) {
+    if (!Array.isArray(nodes) || nodes.length === 0)
+        return [];
+    const catalog = await applyCatalogLayoutRules(platform, project, environment, applicationId, nodes);
+    return [...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes)];
+}

package/dist/tools/screens.js

@@ -31,6 +31,33 @@ export function summarize(node, styleSource) {
     }
     return summary;
 }
+/**
+ * Yazma yanıtındaki `appliedPatch` gövdesini iskelete indirger (B-55 · S-9).
+ *
+ * Alanın KANIT değeri path'indedir: "gerçekten yalnız o komponente mi dokunuldu" sorusunu
+ * JSON Pointer cevaplar (`page.md` Kural 2). `value` ise ajanın aynı turda KENDİ gönderdiği
+ * gövdenin yankısıdır — `add_component`'te eklenen alt ağacın tamamı, `replace_prop`'ta
+ * yazılan Prop'un tamamı (`AppliedJsonPatch(Op, Path, Value)`). 2026-09-06·2 koşusunda on
+ * dört yazma çağrısının yanıtı bağlamın en büyük tek kalemiydi.
+ *
+ * Kanıt kaybı yok: yamanın KAYDEDİLDİĞİNİ `appliedPatch` zaten söylemiyordu (G-23). Onu
+ * yamadan sonra okunan şemayla karşılaştıran `schemaOpDrops` söylüyor ve sonucu yanıtta
+ * `silentlyDropped` olarak duruyor. Tam gövde `view: 'full'` ile alınır.
+ */
+export function outlineAppliedPatch(applied) {
+    if (!Array.isArray(applied))
+        return applied;
+    return applied.map(entry => {
+        if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+            return entry;
+        const record = entry;
+        const value = record.value;
+        const node = value && typeof value === 'object' && !Array.isArray(value) && typeof value.elementId === 'string'
+            ? summarize(value)
+            : undefined;
+        return { op: record.op, path: record.path, ...(node ? { component: node } : {}) };
+    });
+}
 /** elementId ya da id ile ağaçta düğüm bulur. */
 export function findNode(nodes, target) {
     for (const node of nodes ?? []) {
@@ -77,6 +104,7 @@ export function pageUpdateBody(page, overrides = {}) {
         name: page.name,
         slug: page.slug,
         browserTitle: page.browserTitle ?? '',
+        browserTitleKey: page.browserTitleKey ?? '',
         schema: page.schema ?? [],
         events: asArray(page.events).filter(event => event?.value),
         middlewareIds: page.middlewareIds ?? [],

package/dist/tools/templates.js

@@ -1,6 +1,30 @@
 import { guid, pagingParams, readOnly, writes, updates } from './common.js';
+import { withNormalization } from '../knowledge/normalize.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
+/**
+ * `environmentId` verilmediğinde platform PRODUCTION'ı paketler
+ * (`CreateProjectAsTemplateCommand`: `EnvironmentId ??= ActiveEnvironments().First(f => f.IsProduction)`).
+ * Promote edilmemiş projede o environment boştur ve build yine 'success' döner; şablon seed
+ * kayıtlarından ibaret kalır. Çağıran bunu yanıttan görmediği için hangi environment'ın
+ * paketlendiğini adıyla söylüyoruz (2026-09-12 koşusu S-2).
+ */
+async function defaultTemplateEnvironmentNote(platform, projectId) {
+    const fallback = "environmentId verilmedi: platform PRODUCTION environment'ını paketler (varsayılan/development değil). Promote edilmemiş projede şablon boş çıkar; development içeriğini istiyorsanız o environment'ın id'sini açıkça verin.";
+    try {
+        const payload = await platform.org('GET', `/projects/${projectId}`);
+        const environments = Array.isArray(payload?.data?.environments)
+            ? payload.data.environments
+            : [];
+        const production = environments.find(environment => environment.isProduction === true);
+        if (!production)
+            return fallback;
+        return `environmentId verilmedi: platform '${String(production.name)}' (production, id ${String(production.id)}) environment'ını paketler — varsayılan/development environment'ı DEĞİL. Oraya henüz promote etmediyseniz şablon yalnız seed kayıtlarını taşır; development içeriğini paketlemek için o environment'ın id'sini açıkça verin.`;
+    }
+    catch {
+        return fallback;
+    }
+}
 export function registerTemplateTools(server, platform) {
     const config = platform.config;
     server.registerTool('template_list', {
@@ -24,31 +48,34 @@ export function registerTemplateTools(server, platform) {
         description: "Şablonun bir modüldeki kayıtlarını listeler (project_create'in templateOptions.filters'ını doldurmak için).",
         inputSchema: {
             id: guid,
-            module: z.string().describe("Module değeri: entity | microservice | workflow | page | layout | component | query | view …")
+            module: z.string().describe("Module değeri: entity | microservice | workflow | page | layout | component | query | view | variable | global-function (fonksiyonlar, iki kaynak) | flow … (platform Module enum değeri, kebab-case)")
         },
         annotations: readOnly
     }, handle(config, ({ id, module }) => platform.org('GET', `/templates/${id}/items`, { query: { module } })));
     server.registerTool('template_create', {
         title: 'Projeyi şablon olarak yayımla',
-        description: 'Mevcut projeden yeni bir şablon sürümü üretir. Görsel yükleme bu tool\'da desteklenmez (ikili aktarım kapsam dışı).',
+        description: "Mevcut projeden yeni bir şablon sürümü üretir. **Paketlenen environment `environmentId`'dir ve boş bırakılırsa platform PRODUCTION'ı paketler** (`CreateProjectAsTemplateCommand`: `EnvironmentId ??= ActiveEnvironments().First(f => f.IsProduction)`) — 'varsayılan environment' DEĞİL. Henüz promote edilmemiş projede production boştur: build 'success' döner ama şablon yalnız seed kayıtlarını taşır (microfunction/workflow/microservice sıfır). Geliştirmede yazdığınız içeriği paketlemek için development environment id'sini AÇIKÇA verin. Build asenkrondur: yanıt hemen döner, sürüm birkaç saniye sonra template_list'te görünür; içeriği template_items ile doğrulayın. Görsel yükleme bu tool'da desteklenmez (ikili aktarım kapsam dışı).",
         inputSchema: {
             projectId: guid,
             name: z.string().min(1),
             version: z.string().min(1).describe("Sürüm etiketi, ör. '1.0.0'"),
             description: z.string().optional(),
             changeLog: z.string().optional(),
-            environmentId: guid.optional().describe('Hangi environment\'ın içeriği paketlenecek; boşsa varsayılan')
+            environmentId: guid.optional().describe("Hangi environment'ın içeriği paketlenecek. BOŞSA PRODUCTION paketlenir (projenin varsayılan/development environment'ı değil) — development içeriğini şablona koyacaksanız o environment'ın id'sini açıkça verin.")
         },
         annotations: writes
-    }, handle(config, ({ projectId, name, version, description, changeLog, environmentId }) => {
+    }, handle(config, async ({ projectId, name, version, description, changeLog, environmentId }) => {
         const form = new URLSearchParams({ Name: name, Version: version });
+        const normalized = [];
         if (description)
             form.set('Description', description);
         if (changeLog)
             form.set('ChangeLog', changeLog);
         if (environmentId)
             form.set('EnvironmentId', environmentId);
-        return platform.org('POST', `/projects/${projectId}/templates`, { form });
+        else
+            normalized.push(await defaultTemplateEnvironmentNote(platform, projectId));
+        return withNormalization(await platform.org('POST', `/projects/${projectId}/templates`, { form }), normalized);
     }));
     server.registerTool('template_check_updates', {
         title: 'Şablon güncellemesi var mı',

package/dist/tools/translations.js

@@ -1,22 +1,38 @@
 import { guid, projectParam, environmentParam, readOnly, updates } from './common.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
+import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
+import { readProjectLanguages, translationLanguageFindings } from '../knowledge/languages.js';
+import { policyRules } from '../knowledge/rules.js';
 const translationKeyInput = z.object({
     key: z.string().min(1),
-    values: z.record(z.string()).describe("Dil kodu (ISO 639-1) → çeviri metni; kodlar projenin languages listesinde (project_get/project_update) tanımlı olmalı"),
+    values: z.record(z.string().regex(/^[a-z]{2}$/, 'ISO 639-1 iki harfli küçük dil kodu (tr, en, de …); tr-TR gibi bölge ekli kod reddedilir'), z.string()).describe("Dil kodu (ISO 639-1, iki küçük harf) → çeviri metni. Platform kodu yalnız 184 kodluk ISO sözlüğüne göre doğrular (TR-001); PROJENİN languages listesine göre doğrulamaz — o bağı gateway kurar (TR-002)"),
     componentId: guid.optional().describe("Çeviriyi belirli bir komponente bağlar; o komponent silinince kaydı da silinir")
 });
+/**
+ * Yazma öncesi projenin dil durumunu okur. Proje okunamazsa (uç düşer, yetki yoksa) kontrol
+ * ATLANIR ve karar platforma kalır — `project_create`'in slug ön aramasındaki (PRJ-001) davranışın
+ * aynısı. Uydurma bulgu üretilmez.
+ */
+async function languageFindings(platform, project, keys) {
+    const slug = platform.resolveProject(project);
+    const codes = keys.flatMap(entry => Object.keys(entry.values ?? {}));
+    if (codes.length === 0)
+        return [];
+    const payload = await platform.org('GET', `/p/${slug}`).catch(() => undefined);
+    return translationLanguageFindings(readProjectLanguages(payload), codes, slug);
+}
 export function registerTranslationTools(server, platform) {
     const config = platform.config;
     server.registerTool('translation_list', {
         title: 'Çevirileri listele',
-        description: "Application'ın tüm çeviri kayıtlarını (dil × anahtar × değer) düz liste olarak döner. Proje dilleri/varsayılan dil için project_get; sayfada bir prop'u çeviriye bağlamak için platform_guide('translation').",
+        description: "Application'ın tüm çeviri kayıtlarını (dil × anahtar × değer) düz liste olarak döner. Proje dilleri/varsayılan dil için project_get (yanıtındaki localization bloğu runtime'ın bu çevirileri çözüp çözemeyeceğini söyler); sayfada bir prop'u çeviriye bağlamak için platform_guide('translation').",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid },
         annotations: readOnly
     }, handle(config, ({ project, environment, applicationId }) => platform.tenant('GET', project, `/translations/${applicationId}`, { environment })));
     server.registerTool('translation_update', {
         title: 'Çevirileri güncelle',
-        description: "Bir ya da daha çok çeviri anahtarını toplu ekler/günceller (keys) ve/veya siler (deletedKeys) — tek çağrıda ikisi de verilebilir. 'keys' üzerinden yeni bir anahtar da açılabilir (upsert). 'values'taki dil kodları projenin languages listesinde tanımlı olmalı, aksi hâlde platform reddeder.",
+        description: "Bir ya da daha çok çeviri anahtarını toplu ekler/günceller (keys) ve/veya siler (deletedKeys) — tek çağrıda ikisi de verilebilir. 'keys' üzerinden yeni bir anahtar da açılabilir (upsert; verilmeyen diller silinmez, korunur). DİKKAT: çeviri yazmak tek başına YETMEZ — runtime bir etiketi ancak projenin languages listesi ve defaultLanguage kuruluysa çözer, aksi hâlde ekrana ham anahtar basar ve yazma yine 200 döner (ölçüldü 2026-09-09, S-15). Gateway yazmadan önce projeyi okur ve bağ kopuksa TR-002 caution'ı düşer; dilleri project_update(languages, defaultLanguage) ile kurun. Backend ön kontrolü (TR-001, block): anahtarlar boş olamaz ve tekil, dil kodları ISO 639-1 listesinden, deletedKeys boş olamaz.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -25,13 +41,13 @@ export function registerTranslationTools(server, platform) {
             deletedKeys: z.array(z.string().min(1)).optional().describe('Silinecek anahtar adları')
         },
         annotations: updates
-    }, handle(config, ({ project, environment, applicationId, keys, deletedKeys }) => {
+    }, handle(config, async ({ project, environment, applicationId, keys, deletedKeys }) => {
         if (!keys?.length && !deletedKeys?.length) {
             throw new Error("'keys' ya da 'deletedKeys' parametrelerinden en az biri dolu olmalı.");
         }
-        return platform.tenant('PUT', project, `/translations/${applicationId}`, {
-            environment,
-            body: { keys: keys ?? [], deletedKeys: deletedKeys ?? [] }
-        });
+        const body = { keys: keys ?? [], deletedKeys: deletedKeys ?? [] };
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'translation', body, { operation: 'update' }));
+        const languages = await languageFindings(platform, project, keys ?? []);
+        return attachFindings(await platform.tenant('PUT', project, `/translations/${applicationId}`, { environment, body }), [...findings, ...languages]);
     }));
 }

package/dist/tools/views.js

@@ -3,6 +3,12 @@ import { guid, projectParam, environmentParam, definitionParam, pagingParams, re
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
+import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
+import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
+import { policyRules } from '../knowledge/rules.js';
+import { constraintSummary } from '../knowledge/backendConstraints.js';
+const policyOverrideParam = z.boolean().optional()
+    .describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
 export function registerViewTools(server, platform) {
     const config = platform.config;
     const normalizeSource = (definition) => {
@@ -19,29 +25,33 @@ export function registerViewTools(server, platform) {
     }, handle(config, ({ project, environment, ...query }) => platform.tenant('GET', project, '/views', { environment, query })));
     server.registerTool('view_get', {
         title: 'View getir',
-        description: 'Tek view tanımını getirir; view_create için en iyi gövde şablonudur.',
+        description: "Tek view tanımını getirir; view_create için en iyi gövde şablonudur. Hatırlatma: view TAM METİN ARAMA indeksidir, agregasyon/raporlama aracı değildir — özet için query_create (09-02 M-3).",
         inputSchema: { project: projectParam, environment: environmentParam, id: guid },
         annotations: readOnly
     }, handle(config, ({ project, environment, id }) => platform.tenant('GET', project, `/views/${id}`, { environment })));
     server.registerTool('view_create', {
         title: 'View oluştur',
-        description: "TAM METİN ARAMA indeksi tanımlar (definition = CreateViewCommand; gövde şeması ngapps://schemas/CreateViewCommand, analizör sözlüğü platform_guide('view')) — raporlama/agregasyon aracı DEĞİLDİR. Seçilen tablo/alanlar analizörden (tokenizer/dil) geçirilip slug adlı projeksiyon tablosuna indekslenir; tüketimi source:'view' microservice'idir ve o uç ZORUNLU 'searchText' parametresi ister (+limit/offset). Rapor/özet için raw query (query_create) + query kaynaklı microservice kullanın. Birden çok entity verilebilir (entities: [{entityId, alias}], fields alias'la bağlanır: viewEntityAlias) ama bu JOIN DEĞİLDİR: her tablo ayrı ayrı indekslenir, aralarında ilişki tanımı yoktur ve eşleşme hangi tablodan geldiyse dönen kayıt o tablonun satırıdır. İlişkili içeriği tek kayıtta aratmak için denormalize bir alan kullanın (yorum metnini talebe yazan automation + tek entity'li view).",
-        inputSchema: { project: projectParam, environment: environmentParam, definition: definitionParam },
+        description: "TAM METİN ARAMA indeksi tanımlar (definition = CreateViewCommand; gövde şeması ngapps://schemas/CreateViewCommand, analizör sözlüğü platform_guide('view')) — raporlama/agregasyon aracı DEĞİLDİR. Seçilen tablo/alanlar analizörden (tokenizer/dil) geçirilip slug adlı projeksiyon tablosuna indekslenir; tüketimi source:'view' microservice'idir ve o uç ZORUNLU 'searchText' parametresi ister (+limit/offset). Rapor/özet için raw query (query_create) + query kaynaklı microservice kullanın. Birden çok entity verilebilir (entities: [{entityId, alias}], fields alias'la bağlanır: viewEntityAlias) ama bu JOIN DEĞİLDİR: her tablo ayrı ayrı indekslenir, aralarında ilişki tanımı yoktur ve eşleşme hangi tablodan geldiyse dönen kayıt o tablonun satırıdır. İlişkili içeriği tek kayıtta aratmak için denormalize bir alan kullanın (yorum metnini talebe yazan automation + tek entity'li view). " + constraintSummary('CreateViewCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
-    }, handle(config, async ({ project, environment, definition }) => {
+    }, handle(config, async ({ project, environment, definition, policyOverride }) => {
         const fixes = normalizeSource(definition);
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'view', definition, { operation: 'create' }, policyOverride));
+        const drift = unmappedMembers('CreateViewCommand', definition);
         const response = await platform.tenant('POST', project, '/views', { environment, body: definition });
-        return withNormalization(response, viewAliasNote(fixes));
+        return attachFindings(withUnmappedMembers(withNormalization(response, viewAliasNote(fixes)), drift), findings);
     }));
     server.registerTool('view_update', {
         title: 'View güncelle',
-        description: "View tanımını günceller (definition = UpdateViewCommand, şema ngapps://schemas/UpdateViewCommand); mevcut hâli view_get ile alın. UpdateViewCommand'da datasourceId YOKTUR (create'te bağlanır). DİKKAT: view_get alanları 'viewEntityId' ile döndürür, yazma tarafı 'viewEntityAlias' ister — okuduğunuzu birebir geri yazarsanız gateway id'yi alias'a çevirir, çeviremezse isteği reddeder.",
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid, definition: definitionParam },
+        description: "View tanımını günceller (definition = UpdateViewCommand, şema ngapps://schemas/UpdateViewCommand); mevcut hâli view_get ile alın. UpdateViewCommand'da datasourceId YOKTUR (create'te bağlanır). DİKKAT: view_get alanları 'viewEntityId' ile döndürür, yazma tarafı 'viewEntityAlias' ister — okuduğunuzu birebir geri yazarsanız gateway id'yi alias'a çevirir, çeviremezse isteği reddeder. " + constraintSummary('UpdateViewCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: updates
-    }, handle(config, async ({ project, environment, id, definition }) => {
+    }, handle(config, async ({ project, environment, id, definition, policyOverride }) => {
         const fixes = normalizeSource(definition);
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'view', definition, { operation: 'update' }, policyOverride));
+        const drift = unmappedMembers('UpdateViewCommand', definition);
         const response = await platform.tenant('PUT', project, `/views/${id}`, { environment, body: definition });
-        return withNormalization(response, viewAliasNote(fixes));
+        return attachFindings(withUnmappedMembers(withNormalization(response, viewAliasNote(fixes)), drift), findings);
     }));
     server.registerTool('view_delete', {
         title: 'View sil',
@@ -51,7 +61,7 @@ export function registerViewTools(server, platform) {
     }, handle(config, ({ project, environment, id }) => platform.tenant('DELETE', project, `/views/${id}`, { environment })));
     server.registerTool('view_rebuild', {
         title: 'View yeniden kur',
-        description: 'View projeksiyon tablosunu yeniden inşa eder (veri değişikliklerinden sonra senkron için).',
+        description: "View projeksiyon tablosunu yeniden inşa eder (veri değişikliklerinden sonra senkron için). Rebuild ARAMA indeksini tazeler; sayım/özet üretmez — raporlama için query_create (09-02 M-3).",
         inputSchema: { project: projectParam, environment: environmentParam, id: guid },
         annotations: writes
     }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/views/${id}/rebuild`, { environment })));

package/dist/tools/workflows.js

@@ -1,11 +1,16 @@
-import { guid, projectParam, environmentParam, definitionParam, pagingParams, readOnly, writes, updates, destructive } from './common.js';
+import { guid, projectParam, environmentParam, definitionParam, pagingParams, readOnly, writes, updates, destructive, microOps, languageParam } from './common.js';
 import { normalizeWorkflowDefinition, withNormalization } from '../knowledge/normalize.js';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
 import { workflowOutline, resolvePart, resolvePatchOperations } from '../knowledge/outlines.js';
-import { policyRules } from '../knowledge/rules.js';
+import { patchResult, baseVersionOf } from '../platform/patch.js';
+import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
+import { policyRules, microfunctionStepFindings } from '../knowledge/rules.js';
+import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import fastJsonPatch from 'fast-json-patch';
 import { z } from 'zod';
+import { constraintSummary } from '../knowledge/backendConstraints.js';
+import { unmappedMembers, introducedUnmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
 const policyOverrideParam = z.boolean().optional()
     .describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
 const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
@@ -106,44 +111,65 @@ export function registerWorkflowTools(server, platform) {
     }));
     server.registerTool('workflow_create', {
         title: 'Workflow oluştur',
-        description: "Yeni workflow tanımlar (definition = CreateWorkflowCommand). type: 'workflow' | 'automation' | 'middleware'. İlk kullanımdan önce platform_guide('workflow') okuyun: DTO-önce akışı, branch bağlama (branches[].nextStepId), tip×step matrisi. Her adım ve akışın kendisi 'description' taşımak ZORUNDADIR (WF-024, block): adımın NE İŞE YARADIĞINI 1-2 cümleyle yazın — Studio kanvasında ⓘ ikonu olarak görünür; mekanizmayı değil niyeti yazın. Middleware (istek öncesi koşan guard/setter, user değişkeni, alfabetik sıra) için platform_guide('middleware') + ngapps://examples/middleware-authenticate. Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) 'caution' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer.",
+        description: "Yeni workflow tanımlar (definition = CreateWorkflowCommand). type: 'workflow' | 'automation' | 'middleware'. İlk kullanımdan önce platform_guide('workflow') okuyun: DTO-önce akışı, branch bağlama (branches[].nextStepId), tip×step matrisi. Her adım ve akışın kendisi 'description' taşımak ZORUNDADIR (WF-024, block): adımın NE İŞE YARADIĞINI 1-2 cümleyle yazın — Studio kanvasında ⓘ ikonu olarak görünür; mekanizmayı değil niyeti yazın. Middleware (istek öncesi koşan guard/setter, user değişkeni, alfabetik sıra) için platform_guide('middleware') + ngapps://examples/middleware-authenticate. Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) 'caution' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer. " + constraintSummary('CreateWorkflowCommand'),
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
-        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: definition.type }, policyOverride));
+        const findings = enforcePolicy([
+            ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: definition.type }, policyOverride),
+            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride)
+        ]);
+        const drift = unmappedMembers('CreateWorkflowCommand', definition);
         const payload = await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition });
-        return attachFindings(withNormalization(payload, normalized), findings);
+        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
     }));
     server.registerTool('workflow_update', {
         title: 'Workflow güncelle',
-        description: 'Workflow tanımını günceller (definition = UpdateWorkflowCommand, tam gövde). Hedefli değişiklik için workflow_patch tercih edin. Her adım ve akışın kendisi \'description\' taşımak ZORUNDADIR (WF-024, block). Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) \'caution\' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer.',
+        description: 'Workflow tanımını günceller (definition = UpdateWorkflowCommand, tam gövde). Hedefli değişiklik için workflow_patch tercih edin. Her adım ve akışın kendisi \'description\' taşımak ZORUNDADIR (WF-024, block). Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) \'caution\' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer. ' + constraintSummary('UpdateWorkflowCommand'),
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, definition, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
-        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride));
+        const findings = enforcePolicy([
+            ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride),
+            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride)
+        ]);
+        const drift = unmappedMembers('UpdateWorkflowCommand', definition);
         const payload = await platform.tenant('PUT', project, `/workflows/${applicationId}/${id}`, { environment, body: definition });
-        return attachFindings(withNormalization(payload, normalized), findings);
+        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
     }));
     server.registerTool('workflow_patch', {
         title: 'Workflow\'a patch uygula',
-        description: 'Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut workflow\'u çeker, JSON Patch işlemlerini uygular, politika kontrolünden geçirir, tam gövdeyi geri yazar. Değişiklik hedefli ama yazma değil: hata yolu olmayan bir workflow/middleware kaydına patch atmak o kaydın grafiğini de düzeltir — start adımına global-error dalı + 500 dönen response adımı eklenir ve yanıtta gatewayNormalized ile bildirilir. Yanıt outline özetidir.',
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, operations: patchOperationsParam, policyOverride: policyOverrideParam },
+        description: 'Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut workflow\'u çeker, JSON Patch işlemlerini uygular, politika kontrolünden geçirir ve FARKI platformun PATCH /workflows/{app}/{id} ucuna `{ baseVersion, ops }` olarak yazar — tam gövde PUT\'u ATILMAZ. `baseVersion` okunan kaydın `version` alanıdır; kayıt bu arada değiştiyse platform 409 döner ve hiçbir op uygulanmaz. Değişiklik hedefli ama yazma değil: hata yolu olmayan bir workflow/middleware kaydına patch atmak o kaydın grafiğini de düzeltir — start adımına global-error dalı + 500 dönen response adımı eklenir ve yanıtta gatewayNormalized ile bildirilir. Yanıt outline özetidir.',
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, operations: patchOperationsParam.optional(), ops: patchOperationsParam.optional().describe("'operations' ile aynı alan (eşanlamlı) — sayfa micro-op tool'larıyla aynı adı kullanabilmeniz için"), policyOverride: policyOverrideParam },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, id, operations, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, id, operations: givenOperations, ops, policyOverride }) => {
+        const operations = microOps('workflow_patch', ops, givenOperations);
         const current = await platform.tenant('GET', project, `/workflows/${applicationId}/${id}`, { environment });
         const definition = structuredClone((current?.data ?? current));
         const resolved = resolvePatchOperations(definition, operations);
         const patched = fastJsonPatch.applyPatch(definition, resolved.operations, true, false).newDocument;
         const normalized = normalizeWorkflowDefinition(patched);
-        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', patched, { operation: 'update', workflowKind: patched.type }, policyOverride));
-        await platform.tenant('PUT', project, `/workflows/${applicationId}/${id}`, { environment, body: patched });
-        return attachFindings(withNormalization({
+        const findings = enforcePolicy([
+            ...evaluatePolicy(config, policyRules, 'workflow', patched, { operation: 'update', workflowKind: patched.type }, policyOverride),
+            ...await microfunctionStepFindings(platform, project, environment, patched, patched.type, policyOverride)
+        ]);
+        const drift = introducedUnmappedMembers('UpdateWorkflowCommand', (current?.data ?? current), patched);
+        // Gövde değil FARK gönderilir: gateway normalizasyonları da op'a çevrilsin diye net diff
+        // okunan kayıt ile son hâl arasından hesaplanır (tam PUT yok, yalnız değişen alanlar yazılır).
+        const netOps = fastJsonPatch.compare(definition, patched);
+        const saved = await platform.tenant('PATCH', project, `/workflows/${applicationId}/${id}`, {
+            environment,
+            body: { baseVersion: baseVersionOf(definition, 'workflow_get'), ops: netOps }
+        });
+        const written = patchResult(saved, patched);
+        return attachFindings(withUnmappedMembers(withNormalization({
             applied: operations.length,
+            newVersion: written.newVersion,
             patchTargets: resolved.targets,
-            outline: workflowOutline(patched)
-        }, [...normalized, ...resolved.notes.map(note => `patch yolu seçiciden indekse çözüldü: ${note}`)]), findings);
+            outline: workflowOutline(written.data)
+        }, [...normalized, ...resolved.notes.map(note => `patch yolu seçiciden indekse çözüldü: ${note}`)]), drift), findings);
     }));
     server.registerTool('workflow_delete', {
         title: 'Workflow sil',
@@ -159,13 +185,22 @@ export function registerWorkflowTools(server, platform) {
     }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/workflows/clone/${id}`, { environment })));
     server.registerTool('workflow_preview', {
         title: 'Workflow önizle',
-        description: "Kaydedilmemiş workflow tanımını çalıştırır; kaydetmeden önce her akışı preview ile doğrulayın. definition = PreviewWorkflowCommand gövdesi. Test girdisi 'previewPayload' anahtarıyla verilir ('parameters'/'input' ÇALIŞMAZ), değişkenler 'previewVariables'. previewPayload STRING olmalıdır (JSON.stringify(...) ya da \"({ id: 1 })\") — nesne gönderilirse platform 'Unexpected end of input' ile 500 döner. Preview kuru çalıştırma değildir: table create/update step'leri kalıcı satır yazar.",
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        description: "Kaydedilmemiş workflow tanımını çalıştırır; kaydetmeden önce her akışı preview ile doğrulayın. definition = PreviewWorkflowCommand gövdesi. Test girdisi 'previewPayload' anahtarıyla verilir ('parameters'/'input' ÇALIŞMAZ), değişkenler 'previewVariables'. previewPayload STRING olmalıdır (JSON.stringify(...) ya da \"({ id: 1 })\") — nesne gönderilirse platform 'Unexpected end of input' ile 500 döner. Akışın parameterDtoId'si YOKSA previewPayload verilmez (platform 400 döner; gateway alanı düşürüp gatewayNormalized ile bildirir). Preview tek transaction'da koşar ve sonunda ROLLBACK edilir: table create/update step'leri kalıcı satır YAZMAZ (ölçüldü, İK koşusu W-1). Tek istisna code step içindeki dış HTTP çağrılarıdır — onlar geri alınamaz. Davranış kuralları: platform_guide('workflow'). " + constraintSummary('PreviewWorkflowCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam, language: languageParam },
         annotations: writes
-    }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, definition, policyOverride, language }) => {
         const normalized = normalizeWorkflowDefinition(definition);
-        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'preview', workflowKind: definition.type }, policyOverride));
-        const payload = await platform.tenant('POST', project, `/workflows/${applicationId}/preview`, { environment, body: definition });
+        // 33/S-6: parameterDtoId olmayan akışa previewPayload gönderilince platform 400 verir
+        // ("'previewPayload' requires a parameter DTO"). Girdisiz akışta alanın anlamı yok — düşürülür.
+        if (!definition.parameterDtoId && definition.previewPayload !== undefined) {
+            delete definition.previewPayload;
+            normalized.push("previewPayload düşürüldü — akışın parameterDtoId'si yok, platform 400 \"'previewPayload' requires a parameter DTO\" verir; girdi gerekiyorsa önce parameterDtoId + parameterBehavior tanımlayın");
+        }
+        const findings = enforcePolicy([
+            ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'preview', workflowKind: definition.type }, policyOverride),
+            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride)
+        ]);
+        const payload = await platform.tenant('POST', project, `/workflows/${applicationId}/preview`, { environment, body: definition, headers: languageHeader(language, normalized) });
         return attachFindings(withNormalization(payload, normalized), findings);
     }));
     server.registerTool('workflow_step_schema', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",
@@ -29,8 +29,13 @@
     "test": "vitest run",
     "docs:lint": "tsx scripts/docs-lint.ts",
     "generate-schemas": "tsx scripts/generate-schemas.ts",
+    "refresh-schemas": "scripts/refresh-schemas.sh",
+    "schema:check": "tsx scripts/schemaFingerprint.ts",
     "generate-reserved-tables": "tsx scripts/generate-reserved-tables.ts",
-    "harvest-examples": "tsx scripts/harvest-examples.ts"
+    "harvest-examples": "tsx scripts/harvest-examples.ts",
+    "kabul:import-adres": "tsx scripts/import-kabul-adres.ts",
+    "kabul:import-senaryolar": "tsx scripts/import-kabul-senaryolar.ts",
+    "benchmark:report": "tsx scripts/benchmark-report.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",