@appaflytech/zeyrek-ai-mcp 0.0.2 → 0.0.4

package/dist/tools/microservices.js

@@ -119,7 +119,7 @@ export function registerMicroserviceTools(server, platform) {
     }));
     server.registerTool('microservice_create', {
         title: 'Microservice oluştur',
-        description: "Yeni microservice tanımlar (definition = CreateMicroserviceCommand). İlk kullanımdan önce platform_guide('microservice') okuyun: kaynak seçimi (table > query) ve selectFields disiplini. Auth/oturum gerektiren uçlarda definition.middlewareIds ile middleware bağlayın; kimlik kapsaması filtrede source:'expression' + value:'user.id' ile yapılır (platform_guide('middleware')). Gövde politika kontrolünden geçer.",
+        description: "Yeni microservice tanımlar (definition = CreateMicroserviceCommand). İlk kullanımdan önce platform_guide('microservice') okuyun: kaynak seçimi (table > query) ve selectFields disiplini. 'description' ZORUNLUDUR (MS-014, block): çağıranın bu uçtan ne elde ettiğini yazın. Auth/oturum gerektiren uçlarda definition.middlewareIds ile middleware bağlayın; kimlik kapsaması filtrede source:'expression' + value:'user.id' ile yapılır (platform_guide('middleware')). Ucun gerçek bir tuzağı varsa (auth istemiyor, sayfalama yok, atomik değil) 'caution' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın. Gövde politika kontrolünden geçer.",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
@@ -130,7 +130,7 @@ export function registerMicroserviceTools(server, platform) {
     }));
     server.registerTool('microservice_update', {
         title: 'Microservice güncelle',
-        description: 'Microservice tanımını günceller (tam gövde). Hedefli değişiklik için microservice_patch tercih edin. Gövde politika kontrolünden geçer.',
+        description: 'Microservice tanımını günceller (tam gövde). Hedefli değişiklik için microservice_patch tercih edin. \'description\' ZORUNLUDUR (MS-014, block). Ucun gerçek bir tuzağı varsa (auth istemiyor, sayfalama yok, atomik değil) \'caution\' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın. Gövde politika kontrolünden geçer.',
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, definition, policyOverride }) => {

package/dist/tools/pages.js

@@ -1,13 +1,15 @@
 import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive } from './common.js';
 import { orphanedFlowWarnings, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, blockSizeNote, heightTypeNote, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, invalidScreenEventNames, invalidWidgetTypeNodes, withNormalization, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
-import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap } from './screens.js';
+import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode } from './screens.js';
 import { applyCatalogLayoutRules, fetchComponentEventNames } from './components.js';
 import { formBindingWarnings } from '../knowledge/coverage.js';
 import { PlatformApiError } from '../platform/errors.js';
