@appaflytech/zeyrek-ai-mcp 0.0.7 → 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/workflows.js

@@ -4,7 +4,7 @@ import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/poli
 import { workflowOutline, resolvePart, resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
-import { policyRules, microfunctionStepFindings } from '../knowledge/rules.js';
+import { policyRules, microfunctionStepFindings, undefinedInputFieldFindings } from '../knowledge/rules.js';
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import fastJsonPatch from 'fast-json-patch';
@@ -118,7 +118,8 @@ export function registerWorkflowTools(server, platform) {
         const normalized = normalizeWorkflowDefinition(definition);
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: definition.type }, policyOverride),
-            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride)
+            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
+            ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride)
         ]);
         const drift = unmappedMembers('CreateWorkflowCommand', definition);
         const payload = await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition });
@@ -133,7 +134,8 @@ export function registerWorkflowTools(server, platform) {
         const normalized = normalizeWorkflowDefinition(definition);
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride),
-            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride)
+            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
+            ...await undefinedInputFieldFindings(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 });
@@ -153,7 +155,8 @@ export function registerWorkflowTools(server, platform) {
         const normalized = normalizeWorkflowDefinition(patched);
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', patched, { operation: 'update', workflowKind: patched.type }, policyOverride),
-            ...await microfunctionStepFindings(platform, project, environment, patched, patched.type, policyOverride)
+            ...await microfunctionStepFindings(platform, project, environment, patched, patched.type, policyOverride),
+            ...await undefinedInputFieldFindings(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
@@ -198,7 +201,8 @@ export function registerWorkflowTools(server, platform) {
         }
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'preview', workflowKind: definition.type }, policyOverride),
-            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride)
+            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
+            ...await undefinedInputFieldFindings(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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",