@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.7

package/dist/tools/pages.js

@@ -1,5 +1,6 @@
-import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive, microOps } from './common.js';
-import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, staleSetterWarnings, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, isFlexContainer, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, withNormalization, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
+import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive, microOps, isBranchName } from './common.js';
+import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, staleSetterWarnings, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, isFlexContainer, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, withNormalization, parseVariableEntries, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
+import { functionSignature } from '../knowledge/functionGuards.js';
 import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, outlineAppliedPatch, findNode, flowPath } from './screens.js';
 import { fetchComponentEventNames } from './components.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
@@ -9,11 +10,31 @@ import { PlatformApiError } from '../platform/errors.js';
 import { handle, toolResult, toolError } from '../platform/responses.js';
 import { StudioScreenshotter } from '../platform/screenshot.js';
 import { summarizeLayout } from '../knowledge/layoutSummary.js';
+import { normalizeLanguageCode } from '../knowledge/languageCodes.js';
+import { readProjectLanguages } from '../knowledge/languages.js';
 import { resolveIdentityToken } from '../platform/tokenVault.js';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { dirname, resolve } from 'node:path';
 import { applyPropTypesToSchema, setPropTypeErrors } from '../knowledge/propTypes.js';
 import { z } from 'zod';
+/**
+ * Runtime paketindeki `appFunctions`/`pageFunctions` (UiFunctionRuntimeDto: id, name, parameters,
+ * body, isAsync) — imza taşınır, GÖVDE TAŞINMAZ (MAX_RESPONSE_BYTES). Ajan Functions.<ad>(…)
+ * yazarken adı ve parametre sırasını buradan alır (G-06).
+ */
+function runtimeFunctions(value) {
+    return (Array.isArray(value) ? value : [])
+        .filter((entry) => Boolean(entry) && typeof entry === 'object')
+        .map(entry => ({
+        id: entry.id,
+        name: entry.name,
+        signature: functionSignature(entry),
+        isAsync: entry.isAsync === true,
+        parameters: (Array.isArray(entry.parameters) ? entry.parameters : [])
+            .filter((parameter) => Boolean(parameter) && typeof parameter === 'object')
+            .map(parameter => ({ name: parameter.name, required: parameter.required === true, defaultValue: parameter.defaultValue ?? null }))
+    }));
+}
 /**
  * Yazma yanıtındaki şema gövdesinin biçimi (B-55 · S-9). Varsayılan `outline`: gövde ajanın
  * aynı turda kendi gönderdiği içeriğin yankısıdır, kanıt ise pointer'da ve `silentlyDropped`ta
@@ -324,7 +345,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
     }));
     server.registerTool('page_runtime_get', {
         title: 'Sayfanın runtime çıktısını getir',
-        description: "Çıkan uygulamanın sayfa için aldığı GERÇEK paketi döner (GET /{project}/{application}/p/{slug} — sayfanın ham serve yolu budur; Studio preview ve runtime aynı ucu tüketir): sayfa şeması + layout views'ü + sayfa olayları + flow'lar + değişken anahtarları. Kurduğun sayfanın SON hâlini doğrulamanın yolu budur (layout-slot yerleşimi dahil — Kural 1f). DİKKAT: sayfaya bağlı middleware'ler bu çağrıda GERÇEKTEN koşar; middleware reddederse yanıt middlewareBlocked ile döner — korumalı sayfada bu beklenen davranıştır ve kendisi bir doğrulamadır.",
+        description: "Çıkan uygulamanın sayfa için aldığı GERÇEK paketi döner (GET /{project}/{application}/p/{slug} — sayfanın ham serve yolu budur; Studio preview ve runtime aynı ucu tüketir): sayfa şeması + layout views'ü + sayfa olayları + flow'lar + değişken anahtarları (variableKeys: middleware değişkenleri, pageVariableKeys/appVariableKeys: state.page/state.app anahtarları) + kullanıcı fonksiyonu imzaları (appFunctions/pageFunctions — bir ifadeye Functions.<ad>(…) yazmadan önce adı ve parametre sırasını buradan alın; gövde taşınmaz, function_get ile okunur). Kurduğun sayfanın SON hâlini doğrulamanın yolu budur (layout-slot yerleşimi dahil — Kural 1f). DİKKAT: sayfaya bağlı middleware'ler bu çağrıda GERÇEKTEN koşar; middleware reddederse yanıt middlewareBlocked ile döner — korumalı sayfada bu beklenen davranıştır ve kendisi bir doğrulamadır.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -375,6 +396,10 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
             widgets: named(body.widgets),
             flows: named(body.flows),
             variableKeys: Object.keys((body.variables ?? {})),
+            pageVariableKeys: parseVariableEntries(body.pageVariables).map(entry => entry.key),
+            appVariableKeys: parseVariableEntries(body.appVariables).map(entry => entry.key),
+            appFunctions: runtimeFunctions(body.appFunctions),
+            pageFunctions: runtimeFunctions(body.pageFunctions),
             hasTheme: Boolean(body.project?.theme),
             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."
@@ -385,7 +410,7 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
     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 Studio'nun çizdiği hata durumu karesi döner — bu da bir doğrulamadır. YÜKLENMEMİŞ SAYFA ASLA ÇEKİLMEZ: kare, runtime çizilip mount akışları bitince alınır (yanıtta pageState + readyAfterMs); bütçe dolduğunda sayfa hâlâ iskelette ya da akış koşuyorsa çağrı ne görüldüğünü söyleyen bir hatayla döner, boş/yarım kare dönmez. Sayfa akışı bir adımda düşerse (patlayan ifade, hata dönen uç) yanıt runtimeErrors taşır ve hangi komponentin hangi prop'unun YAZILMADIĞINI söyler — kare 'çalışıyor' görünürken sessizce boş kalan komponenti ancak bu yakalar. STUDIO_BASE_URL tanımlı olmalı; ilk kullanım için `npx playwright-core install chromium` gerekir.",
+        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 Studio'nun çizdiği hata durumu karesi döner — bu da bir doğrulamadır. YÜKLENMEMİŞ SAYFA ASLA ÇEKİLMEZ: kare, runtime çizilip mount akışları bitince alınır (yanıtta pageState + readyAfterMs); bütçe dolduğunda sayfa hâlâ iskelette ya da akış koşuyorsa çağrı ne görüldüğünü söyleyen bir hatayla döner, boş/yarım kare dönmez. Sayfa akışı bir adımda düşerse (patlayan ifade, hata dönen uç) yanıt runtimeErrors taşır ve hangi komponentin hangi prop'unun YAZILMADIĞINI söyler — kare 'çalışıyor' görünürken sessizce boş kalan komponenti ancak bu yakalar. Kare DİLİ ve TEMASI seçilebilir: 'language' adrese ?lang ekler (çeviriye bağlı prop'lar da çok dilli alanların satır değerleri de o dilde çözülür), 'colorScheme' ziyaretçinin tema tercihini sayfa açılmadan eker — ikisi de sayfaya dil değiştirici ya da theme-toggle koymayı GEREKTİRMEZ, yani referansa sadık bir tasarımın ikinci dili ve koyu teması bozulmadan kanıtlanır. STUDIO_BASE_URL tanımlı olmalı; ilk kullanım için `npx playwright-core install chromium` gerekir. DAL ORTAMI DA GÖRÜNTÜLENİR (2026-09-09'dan beri): 'development' /dev, 'production' /view, dal ise /branch/{dal} şeridinden açılır ve sayfanın BÜTÜN istekleri (şema da akışlar da) o dala gider — dalda kurulan sayfa artık merge'i beklemeden gözle doğrulanır (platform_guide('merge') §Dalda görsel doğrulama).",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -409,10 +434,12 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 value: z.unknown().optional().describe("'set' için yazılacak değer"),
                 ms: z.number().int().min(0).max(15000).optional().describe("'wait' için bekleme süresi")
             })).max(20).optional().describe("Kare ALINMADAN ÖNCE sayfada koşturulacak etkileşim adımları: [{action:'set', target:'flt_month', value:'2022-10'}, {action:'click', target:'btn_sign_in'}]. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez). Her adımdan sonra yerleşme beklenir ve yanıttaki actionsReport hedefin bulunup bulunmadığını ve adımdan sonra KAÇ AĞ İSTEĞİ çıktığını söyler — 'bağ kuruldu' ile 'çalışıyor' arasındaki farkı ancak bu ayırır (G-24)."),
+            language: z.string().min(1).optional().describe("Kareyi BU DİLDE çeker: adrese '?lang=<kod>' eklenir ve runtime dili oradan seçer (öncelik: ?lang → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı). Seçim hem çeviriye bağlı prop'ları hem çok dilli alanların satır değerlerini kapsar, yani ikinci dilin karesi için sayfaya dil değiştirici KOYMAK GEREKMEZ — referans tasarımı bozulmadan ikinci dil kanıtlanır. ISO 639-1 iki harfli kod ('tr', 'en'); bölgeli kod ('tr-TR') indirgenir ve indirgeme yanıtta bildirilir. Kod projenin languages listesinde yoksa çağrı REDDEDİLİR: runtime tanımadığı kodu yok sayıp kareyi varsayılan dilde çizerdi ve 'çevrildi' sanılan yanlış bir kare raporlanırdı."),
+            colorScheme: z.enum(['light', 'dark']).optional().describe("Kareyi açık ya da koyu temada çeker. Ziyaretçi tema tercihi çerezde değil localStorage'da yaşar ve tema store'u onu sayfa açılırken bir kez okur; gateway tercihi sayfa script'lerinden ÖNCE eker, bu yüzden sayfada 'theme-toggle' komponenti OLMASA DA koyu tema karesi alınabilir. Verilmezse projenin kendi modu çizilir."),
             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, captureUnready, anonymous, asUser, cookies, layoutReport, actions, outPath, expectFailure }) => {
+    }, async ({ project, environment, applicationSlug, pageSlug, viewport, fullPage, delayMs, captureUnready, anonymous, asUser, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme }) => {
         try {
             if (anonymous === true && (asUser !== undefined || cookies !== undefined)) {
                 throw new PlatformApiError("page_screenshot: anonymous:true ile asUser/cookies birlikte verilemez — biri kimliksiz kareyi, diğeri belirli bir kimlikle çekilen kareyi ister. Anonim kare için yalnız anonymous:true, üye kimliğiyle kare için yalnız asUser (ve gerekiyorsa cookies) gönderin.");
@@ -421,11 +448,31 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 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;
+            // U-04 (2026-09-09): kısıt önce gateway'de DEĞİL Studio'da olduğu için reddediliyordu —
+            // runtime rotası dal adı taşımıyor, ortamı modül içi bir store belirliyordu ve dal adıyla
+            // istenen kare development'ı gösterirdi. Studio artık `/branch/{env}/…` şeridini tanıyor ve
+            // ortamı URL'den okuyor (f-02); dal karesi bu yüzden GERÇEKTEN o dalın karesi. Geriye yalnız
+            // platformun dal diye kabul etmeyeceği adlar kalıyor — onlar için şerit kurulmaz.
+            const lane = resolvedEnvironment === 'development'
+                ? 'dev'
+                : resolvedEnvironment === 'production'
+                    ? 'view'
+                    : isBranchName(resolvedEnvironment) ? `branch/${resolvedEnvironment}` : 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.`);
+                throw new PlatformApiError(`page_screenshot '${resolvedEnvironment}' ortamını görüntüleyemez: bu ad ne sabit bir ortam ne de geçerli bir dal adı. Sabitler 'development' (/dev) ve 'production' (/view); dal adı bir harfle başlar, yalnız küçük harf/rakam/alt çizgi taşır (3-31 karakter) ve rezerve olamaz ('public', 'api', 'pg_*' gibi). Projedeki dalları environment_list ile görün.`);
+            }
+            const projectSlug = platform.resolveProject(project);
+            const languageChoice = language === undefined ? undefined : normalizeLanguageCode(language, 'language');
+            if (languageChoice) {
+                // Bağ burada kurulmazsa sessiz yanlış kare doğar: runtime tanımadığı kodu yok sayar ve
+                // sayfayı varsayılan dilde çizer (resolveRuntimeLanguage yalnız projenin taşıdığı kodu
+                // seçer), kare de 'ikinci dil' diye rapora girerdi.
+                const state = readProjectLanguages(await platform.org('GET', `/p/${projectSlug}`).catch(() => undefined));
+                if (state && state.languages.length > 0 && !state.languages.includes(languageChoice.code)) {
+                    throw new PlatformApiError(`page_screenshot: '${languageChoice.code}' projenin dilleri arasında değil (${state.languages.join(', ')}). Runtime bilmediği kodu yok sayıp kareyi varsayılan dilde çizer — dili project_update(languages) ile ekleyin ya da listedeki bir kodu verin.`);
+                }
             }
-            const url = `${config.studioBaseUrl}/${lane}/${platform.resolveProject(project)}/${applicationSlug}/${pageSlug}`;
+            const url = `${config.studioBaseUrl}/${lane}/${projectSlug}/${applicationSlug}/${pageSlug}${languageChoice ? `?lang=${languageChoice.code}` : ''}`;
             const size = viewport ?? { width: 1280, height: 800 };
             const extraCookies = Object.entries(cookies ?? {}).map(([name, value]) => ({ name, value }));
             const identity = anonymous === true ? 'anonymous' : asUser === undefined ? 'gateway' : 'asUser';
@@ -441,11 +488,15 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 delayMs: delayMs ?? 0,
                 ...(captureUnready === true ? { captureUnready: true } : {}),
                 ...(layoutReport === true ? { layoutReport: true } : {}),
+                ...(colorScheme === undefined ? {} : { colorScheme }),
                 ...(actions === undefined ? {} : { actions: actions })
             });
             const meta = {
                 url,
                 environment: resolvedEnvironment,
+                ...(languageChoice ? { language: languageChoice.code } : {}),
+                ...(languageChoice?.note ? { languageNote: languageChoice.note } : {}),
+                ...(colorScheme === undefined ? {} : { colorScheme }),
                 viewport: size,
                 fullPage: fullPage === true,
                 identity,
@@ -507,8 +558,9 @@ export function registerPageTools(server, platform, injectedScreenshotter) {
                 ...(shot.actions?.some(outcome => !outcome.found)
                     ? { actionsNote: `Bulunamayan hedef var: ${shot.actions.filter(outcome => !outcome.found).map(outcome => outcome.target ?? '?').join(' · ')}. elementId'leri page_schema_get ile doğrulayın; runtime düğümü data-element-id ile bulunuyor.` }
                     : {}),
-                ...(shot.actions?.some(outcome => outcome.applied && outcome.requests === 0 && (outcome.flowRuns ?? 0) === 0)
-                    ? { actionsNote: `Uygulandı ama HİÇ AĞ İSTEĞİ çıkmadı ve HİÇBİR AKIŞ KOŞMADI: ${shot.actions.filter(outcome => outcome.applied && outcome.requests === 0 && (outcome.flowRuns ?? 0) === 0).map(outcome => `${outcome.action} '${outcome.target ?? '?'}'`).join(' · ')}. Olay bağı şemada görünse bile akış koşmamış olabilir — bağın gerçekten kurulu olduğunu page_runtime_get ile, akışın gövdesini flow_get ile doğrulayın.` }
+                // 'wait' bir eylem değil bekleyiştir: akış sayacı ona bağlanmaz, notu tetiklemez (33/S-1).
+                ...(shot.actions?.some(outcome => outcome.action !== 'wait' && outcome.applied && outcome.requests === 0 && (outcome.flowRuns ?? 0) === 0)
+                    ? { actionsNote: `Uygulandı ama HİÇ AĞ İSTEĞİ çıkmadı ve HİÇBİR AKIŞ KOŞMADI: ${shot.actions.filter(outcome => outcome.action !== 'wait' && outcome.applied && outcome.requests === 0 && (outcome.flowRuns ?? 0) === 0).map(outcome => `${outcome.action} '${outcome.target ?? '?'}'`).join(' · ')}. Olay bağı şemada görünse bile akış koşmamış olabilir — bağın gerçekten kurulu olduğunu page_runtime_get ile, akışın gövdesini flow_get ile doğrulayın.` }
                     : {}),
                 ...(shot.layout === undefined
                     ? {}

package/dist/tools/platformInfo.js

@@ -61,6 +61,7 @@ const guideRouting = {
     'modify-existing': 'mevcut yapıyı bozmadan değiştirme disiplini',
     workflow: 'DTO-önce akışı, branch bağlama, tip×step matrisi',
     microservice: 'kaynak seçimi (table > query), selectFields disiplini',
+    microfunction: 'kendi runtime\'ında koşan Node/Python fonksiyonu: protokol, yayın döngüsü, step kullanımı',
     entity: "alan tipleri, ilişkiler, hazır entity'ler",
     page: 'sayfa/flow işleri; flex düzen prop grubu ve boyut modları (Kural 1f-2)',
     layout: 'yerleşim kabuğu: tek slot, views, mobil yığılma, widthType fill/fixed/auto',
@@ -70,7 +71,9 @@ const guideRouting = {
     middleware: 'auth/oturum/yetki',
     view: 'tam metin arama indeksi',
     expressions: 'ifade fonksiyon/bağlam sözlüğü (system.*, file.*, Page.*, state.*, Steps…)',
-    translation: 'sayfa/içerik çevirileri (çoklu dil)'
+    functions: "fonksiyonlar, iki kaynak tek biçim: source:'studio' tarayıcıda Functions.<ad>() (kapsam uygulama/sayfa, UI flow 'function' adımı), source:'workflow' sunucuda çıplak ad; parametre/varsayılan/required, tuzaklar",
+    translation: 'sayfa/içerik çevirileri (çoklu dil)',
+    merge: "dal aç, dalda çalış, development'a merge et; çakışma çözümü ve apply kapıları"
 };
 // page.md 123 KB; section'sız dönerse yanıt tool çıktı sınırını aşıyor ve rehber MCP kanalından
 // HİÇ okunamıyor (27/05 E-1, 09-04 koşusu). Eşik ÖLÇÜLEN kopma noktasından türetilir, "bugün

package/dist/tools/revisions.js

@@ -0,0 +1,94 @@
+import { guid, pagingParams, readOnly } from './common.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+const revisionModule = z.enum([
+    'entity',
+    'query',
+    'view',
+    'data_transfer_object',
+    'microservice',
+    'workflow',
+    'flow',
+    'page',
+    'layout',
+    'component',
+    'variable',
+    'application',
+    'role',
+    'folder'
+]).describe('Tanım türü; defter yalnız bu kökleri izler');
+const environmentName = z.string().min(1).optional()
+    .describe("Ortam adı, ör. 'development' ya da bir dal adı; boşsa DEFAULT_ENVIRONMENT");
+export function summarizeElements(elements) {
+    if (!Array.isArray(elements) || elements.length === 0)
+        return 'fark yok';
+    const lines = [];
+    for (const element of elements.slice(0, 20)) {
+        if (!element || typeof element !== 'object')
+            continue;
+        const { kind, label, path, before, after } = element;
+        const where = (typeof label === 'string' && label.length > 0 ? label : String(path ?? '')) || '(kök)';
+        const short = (value) => {
+            if (value === null || value === undefined)
+                return '—';
+            const text = typeof value === 'string' ? value : JSON.stringify(value);
+            return text.length > 60 ? `${text.slice(0, 57)}…` : text;
+        };
+        if (kind === 'add')
+            lines.push(`+ ${where} = ${short(after)}`);
+        else if (kind === 'delete')
+            lines.push(`- ${where} (${short(before)})`);
+        else
+            lines.push(`~ ${where}: ${short(before)} → ${short(after)}`);
+    }
+    if (elements.length > lines.length)
+        lines.push(`… ve ${elements.length - lines.length} değişiklik daha`);
+    return lines.join('\n');
+}
+export function registerRevisionTools(server, platform) {
+    const config = platform.config;
+    const defaultEnvironment = () => config.defaultEnvironment;
+    server.registerTool('revision_list', {
+        title: 'Tanım revizyonlarını listele',
+        description: "Bir ortamdaki tanım yazmalarını en yeniden eskiye listeler: hangi kayıt, kaçıncı revizyon, hangi işlem (create|update|delete), kim yaptı ve nereden geldi (source: studio|mcp|merge|deployment|template|revert|backfill). Gövde bu uçta DÖNMEZ — tek bir sürümün gövdesi için revision_get, iki sürüm arasındaki fark için revision_diff kullanın. source='mcp' satırları bu gateway üzerinden yapılan değişikliklerdir; bir kaydı değiştirmeden önce son revizyona bakmak, başka birinin üstüne yazmayı önler.",
+        inputSchema: {
+            projectId: guid,
+            environment: environmentName,
+            module: revisionModule.optional(),
+            recordId: guid.optional().describe('Tek bir tanım kaydının geçmişi'),
+            correlationId: z.string().min(1).optional().describe('Aynı komutun ya da merge activity id\'sinin yazdığı bütün revizyonlar'),
+            since: z.string().min(1).optional().describe("ISO tarih; bu andan sonraki revizyonlar"),
+            ...pagingParams
+        },
+        annotations: readOnly
+    }, handle(config, ({ projectId, environment, ...rest }) => platform.org('GET', `/revisions/${projectId}`, { query: { environment: environment ?? defaultEnvironment(), ...rest } })));
+    server.registerTool('revision_get', {
+        title: 'Tek revizyonu gövdesiyle oku',
+        description: "Bir revizyonu tam gövdesiyle (payload) döner — kaydın o andaki hali, deployment ve merge'ün taşıdığı biçimin aynısı. Entity revizyonlarında ddlDelta o yazmada eklenen/değişen/silinen alan adlarını taşır. Büyük sayfalarda gövde MB'lar tutabilir ve yanıt kırpılır; ne değiştiğini anlamak için önce revision_diff deneyin.",
+        inputSchema: { projectId: guid, id: guid.describe('revision_list çıktısındaki satır id\'si') },
+        annotations: readOnly
+    }, handle(config, ({ projectId, id }) => platform.org('GET', `/revisions/${projectId}/${id}`)));
+    server.registerTool('revision_diff', {
+        title: 'İki revizyon arasındaki farkı al',
+        description: "Bir tanım kaydının iki sürümü arasındaki farkı alan bazlı döner: her satırda path, label, kind (add|update|delete) ve before/after değerleri. from/to boş bırakılırsa son iki revizyon karşılaştırılır. Yanıta ayrıca summaryText eklenir — farkın tek bakışta okunur özeti. Merge ekranıyla aynı diff motorunu kullanır.",
+        inputSchema: {
+            projectId: guid,
+            environment: environmentName,
+            module: revisionModule,
+            recordId: guid,
+            from: z.number().int().min(0).optional().describe('Başlangıç revizyon numarası'),
+            to: z.number().int().min(0).optional().describe('Bitiş revizyon numarası')
+        },
+        annotations: readOnly
+    }, handle(config, async ({ projectId, environment, ...rest }) => {
+        const payload = await platform.org('GET', `/revisions/${projectId}/diff`, {
+            query: { environment: environment ?? defaultEnvironment(), ...rest }
+        });
+        if (!payload || typeof payload !== 'object')
+            return payload;
+        const data = payload.data;
+        if (!data || typeof data !== 'object')
+            return payload;
+        return { ...payload, summaryText: summarizeElements(data.elements) };
+    }));
+}