@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.8

package/dist/tools/queries.js

@@ -6,10 +6,57 @@ import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.j
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
-import { policyRules } from '../knowledge/rules.js';
+import { policyRules, rawQueryParameterNames } from '../knowledge/rules.js';
+import { PlatformApiError } from '../platform/errors.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)');
+function inferredParameterType(value) {
+    if (typeof value === 'number')
+        return Number.isInteger(value) ? 'number' : 'float';
+    if (typeof value === 'boolean')
+        return 'bool';
+    if (Array.isArray(value))
+        return 'array';
+    if (value !== null && typeof value === 'object')
+        return 'object';
+    return 'text';
+}
+/**
+ * G-13 — `PreviewQueryCommand` değeri yalnız `parameters[].value`'dan okur; üst düzey `parameters`
+ * argümanı şemada yokken SDK tarafından hata vermeden atılıyordu ve sorgu NULL'la koşuyordu.
+ * Argüman artık komutun kendi alanına bağlanır.
+ */
+function bindPreviewParameters(definition, parameters, notes) {
+    const names = Object.keys(parameters ?? {});
+    if (parameters === undefined || names.length === 0)
+        return definition;
+    const rows = (Array.isArray(definition.parameters) ? definition.parameters : []);
+    const conflicts = names.filter(name => {
+        const row = rows.find(entry => entry?.name === name);
+        return row !== undefined && row.value !== undefined && JSON.stringify(row.value) !== JSON.stringify(parameters[name]);
+    });
+    if (conflicts.length > 0) {
+        throw new PlatformApiError(`parameters ile definition.parameters aynı adı farklı değerle taşıyor: ${conflicts.map(name => `'${name}'`).join(', ')}. Değeri tek yerde verin.`, 400);
+    }
+    const bound = rows.map(row => typeof row?.name === 'string' && row.name in parameters ? { ...row, value: parameters[row.name] } : row);
+    const added = names.filter(name => !rows.some(row => row?.name === name));
+    notes.push(`parameters definition.parameters[].value'ya bağlandı: ${names.join(', ')}${added.length > 0 ? ` (tipi değerden çıkarılıp eklenen satır: ${added.join(', ')})` : ''}`);
+    return {
+        ...definition,
+        parameters: [...bound, ...added.map(name => ({ name, type: inferredParameterType(parameters[name]), value: parameters[name] }))]
+    };
+}
+/** `language` sayılmaz: platform `{{language}}` kullanan sorguya değeri kendisi ekler (`PreviewQueryCommand.cs`). */
+function unboundPreviewParameters(definition) {
+    const rows = (Array.isArray(definition.parameters) ? definition.parameters : []);
+    return rawQueryParameterNames(definition.rawQuery)
+        .filter(name => name.toLowerCase() !== 'language')
+        .filter(name => {
+        const value = rows.find(row => row?.name === name)?.value;
+        return value === undefined || value === null || (typeof value === 'string' && value.trim() === '');
+    });
+}
 export function registerQueryTools(server, platform) {
     const config = platform.config;
     server.registerTool('query_list', {
@@ -26,7 +73,7 @@ export function registerQueryTools(server, platform) {
     }, handle(config, ({ project, environment, id }) => platform.tenant('GET', project, `/queries/${id}`, { environment })));
     server.registerTool('query_create', {
         title: 'Query oluştur',
-        description: "Yeni query tanımlar (ham SQL). definition = CreateQueryCommand gövdesi. AGREGASYON VE RAPORLAMANIN YOLU BUDUR (SUM/COUNT/AVG/GROUP BY, dönemsel özet, KPI) — view_* bir TAM METİN ARAMA indeksidir, özet üretmez (09-02 M-3). VAR OLAN SATIRLARDAN TÜRETİLEN SATIR YAZMANIN DA YOLU BUDUR: 'INSERT … SELECT' kaydedip query kaynaklı bir uçtan çalıştırmak, geçmiş/hareket/junction tablosunu TEK çağrıda doldurur ve hiçbir id elle taşınmaz (ölçüldü 2026-09-07; reçete platform_guide('entity') §'Toplu ve türetilmiş satır'). Kayıt sırasında gövde bir kez ÇALIŞTIRILIR ama geri alınır — yazan sorguyu kaydetmek satır bırakmaz ve 'returnScheme' boş döner. Kayıtlı query'nin parametreleri parameterScheme ile tanımlanır ve runtime'da bağlanır; tüketimi source:'query' microservice'idir. PARAMETRENİN DEĞERİ HER ZAMAN ÇAĞRIDAN GELİR (body → query-string → header): parametreye ifade kaynağı verilemez (parameters[].source komut şemasında yoktur, platform sessizce atar) ve middleware'in kurduğu user bu yola girmez. Kimlik/tenant kapsamı sunucu tarafında zorlanacaksa sorguyu bir workflow query adımından çağırın — reçete platform_guide('microservice') §'Kimlik kapsaması × uç kaynağı'. BOŞ STRING parametre NULL'a çevrilir: '= @p' koşulu hiçbir satırla eşleşmez ve sorgu sessizce 0 satır döner — 'filtre yok' için (@p IS NULL OR ...) yazın ya da sentinel kullanın. Yorum içindeki belirteç parametre sayılmaz. SQL çalıştırılamazsa kayıt YİNE de oluşur: returnScheme boş kalır ve yanıttaki message nedeni söyler — SQL'i düzeltip query_update ile kaydedin. SORGUNUN KENDİ AÇIKLAMASI VAR: `description` alanını doldurun — sorgu listesinde ad ve slug dışında ipucu yoktur ve ucun açıklaması (MS-014) bunun yerine geçmez, çünkü bir sorgu birden çok uçtan tüketilir; boş bırakılırsa gateway `QRY-006` uyarısı düşürür (yazmayı durdurmaz). " + constraintSummary('CreateQueryCommand'),
+        description: "Yeni query tanımlar (ham SQL). definition = CreateQueryCommand gövdesi. AGREGASYON VE RAPORLAMANIN YOLU BUDUR (SUM/COUNT/AVG/GROUP BY, dönemsel özet, KPI) — view_* bir TAM METİN ARAMA indeksidir, özet üretmez (09-02 M-3). VAR OLAN SATIRLARDAN TÜRETİLEN SATIR YAZMANIN DA YOLU BUDUR: 'INSERT … SELECT' kaydedip query kaynaklı bir uçtan çalıştırmak, geçmiş/hareket/junction tablosunu TEK çağrıda doldurur ve hiçbir id elle taşınmaz (ölçüldü 2026-09-07; reçete platform_guide('entity') §'Toplu ve türetilmiş satır'). Kayıt sırasında gövde bir kez ÇALIŞTIRILIR ama geri alınır — yazan sorguyu kaydetmek satır bırakmaz ve 'returnScheme' boş döner. Kayıtlı query'nin parametreleri parameterScheme ile tanımlanır ve runtime'da bağlanır; tüketimi source:'query' microservice'idir. PARAMETRENİN DEĞERİ HER ZAMAN ÇAĞRIDAN GELİR (body → query-string → header): parametreye ifade kaynağı verilemez (parameters[].source komut şemasında yoktur, platform sessizce atar) ve middleware'in kurduğu user bu yola girmez. Kimlik/tenant kapsamı sunucu tarafında zorlanacaksa sorguyu bir workflow query adımından çağırın — reçete platform_guide('microservice') §'Kimlik kapsaması × uç kaynağı'. BOŞ STRING parametre NULL'a çevrilir: '= @p' koşulu hiçbir satırla eşleşmez ve sorgu sessizce 0 satır döner — 'filtre yok' için (@p IS NULL OR ...) yazın ya da sentinel kullanın; (@p = '' OR ...) kalıbı hiçbir zaman eşleşmez ve gateway `QRY-007` uyarısı düşürür. Yorum içindeki belirteç parametre sayılmaz. SQL çalıştırılamazsa kayıt YİNE de oluşur: returnScheme boş kalır ve yanıttaki message nedeni söyler — SQL'i düzeltip query_update ile kaydedin. SORGUNUN KENDİ AÇIKLAMASI VAR: `description` alanını doldurun — sorgu listesinde ad ve slug dışında ipucu yoktur ve ucun açıklaması (MS-014) bunun yerine geçmez, çünkü bir sorgu birden çok uçtan tüketilir; boş bırakılırsa gateway `QRY-006` uyarısı düşürür (yazmayı durdurmaz). " + constraintSummary('CreateQueryCommand'),
         inputSchema: { project: projectParam, environment: environmentParam, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
     }, handle(config, async ({ project, environment, definition, policyOverride }) => {
@@ -59,12 +106,31 @@ export function registerQueryTools(server, platform) {
     server.registerTool('query_preview', {
         title: 'Query önizle',
         description: "Kaydedilmemiş query tanımını datasource üzerinde çalıştırır. definition = PreviewQueryCommand gövdesi. Preview ROLLBACK edilir: yazan bir sorgu (INSERT/UPDATE/DELETE) çalışır, affectedRowCount gerçek sayıyı döner ama SATIR KALMAZ (ölçüldü, 09-04 Y-19) — yazmayı doğrulamak için sorguyu kaydedip microservice/workflow üzerinden çalıştırın. YANITTA ROLLBACK İŞARETİ YOKTUR: 2026-09-07'de ölçüldü, yazan sorgunun yanıtı yalnız { affectedRowCount, elapsedMilliseconds } taşıyor — sayı başarı gibi görünür, tek kanıt sonradan row_list çekmektir. BOŞ STRING parametre NULL'a çevrilir (üç koşuda ölçüldü): '= @p' hiçbir satırla eşleşmez, 0 satır döner ve hata yoktur. Davranış kuralları: platform_guide('microservice'). " + constraintSummary('PreviewQueryCommand'),
-        inputSchema: { project: projectParam, environment: environmentParam, datasourceId: guid, definition: definitionParam, language: languageParam, policyOverride: policyOverrideParam },
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            datasourceId: guid,
+            definition: definitionParam,
+            parameters: z.record(z.unknown()).optional()
+                .describe("Önizleme değerleri (ad → değer). definition.parameters[] içindeki aynı adlı satırın value'suna yazılır; satır yoksa tipi değerden çıkarılarak eklenir (tam sayı → number, ondalık → float, true/false → bool, diğerleri → text). Aynı ad definition.parameters'ta FARKLI bir value ile de varsa çağrı gönderilmez."),
+            language: languageParam,
+            policyOverride: policyOverrideParam
+        },
         annotations: writes
-    }, handle(config, async ({ project, environment, datasourceId, definition, language, policyOverride }) => {
-        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'query', definition, { operation: 'preview' }, policyOverride));
+    }, handle(config, async ({ project, environment, datasourceId, definition: given, parameters, language, policyOverride }) => {
         const notes = [];
+        const definition = bindPreviewParameters(given, parameters, notes);
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'query', definition, { operation: 'preview' }, policyOverride));
         const headers = languageHeader(language, notes);
-        return attachFindings(withNormalization(await platform.tenant('POST', project, `/queries/${datasourceId}/preview`, { environment, body: definition, headers }), notes), findings);
+        const payload = await platform.tenant('POST', project, `/queries/${datasourceId}/preview`, { environment, body: definition, headers });
+        const unbound = unboundPreviewParameters(definition);
+        const withUnbound = unbound.length > 0 && payload && typeof payload === 'object' && !Array.isArray(payload)
+            ? {
+                ...payload,
+                unboundParameters: unbound,
+                unboundParametersNote: "rawQuery bu parametrelere başvuruyor ama değerleri yok ya da boş string (platform boş string'i NULL'a çevirir) — sorgu onları NULL ile koştu. Değeri üst düzey 'parameters' ya da definition.parameters[].value ile verin."
+            }
+            : payload;
+        return attachFindings(withNormalization(withUnbound, notes), findings);
     }));
 }

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