@appaflytech/zeyrek-ai-mcp 0.0.12 → 0.0.13

package/dist/tools/access.js

@@ -5,7 +5,7 @@ export function registerAccessTools(server, platform) {
     const config = platform.config;
     server.registerTool('role_list', {
         title: 'Rolleri listele',
-        description: "Projenin rollerini listeler. Uç YALNIZ id + name döner (backend RoleDto bu ikisini taşır) — SLUG BURADA YOKTUR ve iki anahtar farklıdır: page_create/page_update ve microservice_create'in roleIds alanı ID ister, buna karşılık Authorized(user.roles) ile middleware'in kurduğu user.roles SLUG karşılaştırır (platformun get-user sorgusu roles+user_roles join'inden slug dizisi üretir). Slug'ı built-in 'roles' entity'sinden okuyun (sabit id 01917ede-88a2-72ea-8397-2619e5d5dca0; row_list/microservice). ROL OLUŞTURAN BİR TOOL YOKTUR ve olmamalıdır: roller built-in datasource'taki sıradan bir entity'dir (kolonlar id · name UNIQUE · slug). Uygulamanın rol yönetmesi gerekiyorsa yol entity_get('roles') + kendi microservice ucun (uç + sayfa) ve rolü kullanıcıya bağlayan user_roles satırı — MCP'den doğrudan yazma değil; reçete platform_guide('entity') §'Hazır entity'ler'. Projeyle birlikte gelen roller çoğu senaryoya yeter; önce bu listeye bakın.",
+        description: "Projenin rollerini listeler. Uç YALNIZ id + name döner (backend RoleDto bu ikisini taşır) — SLUG BURADA YOKTUR ve iki anahtar farklıdır: page_create/page_update ve microservice_create'in roleIds alanı ID ister (microservice_patch'te aynı liste '/roles' yolundadır ve öğeleri { id, name } çiftidir — yamalanan belge okuma şeklidir), buna karşılık Authorized(user.roles) ile middleware'in kurduğu user.roles SLUG karşılaştırır (platformun get-user sorgusu roles+user_roles join'inden slug dizisi üretir). Slug'ı built-in 'roles' entity'sinden okuyun (sabit id 01917ede-88a2-72ea-8397-2619e5d5dca0; row_list/microservice). ROL OLUŞTURAN BİR TOOL YOKTUR ve olmamalıdır: roller built-in datasource'taki sıradan bir entity'dir (kolonlar id · name UNIQUE · slug). Uygulamanın rol yönetmesi gerekiyorsa yol entity_get('roles') + kendi microservice ucun (uç + sayfa) ve rolü kullanıcıya bağlayan user_roles satırı — MCP'den doğrudan yazma değil; reçete platform_guide('entity') §'Hazır entity'ler'. Projeyle birlikte gelen roller çoğu senaryoya yeter; önce bu listeye bakın.",
         inputSchema: { project: projectParam, environment: environmentParam },
         annotations: readOnly
     }, handle(config, async ({ project, environment }) => {

package/dist/tools/entities.js

@@ -113,7 +113,7 @@ export function registerEntityTools(server, platform) {
     }));
     server.registerTool('entity_create', {
         title: 'Entity oluştur',
-        description: "Datasource altında yeni entity oluşturur (definition = CreateEntityCommand: name, fields[], applicationIds, ...). İlişkiler ve alan tipi kararı için platform_guide('entity') okuyun. Gövde politika kontrolünden geçer. applicationIds create'te platformca bağlanır (CreateEntityCommandHandler entityApplications'ı Entity ctor'una geçirir); satır uçları bu bağa İHTİYAÇ DUYMAZ — bağ yalnız Studio'nun application'a göre entity listesini ve bağımlılık sorgularını etkiler. `fields[].isLocalized: true` alanı ana tablodan çıkarıp companion `<slug>_localization` entity'sine taşır (yalnız düz METİN alanı; anahtar/unique/ilişki olamaz) — platform_guide('entity') §'Çoklu dilli alan'.",
+        description: "Datasource altında yeni entity oluşturur (definition = CreateEntityCommand: name, fields[], applicationIds, ...). İlişkiler ve alan tipi kararı için platform_guide('entity') okuyun. Gövde politika kontrolünden geçer. applicationIds create'te platformca bağlanır (CreateEntityCommandHandler entityApplications'ı Entity ctor'una geçirir); satır uçları bu bağa İHTİYAÇ DUYMAZ — bağ yalnız Studio'nun application'a göre entity listesini ve bağımlılık sorgularını etkiler. `fields[].isLocalized: true` alanı ana tablodan çıkarıp companion `<slug>_localization` entity'sine taşır (yalnız düz METİN alanı; anahtar/unique/ilişki olamaz) — platform_guide('entity') §'Çoklu dilli alan'. SEÇİM LİSTESİNE (enum) TEK DEĞER: listeyi yeniden göndermeyin — ekleme `{op:'add', path:'/fields[slug=status]/valueOptions/-', value:{value:'Onayda', order:4}}`, silme `{op:'remove', path:'/fields[slug=status]/valueOptions[value=Eski]'}`, yeniden adlandırma `{op:'replace', path:'/fields[slug=status]/valueOptions[value=Eski]/value', value:'Yeni'}`; `isEnum` türetilmiştir, ayrıca yazılmaz. Silme/yeniden adlandırmadan ÖNCE o değeri taşıyan satırları taşıyın — yoksa istek reddedilir ve hiçbir şey yazılmaz ('check constraint … is violated by some row') (platform_guide('entity') §'Alan tipine karar verme').",
         inputSchema: { project: projectParam, environment: environmentParam, datasourceId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
     }, handle(config, async ({ project, environment, datasourceId, definition, policyOverride }) => {

package/dist/tools/functions.js

@@ -126,7 +126,7 @@ export function registerFunctionTools(server, platform) {
     const config = platform.config;
     server.registerTool('function_list', {
         title: 'Fonksiyonları listele',
-        description: "Fonksiyonları imzalarıyla listeler; iki kaynak tek listede (source: 'workflow' sunucu, 'studio' tarayıcı). Süzgeçler birleşir: source · applicationId (studio kayıtları) · scope · pageId (yalnız o sayfanın sayfa kapsamlıları). Gövde listede YOKTUR (bodyLines sayılır) — function_get ile okuyun. Bir ifadeye Functions.x(…) ya da çıplak x(…) yazmadan önce adı, id'yi ve parametre SIRASINI buradan alın — platform_guide('functions').",
+        description: "Fonksiyonları imzalarıyla listeler; iki kaynak tek listede (source: 'workflow' sunucu, 'studio' tarayıcı). Süzgeçler birleşir: source · applicationId (studio kayıtları) · scope · pageId (yalnız o sayfanın sayfa kapsamlıları). Gövde listede YOKTUR (bodyLines sayılır) — function_get ile okuyun. Bir ifadeye Functions.x(…) ya da çıplak x(…) yazmadan önce adı, id'yi ve parametre SIRASINI buradan alın — platform_guide('functions'). Gövdeyi DEĞİŞTİRMEK için function_update { id, body }; fonksiyonda patch aracı yoktur.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,

package/dist/tools/microservices.js

@@ -2,7 +2,7 @@ import { guid, appRef, withResolved, projectParam, environmentParam, definitionP
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { hydrateMicroserviceRefs } from '../knowledge/hydrate.js';
 import { RefResolver } from '../platform/refs.js';
-import { normalizeMicroserviceDefinition, withNormalization } from '../knowledge/normalize.js';
+import { normalizeMicroserviceDefinition, normalizeMicroservicePatchOps, withNormalization } from '../knowledge/normalize.js';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
 import { microserviceOutline, workflowOutline, resolvePart, resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
@@ -323,7 +323,7 @@ export function registerMicroserviceTools(server, platform) {
     }));
     server.registerTool('microservice_patch', {
         title: 'Microservice\'e patch uygula',
-        description: 'Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut tanımı çeker, JSON Patch uygular, politika kontrolünden geçirir, geri yazar. Yanıt outline özetidir.',
+        description: "Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut tanımı çeker, JSON Patch uygular, politika kontrolünden geçirir, geri yazar. Yanıt outline özetidir. YAMALANAN BELGE microservice_get'in OKUMA ŞEKLİDİR, create/update gövdesi değil — ikisinin alan adları her yerde aynı DEĞİL: ROL LİSTESİ '/roles' yolundadır ve öğeleri { id: <role_list id>, name } çiftleridir ('roleIds' yalnız create/update gövdesinde vardır; verirseniz gateway '/roles'a çevirir ve gatewayNormalized ile söyler). Rolü değiştirmek için ucun tanımını yeniden göndermeyin: {op:'replace', path:'/roles', value:[{id:'<role_list id>'}]} yeter — 'name' isteğe bağlıdır, platform yalnız id okur. Tam dizi replace'i tercih edin: alan boş listede null serileşebilir ve '/roles/-' eklemesi o hâlde çözülemez (gateway katlar, notu yanıtta görürsünüz). Middleware listesi '/middlewareIds' ile iki yolda da aynı addır.",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: appRef, 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: givenOperations, ops, policyOverride }) => {
@@ -332,7 +332,11 @@ export function registerMicroserviceTools(server, platform) {
         const resolvedApplicationId = await resolver.applicationId(applicationId);
         const current = await platform.tenant('GET', project, `/microservices/${resolvedApplicationId}/${id}`, { environment });
         const definition = structuredClone((current?.data ?? current));
-        const resolved = resolvePatchOperations(definition, operations);
+        // Rol yolu seçici çözümünden ÖNCE çevrilir: '/roleIds' patch belgesinde hiç yoktur, o hâliyle
+        // applyPatch'e giden replace OPERATION_PATH_UNRESOLVABLE ile düşerdi (S-2).
+        const roleOperations = structuredClone(operations);
+        const roleNotes = normalizeMicroservicePatchOps(roleOperations, definition);
+        const resolved = resolvePatchOperations(definition, roleOperations);
         const patched = fastJsonPatch.applyPatch(definition, resolved.operations, true, false).newDocument;
         // Patch gövdesi tam PUT olarak geri yazılır: okunan kayıtta olmayan alan yazmada da SİLİNİR.
         // 09-04 koşusunda gidiş-dönüş 'description'ı düşürdü ve MS-014 patch'i bloke etti; genel
@@ -354,7 +358,7 @@ export function registerMicroserviceTools(server, platform) {
             body: { baseVersion: baseVersionOf(definition, 'microservice_get'), ops: netOps }
         });
         const written = patchResult(saved, patched);
-        return attachFindings(withUnmappedMembers(withWriteDiff(withResolved(withNormalization({ applied: operations.length, newVersion: written.newVersion, outline: microserviceOutline(written.data) }, [...normalized, ...resolved.notes.map(note => `patch yolu seçiciden indekse çözüldü: ${note}`)]), resolver.resolved), writeDiff(patched, written.data)), drift), findings);
+        return attachFindings(withUnmappedMembers(withWriteDiff(withResolved(withNormalization({ applied: operations.length, newVersion: written.newVersion, outline: microserviceOutline(written.data) }, [...roleNotes, ...normalized, ...resolved.notes.map(note => `patch yolu seçiciden indekse çözüldü: ${note}`)]), resolver.resolved), writeDiff(patched, written.data)), drift), findings);
     }));
     server.registerTool('microservice_delete', {
         title: 'Microservice sil',

package/dist/tools/platformInfo.js

@@ -71,7 +71,7 @@ const guideRouting = {
     middleware: 'auth/oturum/yetki',
     view: 'tam metin arama indeksi',
     expressions: 'ifade fonksiyon/bağlam sözlüğü (system.*, file.*, Page.*, state.*, Steps…)',
-    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",
+    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; GÖVDE GÜNCELLEME function_update (yalnız değişen alanı gönder, patch aracı yok)",
     translation: 'sayfa/içerik çevirileri (çoklu dil)',
     merge: "dal aç, dalda çalış, development'a merge et; çakışma çözümü ve apply kapıları"
 };

package/dist/tools/workflows.js

@@ -213,7 +213,7 @@ export function registerWorkflowTools(server, platform) {
     }));
     server.registerTool('workflow_step_schema', {
         title: 'Step şeması üret',
-        description: "Verilen step tanımı için girdi/çıktı şemasını üretir (parameterScheme / returnScheme); step yazarken definition'ı doğrulamanın en hızlı yolu. type:'workflow' adımında (rule.workflowId) çağrılan akışın parametre ve dönüş DTO'sunu döner — alt akışa girdi YALNIZ rule.expression ile geçer, nesne literalinin anahtarları bu parameterScheme'in alanlarıdır (WF-032; platform_guide('workflow') §Workflow adımı).",
+        description: "Verilen step tanımı için girdi/çıktı şemasını üretir (parameterScheme / returnScheme); step yazarken definition'ı doğrulamanın en hızlı yolu. type:'workflow' adımında (rule.workflowId) çağrılan akışın parametre ve dönüş DTO'sunu döner — alt akışa girdi YALNIZ rule.expression ile geçer, nesne literalinin anahtarları bu parameterScheme'in alanlarıdır (WF-032; platform_guide('workflow') §Workflow adımı). ŞEMA ALAN ADLARINI VERİR, HANGİ ALANIN ÇALIŞTIĞINI DEĞİL — üç ölçülmüş sapma (2026-09-16): (1) 'http' adımının returnScheme'i kök seviyede { httpStatusCode, data } der, koşumda ise adım { data, meta: { httpStatusCode }, error }'dır, yani <adım>.httpStatusCode UNDEFINED, doğrusu <adım>.meta.httpStatusCode; (2) 'workflow' adımında workflowId boşken parameterScheme/returnScheme boş döner ve şema girdinin rule.expression ile bağlandığını söylemez; (3) 'email' adımında şemanın gösterdiği alıcı adı çalışmaz (36/W-6). Sözleşmenin ölçülmüş hâli: ngapps://examples/workflow-http-step · workflow-call-workflow · workflow-loop-step ve platform_guide('workflow').",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, step: definitionParam },
         annotations: readOnly
     }, handle(config, ({ project, environment, applicationId, id, step }) => platform.tenant('POST', project, `/workflows/${applicationId}/${id}/steps/schema`, { environment, body: step })));

package/package.json

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