@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.7

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) };
+    }));
+}