@appaflytech/zeyrek-ai-mcp 0.0.4 → 0.0.6

package/dist/tools/workflows.js

@@ -1,11 +1,16 @@
-import { guid, projectParam, environmentParam, definitionParam, pagingParams, readOnly, writes, updates, destructive } from './common.js';
+import { guid, projectParam, environmentParam, definitionParam, pagingParams, readOnly, writes, updates, destructive, microOps, languageParam } from './common.js';
 import { normalizeWorkflowDefinition, withNormalization } from '../knowledge/normalize.js';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
 import { workflowOutline, resolvePart, resolvePatchOperations } from '../knowledge/outlines.js';
+import { patchResult, baseVersionOf } from '../platform/patch.js';
+import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
 import { policyRules } from '../knowledge/rules.js';
+import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import fastJsonPatch from 'fast-json-patch';
 import { z } from 'zod';
+import { constraintSummary } from '../knowledge/backendConstraints.js';
+import { unmappedMembers, introducedUnmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
 const policyOverrideParam = z.boolean().optional()
     .describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
 const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
@@ -106,44 +111,56 @@ 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. 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.",
+        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. " + constraintSummary('CreateWorkflowCommand'),
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: definition.type }, policyOverride));
+        const drift = unmappedMembers('CreateWorkflowCommand', definition);
         const payload = await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition });
-        return attachFindings(withNormalization(payload, normalized), findings);
+        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
     }));
     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. 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.',
+        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. ' + constraintSummary('UpdateWorkflowCommand'),
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, definition, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride));
+        const drift = unmappedMembers('UpdateWorkflowCommand', definition);
         const payload = await platform.tenant('PUT', project, `/workflows/${applicationId}/${id}`, { environment, body: definition });
-        return attachFindings(withNormalization(payload, normalized), findings);
+        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
     }));
     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. 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 },
+        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 ve FARKI platformun PATCH /workflows/{app}/{id} ucuna `{ baseVersion, ops }` olarak yazar — tam gövde PUT\'u ATILMAZ. `baseVersion` okunan kaydın `version` alanıdır; kayıt bu arada değiştiyse platform 409 döner ve hiçbir op uygulanmaz. 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.optional(), ops: patchOperationsParam.optional().describe("'operations' ile aynı alan (eşanlamlı) — sayfa micro-op tool'larıyla aynı adı kullanabilmeniz için"), policyOverride: policyOverrideParam },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, id, operations, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, id, operations: givenOperations, ops, policyOverride }) => {
+        const operations = microOps('workflow_patch', ops, givenOperations);
         const current = await platform.tenant('GET', project, `/workflows/${applicationId}/${id}`, { environment });
         const definition = structuredClone((current?.data ?? current));
         const resolved = resolvePatchOperations(definition, operations);
         const patched = fastJsonPatch.applyPatch(definition, resolved.operations, true, false).newDocument;
         const normalized = normalizeWorkflowDefinition(patched);
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', patched, { operation: 'update', workflowKind: patched.type }, policyOverride));
-        await platform.tenant('PUT', project, `/workflows/${applicationId}/${id}`, { environment, body: patched });
-        return attachFindings(withNormalization({
+        const drift = introducedUnmappedMembers('UpdateWorkflowCommand', (current?.data ?? current), patched);
+        // Gövde değil FARK gönderilir: gateway normalizasyonları da op'a çevrilsin diye net diff
+        // okunan kayıt ile son hâl arasından hesaplanır (tam PUT yok, yalnız değişen alanlar yazılır).
+        const netOps = fastJsonPatch.compare(definition, patched);
+        const saved = await platform.tenant('PATCH', project, `/workflows/${applicationId}/${id}`, {
+            environment,
+            body: { baseVersion: baseVersionOf(definition, 'workflow_get'), ops: netOps }
+        });
+        const written = patchResult(saved, patched);
+        return attachFindings(withUnmappedMembers(withNormalization({
             applied: operations.length,
+            newVersion: written.newVersion,
             patchTargets: resolved.targets,
-            outline: workflowOutline(patched)
-        }, [...normalized, ...resolved.notes.map(note => `patch yolu seçiciden indekse çözüldü: ${note}`)]), findings);
+            outline: workflowOutline(written.data)
+        }, [...normalized, ...resolved.notes.map(note => `patch yolu seçiciden indekse çözüldü: ${note}`)]), drift), findings);
     }));
     server.registerTool('workflow_delete', {
         title: 'Workflow sil',
@@ -159,13 +176,13 @@ export function registerWorkflowTools(server, platform) {
     }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/workflows/clone/${id}`, { environment })));
     server.registerTool('workflow_preview', {
         title: 'Workflow önizle',
-        description: "Kaydedilmemiş workflow tanımını çalıştırır; kaydetmeden önce her akışı preview ile doğrulayın. definition = PreviewWorkflowCommand gövdesi. Test girdisi 'previewPayload' anahtarıyla verilir ('parameters'/'input' ÇALIŞMAZ), değişkenler 'previewVariables'. previewPayload STRING olmalıdır (JSON.stringify(...) ya da \"({ id: 1 })\") — nesne gönderilirse platform 'Unexpected end of input' ile 500 döner. Preview kuru çalıştırma değildir: table create/update step'leri kalıcı satır yazar.",
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        description: "Kaydedilmemiş workflow tanımını çalıştırır; kaydetmeden önce her akışı preview ile doğrulayın. definition = PreviewWorkflowCommand gövdesi. Test girdisi 'previewPayload' anahtarıyla verilir ('parameters'/'input' ÇALIŞMAZ), değişkenler 'previewVariables'. previewPayload STRING olmalıdır (JSON.stringify(...) ya da \"({ id: 1 })\") — nesne gönderilirse platform 'Unexpected end of input' ile 500 döner. Preview tek transaction'da koşar ve sonunda ROLLBACK edilir: table create/update step'leri kalıcı satır YAZMAZ (ölçüldü, İK koşusu W-1). Tek istisna code step içindeki dış HTTP çağrılarıdır — onlar geri alınamaz. Davranış kuralları: platform_guide('workflow'). " + constraintSummary('PreviewWorkflowCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam, language: languageParam },
         annotations: writes
-    }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, definition, policyOverride, language }) => {
         const normalized = normalizeWorkflowDefinition(definition);
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'preview', workflowKind: definition.type }, policyOverride));
-        const payload = await platform.tenant('POST', project, `/workflows/${applicationId}/preview`, { environment, body: definition });
+        const payload = await platform.tenant('POST', project, `/workflows/${applicationId}/preview`, { environment, body: definition, headers: languageHeader(language, normalized) });
         return attachFindings(withNormalization(payload, normalized), findings);
     }));
     server.registerTool('workflow_step_schema', {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "type": "module",
-  "description": "MCP gateway exposing the NgApps platform APIs as tools",
+  "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20"
@@ -29,8 +29,11 @@
     "test": "vitest run",
     "docs:lint": "tsx scripts/docs-lint.ts",
     "generate-schemas": "tsx scripts/generate-schemas.ts",
+    "refresh-schemas": "scripts/refresh-schemas.sh",
+    "schema:check": "tsx scripts/schemaFingerprint.ts",
     "generate-reserved-tables": "tsx scripts/generate-reserved-tables.ts",
-    "harvest-examples": "tsx scripts/harvest-examples.ts"
+    "harvest-examples": "tsx scripts/harvest-examples.ts",
+    "benchmark:report": "tsx scripts/benchmark-report.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",