-import { handle } from '../platform/responses.js';
+import { handle, toolResult, toolError } from '../platform/responses.js';
+import { StudioScreenshotter } from '../platform/screenshot.js';
+import { writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
 import { z } from 'zod';
 const opsParam = z.array(z.record(z.unknown())).describe("Micro-op listesi. Op sözlüğü: replace_prop {target, prop, value} | set_binding {target, prop, expression: '{{ Page.variables.x }}'} | add_component {parent (üst elementId ya da 'root'), index?, component} | remove_component {target} | move_component {target, parent, index?, position: {x, y}} | set_event {target, event, eventValue} | remove_event {target, event} (gateway emülasyonu: platformun micro-op'u olay SİLEMEZ, eventValue: null yalnız değersiz ölü kayıt bırakır — bu op şemayı okuyup olayı diziden çıkarır ve sayfayı tam gövdeyle geri yazar) | set_validations {target, validations: [{type, message, value, isActive}]} (komponentin validation listesini TAMAMEN değiştirir; boş dizi hepsini siler). target = elementId.");
-const modeParam = z.enum(['summary', 'subtree', 'full']).optional().describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm şema.");
 /**
  * PAGE-008 — `set_event` uydurma bir olay adıyla 200 döner ve bağ SESSİZCE ölü kalır: motor olayı
  * komponentin yaydığı adla eşleştirir, eşleşme yoksa akış hiç çalışmaz. Kontrol yalnız hedefin
@@ -46,28 +48,6 @@ function invalidComponentNames(nodes) {
     }
     return found;
 }
-function summarize(node) {
-    const summary = {
-        id: node.id,
-        elementId: node.elementId,
-        name: node.name,
-        type: node.type
-    };
-    if (Array.isArray(node.children) && node.children.length > 0) {
-        summary.children = node.children.map(summarize);
-    }
-    return summary;
-}
-function findNode(nodes, target) {
-    for (const node of nodes ?? []) {
-        if (node.elementId === target || String(node.id) === target)
-            return node;
-        const found = findNode(node.children, target);
-        if (found)
-            return found;
-    }
-    return undefined;
-}
 function removeNodeFromTree(nodes, target) {
     for (let index = 0; index < nodes.length; index++) {
         if (nodes[index].elementId === target)
@@ -235,10 +215,11 @@ export function registerPageTools(server, platform) {
             applicationSlug: z.string().min(1).describe("Uygulamanın slug'ı (application_list / project_overview)"),
             pageSlug: z.string().min(1).describe("Sayfanın slug'ı (page_list)"),
             view: z.enum(['summary', 'full']).optional().describe('summary (varsayılan): şema/layout ağaçları id/name/type özetine indirgenir. full: ham gövde — büyük olabilir'),
+            resolveStyles: z.boolean().optional().describe("summary görünümünde her düğüme EFEKTİF stilini ekler: tema componentStyles → preset → düğümün kendi stili kaskadı çözülür (aibox'ta tipli stil grupları da derlenir ve TABAN katman olur). styleLayers hangi katmanın konuştuğunu söyler — 'bu kutu neden böyle görünüyor' sorusunun cevabı budur."),
             anonymous: z.boolean().optional().describe("true: istek HİÇBİR Authorization header'ı olmadan gider — 'korumalı sayfa tokensız ne döner, şema sızıyor mu?' sorusunun cevabı budur. Korumalı sayfada middlewareBlocked bekleyin.")
         },
         annotations: readOnly
-    }, handle(config, async ({ project, environment, applicationSlug, pageSlug, view, anonymous }) => {
+    }, handle(config, async ({ project, environment, applicationSlug, pageSlug, view, resolveStyles, anonymous }) => {
         let response;
         try {
             response = await platform.tenant('GET', project, `/${applicationSlug}/p/${pageSlug}`, { environment, anonymous });
@@ -258,20 +239,107 @@ export function registerPageTools(server, platform) {
             return response;
         const body = (response?.data ?? {});
         const layout = body.layout;
+        const theme = body.project?.theme;
+        // undefined: stil raporu hiç yazılmaz. null: tema yok ama kaskad yine çözülür.
+        const styleSource = resolveStyles ? (theme ?? null) : undefined;
         const asNodes = (value) => (Array.isArray(value) ? value : []);
         const named = (value) => (Array.isArray(value) ? value : []).map(entry => ({ id: entry.id, name: entry.name, slug: entry.slug }));
         return {
             page: { id: body.id, name: body.name, slug: body.slug, browserTitle: body.browserTitle, isHomepage: body.isHomepage },
             events: body.events ?? [],
-            layout: layout ? { id: layout.id, name: layout.name, views: asNodes(layout.views).map(summarize) } : null,
-            schema: asNodes(body.schema).map(summarize),
+            layout: layout ? { id: layout.id, name: layout.name, views: asNodes(layout.views).map(node => summarize(node, styleSource)) } : null,
+            schema: asNodes(body.schema).map(node => summarize(node, styleSource)),
             widgets: named(body.widgets),
             flows: named(body.flows),
             variableKeys: Object.keys((body.variables ?? {})),
             hasTheme: Boolean(body.project?.theme),
-            note: "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f); tam gövde gerekirse view:'full'."
+            note: resolveStyles
+                ? "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f). resolvedStyle = componentStyles → preset → düğüm stili kaskadı (aibox'ta tipli grupların derlemesi TABAN katmandır); styleLayers hangi katmanların konuştuğunu söyler."
+                : "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f); tam gövde gerekirse view:'full'. Bir düğümün ekranda GERÇEKTEN aldığı stili görmek için resolveStyles:true."
         };
     }));
+    const screenshotter = new StudioScreenshotter(config);
+    const maxInlinePngBytes = 5 * 1024 * 1024;
+    server.registerTool('page_screenshot', {
+        title: 'Sayfanın ekran görüntüsünü al',
+        description: "Studio arayüzünün runtime render rotasını (/dev ya da /view) headless Chromium'da açar ve sayfanın PNG ekran görüntüsünü inline görüntü olarak döner — kurduğun sayfayı GÖZLE doğrulamanın yolu budur (page_runtime_get paketi verir, bu tool ekranda ne ÇİZİLDİĞİNİ gösterir). Sayfaya bağlı middleware'ler gerçekten koşar; reddedilirse yanıtta middlewareBlocked işaretlenir ve hata/boş durum karesi yine döner — bu da bir doğrulamadır. STUDIO_BASE_URL tanımlı olmalı; ilk kullanım için `npx playwright-core install chromium` gerekir.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationSlug: z.string().min(1).describe("Uygulamanın slug'ı (application_list / project_overview)"),
+            pageSlug: z.string().min(1).describe("Sayfanın slug'ı (page_list)"),
+            viewport: z.object({
+                width: z.number().int().min(320).max(3840),
+                height: z.number().int().min(240).max(2160)
+            }).optional().describe('Varsayılan 1280x800 (deviceScaleFactor 1)'),
+            fullPage: z.boolean().optional().describe('true: kaydırılan kısım dahil tüm sayfa; varsayılan yalnız viewport karesi'),
+            delayMs: z.number().int().min(0).max(10000).optional().describe('Animasyon/geç gelen veri için EK bekleme; 600 ms yerleşme beklemesi her zaman uygulanır'),
+            anonymous: z.boolean().optional().describe("true: NG_AccessToken çerezi enjekte edilmez — anonim ziyaretçinin gördüğü kare. Korumalı sayfada middlewareBlocked bekleyin."),
+            outPath: z.string().min(1).optional().describe('Verilirse PNG bu yerel yola yazılır ve inline görüntü DÖNMEZ; yalnız özet (yol, boyut) döner — büyük fullPage kareleri için')
+        },
+        annotations: readOnly
+    }, async ({ project, environment, applicationSlug, pageSlug, viewport, fullPage, delayMs, anonymous, outPath }) => {
+        try {
+            if (!config.studioBaseUrl) {
+                throw new PlatformApiError("page_screenshot için STUDIO_BASE_URL tanımlı değil. Studio arayüzünün kök adresini .env'e ekleyin (yerel geliştirmede http://localhost:3000, dağıtımda nginx adresi).");
+            }
+            const resolvedEnvironment = platform.resolveEnvironment(environment);
+            const lane = resolvedEnvironment === 'development' ? 'dev' : resolvedEnvironment === 'production' ? 'view' : undefined;
+            if (!lane) {
+                throw new PlatformApiError(`page_screenshot yalnız 'development' (/dev) ve 'production' (/view) ortamlarını görüntüleyebilir; '${resolvedEnvironment}' için Studio'da karşılık gelen bir rota yok.`);
+            }
+            const url = `${config.studioBaseUrl}/${lane}/${platform.resolveProject(project)}/${applicationSlug}/${pageSlug}`;
+            const size = viewport ?? { width: 1280, height: 800 };
+            const shot = await screenshotter.capture({
+                url,
+                apiPathMarker: `/${applicationSlug}/p/${pageSlug}`,
+                token: anonymous ? undefined : await platform.accessToken(),
+                cookieUrl: config.studioBaseUrl,
+                viewport: size,
+                fullPage: fullPage === true,
+                delayMs: delayMs ?? 0
+            });
+            const meta = {
+                url,
+                environment: resolvedEnvironment,
+                viewport: size,
+                fullPage: fullPage === true,
+                sizeBytes: shot.png.byteLength,
+                elapsedMs: shot.elapsedMs,
+                ...(shot.apiStatus === undefined ? {} : { apiStatus: shot.apiStatus }),
+                ...(shot.apiStatus !== undefined && shot.apiStatus >= 300
+                    ? { middlewareBlocked: true, note: 'Sayfanın veri isteği reddedildi — karede hata/boş durum görünüyor olabilir. Korumalı sayfada kimliksiz/yetkisiz isteğin reddedilmesi BEKLENEN davranıştır (page_runtime_get ile karşılaştırın).' }
+                    : {}),
+                ...(shot.renderWaitTimedOut
+                    ? { renderWaitTimedOut: true, note: "Sayfanın veri isteği gözlenmedi — kare hata/boş durumu gösteriyor olabilir; STUDIO_BASE_URL ve slug'ları doğrulayın." }
+                    : {})
+            };
+            if (outPath) {
+                const absolute = resolve(outPath);
+                try {
+                    await writeFile(absolute, shot.png);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    throw new PlatformApiError(`page_screenshot: dosya yazılamadı — ${absolute} (${message}). Yol gateway sürecinin çalıştığı makineye göre çözülür.`);
+                }
+                return toolResult({ path: absolute, ...meta }, config);
+            }
+            if (shot.png.byteLength > maxInlinePngBytes) {
+                throw new PlatformApiError(`Görüntü ${shot.png.byteLength} B — inline sınırı (${maxInlinePngBytes} B) aşıyor. outPath verin (dosyaya yazılır, model bağlamına girmez) ya da fullPage'i kapatıp viewport'u küçültün.`);
+            }
+            return {
+                content: [
+                    { type: 'image', data: shot.png.toString('base64'), mimeType: 'image/png' },
+                    { type: 'text', text: JSON.stringify(meta) }
+                ],
+                structuredContent: meta
+            };
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
     server.registerTool('page_schema_get', {
         title: 'Sayfa şemasını oku',
         description: "Sayfanın komponent şemasını okur; yanıttaki updatedAt değeri page_schema_patch'in expectedUpdatedAt kontrolünde kullanılır.",
@@ -297,7 +365,7 @@ export function registerPageTools(server, platform) {
                 throw new PlatformApiError(`Sayfada '${componentId}' id'li bir komponent yok; page_schema_get'i summary kipinde çağırıp hedefi doğrulayın.`);
             return { updatedAt, schema: subtree };
         }
-        return { updatedAt, schema: (page.schema ?? []).map(summarize) };
+        return { updatedAt, schema: (page.schema ?? []).map(node => summarize(node)) };
     }));
     server.registerTool('page_state', {
         title: 'Sayfa durumunu getir',

package/dist/tools/platformInfo.js

@@ -13,7 +13,7 @@ export function registerPlatformTools(server, platform) {
     }, handle(config, () => platform.org('GET', '/connect/userinfo')));
     server.registerTool('platform_guide', {
         title: 'Platform rehberi oku',
-        description: "Modülün iş kuralları rehberini döner (workflow, microservice, entity, page, component, html, middleware, view, expressions, getting-started, modify-existing). Bir modülde İLK yazma işleminden önce ilgili rehberi okuyun; sayfa/layout/flow işleri için page, komponent modeli/olay sözleşmeleri için component, hazır komponentler yetmediğinde HTML kaçış kapısı (Mustache, fireEvent, script kuralları) için html, auth/oturum/yetki için middleware, tam metin arama indeksi için view, ifade yazarken kullanılabilir fonksiyon/bağlam sözlüğü (system.*, file.*, Page.*, state.*, Steps…) için expressions rehberi. Örnek gövdeler için ngapps://examples kaynaklarına bakın.",
+        description: "Modülün iş kuralları rehberini döner (workflow, microservice, entity, page, layout, component, html, middleware, view, expressions, translation, getting-started, modify-existing). Bir modülde İLK yazma işleminden önce ilgili rehberi okuyun; sayfa/layout/flow işleri için page, yerleşim kabuğunun kendi kuralları (tek slot, views alanı, micro-op yokluğu, mobil yığılma) için layout, komponent modeli/olay sözleşmeleri için component, hazır komponentler yetmediğinde HTML kaçış kapısı (Mustache, fireEvent, script kuralları) için html, auth/oturum/yetki için middleware, tam metin arama indeksi için view, ifade yazarken kullanılabilir fonksiyon/bağlam sözlüğü (system.*, file.*, Page.*, state.*, Steps…) için expressions, sayfa/içerik çevirileri (çoklu dil) için translation rehberi. Örnek gövdeler için ngapps://examples kaynaklarına bakın.",
         inputSchema: {
             guide: z.string().describe('Rehber adı; bilinmeyen ad verilirse mevcut rehberler listelenir')
         },
@@ -27,7 +27,7 @@ export function registerPlatformTools(server, platform) {
     }));
     server.registerTool('platform_gap_report', {
         title: 'Kabiliyet boşluğu bildir',
-        description: "Yapmak İSTEDİĞİNİZ ama platform desteklemediği için yapamadığınız her noktada BUNU ÇAĞIRIN — tasarımı sessizce küçültmeyin. Bu çağrı platforma gitmez, yalnızca günlüğe 'KABİLİYET BOŞLUĞU' bloğu yazar; hata günlüğünde görünmeyen bu kayıtlar ürün yol haritasının girdisidir. Önce rehbere bakıp (platform_guide, özellikle hazır komponent yetmiyorsa 'html' kaçış kapısı) gerçekten desteklenmediğinden emin olun: desteklenen bir şeyi 'yok' diye bildirmek yanlış yol haritası üretir.",
+        description: "Yapmak İSTEDİĞİNİZ ama platform desteklemediği için yapamadığınız her noktada BUNU ÇAĞIRIN — tasarımı sessizce küçültmeyin. Bu çağrı platforma gitmez, yalnızca günlüğe 'KABİLİYET BOŞLUĞU' bloğu yazar; hata günlüğünde görünmeyen bu kayıtlar ürün yol haritasının girdisidir. Önce rehbere bakıp (platform_guide; hazır komponent yetmiyorsa tek seferlik için 'html' kaçış kapısı, kalıcı bir ihtiyaç içinse 'external-component' — kendi komponentinizi yazıp yayınlayabilirsiniz) gerçekten desteklenmediğinden emin olun: desteklenen bir şeyi 'yok' diye bildirmek yanlış yol haritası üretir.",
         inputSchema: {
             goal: z.string().min(1).describe('Ne yapmak istediniz — kullanıcıya görünen sonuç olarak yazın ("randevu listesini hasta adına göre süzmek")'),
             blocker: z.string().min(1).describe('Neden yapamadınız — hangi kabiliyetin eksik olduğu ("uçta X yok", "komponentte Y prop\'u yok")'),

package/dist/tools/projects.js

@@ -79,12 +79,14 @@ export function registerProjectTools(server, platform) {
     }));
     server.registerTool('project_update', {
         title: 'Proje güncelle',
-        description: 'Proje adını, slug\'ını ve temasını günceller. LoaderImage bu tool\'da desteklenmez.',
+        description: 'Proje adını, slug\'ını, temasını ve dil ayarlarını günceller. languages/defaultLanguage verilmezse mevcut değerlerine dokunulmaz. LoaderImage bu tool\'da desteklenmez.',
         inputSchema: {
             id: guid,
             name: z.string().min(1),
             slug: z.string().optional(),
-            theme: z.string().optional()
+            theme: z.string().optional(),
+            languages: z.array(z.string().min(1)).min(1).optional().describe('ISO 639-1 kod listesi (proje dilleri); sayfa çevirileri bu kodlarla doğrulanır'),
+            defaultLanguage: z.string().min(1).optional().describe("languages içinde olmalı — proje dilleri hiç kurulmadıysa (ilk kurulumda) tek başına verilebilir")
         },
         annotations: updates
     }, handle(config, args => {
@@ -93,6 +95,9 @@ export function registerProjectTools(server, platform) {
             form.set('Slug', args.slug);
         if (args.theme)
             form.set('Theme', args.theme);
+        args.languages?.forEach(language => form.append('Languages', language));
+        if (args.defaultLanguage)
+            form.set('DefaultLanguage', args.defaultLanguage);
         return platform.org('PUT', `/projects/${args.id}`, { form });
     }));
     server.registerTool('project_delete', {

package/dist/tools/screens.js

@@ -1,4 +1,5 @@
 import { PlatformApiError } from '../platform/errors.js';
+import { resolveNodeStyleReport } from '../knowledge/styleResolve.js';
 import { z } from 'zod';
 export const hostParam = z.enum(['page', 'layout', 'component'])
     .describe("Akışın barındırıcısı: page | layout | component (widget de component'tir)");
@@ -6,6 +7,41 @@ export const schemaParam = z.array(z.record(z.unknown()))
     .describe('Komponent ağacı (DesignComponentManagementSchema listesi); verilmezse mevcut şema korunur');
 export const eventsParam = z.array(z.record(z.unknown()))
     .describe("Sayfa/layout düzeyi olaylar: [{ name, value }] — value bir flow id'sidir");
+export const modeParam = z.enum(['summary', 'subtree', 'full']).optional().describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm şema.");
+/**
+ * Ağacı yalnız kimlik alanlarına indirger; hedef aramak için okunur boyutta tutar.
+ * `styleSource` verilirse (undefined DEĞİLSE) her düğüme efektif stil raporu da
+ * yazılır: tema componentStyles → preset → düğümün kendi stili kaskadı.
+ */
+export function summarize(node, styleSource) {
+    const summary = {
+        id: node.id,
+        elementId: node.elementId,
+        name: node.name,
+        type: node.type
+    };
+    if (styleSource !== undefined) {
+        const report = resolveNodeStyleReport(node, styleSource ?? undefined);
+        if (report.resolvedStyle !== undefined)
+            summary.resolvedStyle = report.resolvedStyle;
+        summary.styleLayers = report.styleLayers;
+    }
+    if (Array.isArray(node.children) && node.children.length > 0) {
+        summary.children = node.children.map(child => summarize(child, styleSource));
+    }
+    return summary;
+}
+/** elementId ya da id ile ağaçta düğüm bulur. */
+export function findNode(nodes, target) {
+    for (const node of nodes ?? []) {
+        if (node.elementId === target || String(node.id) === target)
+            return node;
+        const found = findNode(node.children, target);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
 function asArray(value) {
     return Array.isArray(value) ? value : [];
 }

package/dist/tools/translations.js

@@ -0,0 +1,37 @@
+import { guid, projectParam, environmentParam, readOnly, updates } from './common.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+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ı"),
+    componentId: guid.optional().describe("Çeviriyi belirli bir komponente bağlar; o komponent silinince kaydı da silinir")
+});
+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').",
+        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.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            keys: z.array(translationKeyInput).optional().describe('Eklenecek/güncellenecek anahtarlar'),
+            deletedKeys: z.array(z.string().min(1)).optional().describe('Silinecek anahtar adları')
+        },
+        annotations: updates
+    }, handle(config, ({ 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 ?? [] }
+        });
+    }));
+}

package/dist/tools/workflows.js

@@ -106,7 +106,7 @@ 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. Middleware (istek öncesi koşan guard/setter, user değişkeni, alfabetik sıra) için platform_guide('middleware') + ngapps://examples/middleware-authenticate. 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.",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
@@ -117,7 +117,7 @@ export function registerWorkflowTools(server, platform) {
     }));
     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. 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.',
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, definition, policyOverride }) => {
@@ -128,7 +128,7 @@ export function registerWorkflowTools(server, platform) {
     }));
     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. Yanıt outline özetidir.',
+        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 },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, operations, policyOverride }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "description": "MCP gateway exposing the NgApps platform APIs as tools",
   "license": "UNLICENSED",
@@ -13,6 +13,7 @@
   "files": [
     "dist",
     ".env.example",
+    ".env.production.example",
     "README.md"
   ],
   "publishConfig": {
@@ -26,6 +27,7 @@
     "prepack": "npm run build",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
+    "docs:lint": "tsx scripts/docs-lint.ts",
     "generate-schemas": "tsx scripts/generate-schemas.ts",
     "generate-reserved-tables": "tsx scripts/generate-reserved-tables.ts",
     "harvest-examples": "tsx scripts/harvest-examples.ts"
@@ -36,6 +38,7 @@
     "express": "^4.21.0",
     "fast-json-patch": "^3.1.1",
     "pino": "^9.5.0",
+    "playwright-core": "^1.49.0",
     "undici": "^7.3.0",
     "zod": "^3.24.1"
   },